TabStopCollection

TabStopCollection class

集合TabStop代表段落或样式的自定义选项卡的对象。

public class TabStopCollection : InternableComplexAttr

特性

姓名 描述
Count { get; } 获取集合中的制表位数。
Item { get; } 在给定索引处获取制表位。 (2 indexers)

方法

姓名 描述
Add(TabStop) 在集合中添加或替换制表位。
Add(double, TabAlignment, TabLeader) 在集合中添加或替换制表位。
After(double) 获取指定位置右侧的第一个制表位。
Before(double) 获取指定位置左侧的第一个制表位。
Clear() 删除所有制表位位置。
override Equals(object) 确定指定对象的值是否与当前对象相等。
Equals(TabStopCollection) 确定指定的 TabStopCollection 的值是否与当前的 TabStopCollection 相等。
override GetHashCode() 用作此类型的散列函数。
GetIndexByPosition(double) 获取具有指定位置的制表位的索引，以点为单位。
GetPositionByIndex(int) 获取指定索引处制表位的位置（以磅为单位）。
RemoveByIndex(int) 从集合中删除指定索引处的制表位。
RemoveByPosition(double) 从集合中删除指定位置的制表位。

评论

在 Microsoft Word 文档中，制表位可以在段落 样式的属性中定义，也可以直接在段落的属性中定义。一个样式可以基于另一个样式。 因此，给定对象的完整制表位集是直接在此对象上定义的制表位 和从父样式继承的制表位的组合。

在 Aspose.Words 中，当您获得 制表位段落或样式的集合， 它仅包含直接为此段落或样式定义的自定义制表位。 该集合不包括在父样式或默认制表位中定义的制表位。

例子

显示如何使用文档的制表位集合。

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

TabStopCollection tabStops = builder.ParagraphFormat.TabStops;

// 72 磅是 Microsoft Word 制表位标尺上的一英寸。
tabStops.Add(new TabStop(72.0));
tabStops.Add(new TabStop(432.0, TabAlignment.Right, TabLeader.Dashes));

Assert.AreEqual(2, tabStops.Count);
Assert.IsFalse(tabStops[0].IsClear);
Assert.IsFalse(tabStops[0].Equals(tabStops[1]));

// 每个“制表符”字符将构建器的光标带到下一个制表位的位置。
builder.Writeln("Start\tTab 1\tTab 2");

ParagraphCollection paragraphs = doc.FirstSection.Body.Paragraphs;

Assert.AreEqual(2, paragraphs.Count);

// 每个段落都有它的制表位集合，它从文档构建器的制表位集合中克隆它的值。
Assert.AreEqual(paragraphs[0].ParagraphFormat.TabStops, paragraphs[1].ParagraphFormat.TabStops);
Assert.AreNotSame(paragraphs[0].ParagraphFormat.TabStops, paragraphs[1].ParagraphFormat.TabStops);

// 制表位集合可以将我们指向特定位置之前和之后的 TabStops。
Assert.AreEqual(72.0, tabStops.Before(100.0).Position);
Assert.AreEqual(432.0, tabStops.After(100.0).Position);

// 我们可以清除段落的制表位集合以恢复默认的制表行为。
paragraphs[1].ParagraphFormat.TabStops.Clear();

Assert.AreEqual(0, paragraphs[1].ParagraphFormat.TabStops.Count);

doc.Save(ArtifactsDir + "TabStopCollection.TabStopCollection.docx");

也可以看看

TabStop TableStyle