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 при получении TabStops коллекция для абзаца или стиля, содержит только пользовательские позиции табуляции, определенные непосредственно для этого абзаца или стиля. Коллекция не включает позиции табуляции, определенные в родительских стилях или позиции табуляции по умолчанию.

Примеры

Показывает, как работать с набором позиций табуляции в документе.

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);

// Набор позиций табуляции может указывать нам на позиции TabStop до и после определенных позиций.
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");

Смотрите также