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

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

// Коллекция позиций табуляции может указать нам на позиции 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");

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

TabStop Class TableStyle Class