ListLevel

ListLevel class

定义列表级别的格式。

要了解更多信息，请访问使用列表文档文章。

public class ListLevel

特性

姓名描述
Alignment { get; set; }获取或设置列表项实际数量的对齐方式。
CustomNumberStyleFormat { get; set; }获取或设置此列表级别的自定义数字样式格式。例如：“a、ç、ĝ、…”。
Font { get; }指定用于列表标签的字符格式。
ImageData { get; }返回当前列表级别的图片项目符号形状的图像数据。
IsLegal { get; set; }如果级别将所有继承的数字转换为阿拉伯数字，则为 True；如果保留其数字样式，则为 false。
LinkedStyle { get; set; }获取或设置链接到此列表级别的段落样式。
NumberFormat { get; set; }返回或设置列表级别的数字格式。
NumberPosition { get; set; }返回或设置列表级别的编号或项目符号的位置（以磅为单位）。
NumberStyle { get; set; }返回或设置此列表级别的数字样式。
RestartAfterLevel { get; set; }设置或返回在指定列表级别重新开始编号之前必须出现的列表级别。
StartAt { get; set; }返回或设置此列表级别的起始编号。
TabPosition { get; set; }返回或设置列表级别的制表符位置（以点为单位）。
TextPosition { get; set; }返回或设置列表级别的第二行换行文本的位置（以点为单位）。
TrailingCharacter { get; set; }返回或设置插入列表级别数字后的字符。

方法

姓名描述
CreatePictureBullet()为当前列表级别创建图片项目符号形状。
DeletePictureBullet()删除当前列表级别的图片项目符号。
Equals(ListLevel)与指定的 ListLevel 进行比较。
override GetHashCode()计算此对象的哈希码。
static GetEffectiveValue(int, NumberStyle, string)报告ListLevel列表项指定 index 的对象。参数指定NumberStyle以及可选格式 string 用于Custom已指定。

评论

您无需创建此类的对象。列表级别的对象会在创建列表时自动创建 。您可以访问ListLevel通过 the 的对象ListLevelCollection收藏。

使用属性ListLevel为各个列表级别指定列表 formatting 。

例子

展示如何在使用 DocumentBuilder 时将自定义列表格式应用于段落。

Document doc = new Document();

// 列表允许我们使用前缀符号和缩进来组织和装饰段落集。
 // 我们可以通过增加缩进级别来创建嵌套列表。
 // 我们可以使用文档构建器的“ListFormat”属性来开始和结束列表。
// 我们在列表的开始和结束之间添加的每个段落都将成为列表中的一个项目。
// 从 Microsoft Word 模板创建列表，并自定义其列表级别的前两个。
List list = doc.Lists.Add(ListTemplate.NumberDefault);

ListLevel listLevel = list.ListLevels[0];
listLevel.Font.Color = Color.Red;
listLevel.Font.Size = 24;
listLevel.NumberStyle = NumberStyle.OrdinalText;
listLevel.StartAt = 21;
listLevel.NumberFormat = "\x0000";

listLevel.NumberPosition = -36;
listLevel.TextPosition = 144;
listLevel.TabPosition = 144;

listLevel = list.ListLevels[1];
listLevel.Alignment = ListLevelAlignment.Right;
listLevel.NumberStyle = NumberStyle.Bullet;
listLevel.Font.Name = "Wingdings";
listLevel.Font.Color = Color.Blue;
listLevel.Font.Size = 24;

// 此 NumberFormat 值将创建星形项目符号列表符号。
listLevel.NumberFormat = "\xf0af";
listLevel.TrailingCharacter = ListTrailingCharacter.Space;
listLevel.NumberPosition = 144;

// 创建段落并将我们的自定义列表格式的两个列表级别应用于它们。
DocumentBuilder builder = new DocumentBuilder(doc);

builder.ListFormat.List = list;
builder.Writeln("The quick brown fox...");
builder.Writeln("The quick brown fox...");

builder.ListFormat.ListIndent();
builder.Writeln("jumped over the lazy dog.");
builder.Writeln("jumped over the lazy dog.");

builder.ListFormat.ListOutdent();
builder.Writeln("The quick brown fox...");

builder.ListFormat.RemoveNumbers();

builder.Document.Save(ArtifactsDir + "Lists.CreateCustomList.docx");

也可以看看

ListLabel Class ListLevelAlignment Enum