TabStopCollection

TabStopCollection class

КоллекцияTabStop объекты, которые представляют пользовательские вкладки для абзаца или стиля.

Чтобы узнать больше, посетитеОбъектная модель документа Aspose.Words (DOM) статья документации.

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

В Aspose.Words, когда вы получаетеTabStopCollectionдля абзаца или стиля он содержит только пользовательские позиции табуляции, определенные непосредственно для этого абзаца или стиля. Коллекция не включает позиции табуляции, определенные в родительских стилях или позициях табуляции по умолчанию.

Примеры

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

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 Class TableStyle Class