如何在 .NET 中使用列表

步骤 1：将列表应用于段落

在段落的格式上使用 ListFormat.ApplyBulletDefault() 或 ApplyNumberDefault() 可以一次性应用 Word 的默认项目符号或编号列表——这是应用标准列表的最快方式。若需使用特定的预定义格式而非默认格式，请调用 Document.Lists（一个 ListCollection）.Add(listTemplate)，并提供 ListTemplate 值，例如 BulletDisk、BulletSquare、NumberArabicDot 或 NumberUppercaseRomanDot，以从 Word 的内置格式创建 List，或使用 AddSingleLevelList(listTemplate) 创建单层变体。段落获得列表格式后，ListFormat.IsListItem 会报告 true，而 ListFormat.List/ListLevelNumber 则标识其使用的列表及层级。

步骤 2：为新的一组段落分配独立的编号

段落的ListFormat.List指向相同的共享List对象时，会继续使用相同的计数器。当需要对一组新段落进行独立的从1重新编号时，调用ListCollection.AddCopy(srcList)来复制现有的列表定义，然后将复制品应用到新段落，而不是重复使用原始定义。ListCollection.GetListByListId(listId)通过其ListId检索特定列表，以便在需要查找而不是创建时使用，Count则报告文档当前拥有的列表数量。

步骤 3：在列表层级之间移动段落

使用ListFormat.ListIndent()将段落向下移动一级到其列表中，使用ListOutdent()将其向上移动一级——这与 Word 在列表段落开头使用 Tab 和 Shift+Tab 的操作相同。相比直接设置ListLevelNumber，更推荐使用这些方法，因为它们能够保持段落的列表格式在内部的一致性。调用RemoveNumbers()可以完全去除段落的列表格式。

步骤 4：自定义列表层级的编号格式

通过List.ListLevels（一个ListLevelCollection）访问特定层级，然后一起设置ListLevel.NumberStyle（一个NumberStyle值，例如Arabic、UppercaseRoman、LowercaseLetter或Bullet）和NumberFormat——将数字与句点或括号等文字组合的格式字符串——因为不匹配会导致意外的渲染。StartAt设置该层级的起始编号，RestartAfterLevel控制哪个更高层级的递增会重新启动此层级的计数器——在嵌套列表中应显式设置，而不是依赖默认的重新启动行为。Alignment（Left、Center、Right）和TrailingCharacter（Tab、Space、Nothing）控制标签位置以及标签与段落文本之间的分隔符，另外TabPosition、NumberPosition和TextPosition用于精确布局。IsLegal强制使用法律式编号（始终为阿拉伯数字），不受NumberStyle的影响。

步骤 5：向列表层级添加图片项目符号

在目标层级上调用ListLevel.CreatePictureBullet()以创建图片项目符号定义，然后提供该项目符号的ImageData，随后移除同一层级上已有的文字项目符号格式。调用DeletePictureBullet()可以删除图片项目符号并恢复为基于文字的项目符号格式。

步骤 6：检查列表项的渲染标签

ListLabel 描述实际呈现的标签，用于单个列表项实例，从该项的段落格式获取。LabelString 是 Word 显示的文字——例如 “3.” 或 “•”——LabelValue 是其底层数值，而 Font 是标签自身的格式，独立于段落文本的格式。若要在序列的任意位置计算标签值而无需渲染整个列表，请调用 ListLevel.GetEffectiveValue(index, numberStyle, customNumberStyleFormat)。