InsertTableOfContents
DocumentBuilder.InsertTableOfContents method
Вставляет поле TOC (оглавление) в документ.
public Field InsertTableOfContents(string switches)
Параметр | Тип | Описание |
---|---|---|
switches | String | Поле TOC переключается. |
Примечания
Этот метод вставляет поле TOC (оглавление) в документ в текущей позиции.
Оглавление в документе Word может быть построено несколькими способами и отформатировано с использованием различных параметров. Способ построения таблицы и ее отображения в Microsoft Word контролируется переключателями полей.
Самый простой способ указать переключатели — вставить и настроить таблицу содержимого в документ Word с помощью меню «Вставка->Ссылка->Указатель и таблицы», , а затем включить отображение кодов полей, чтобы увидеть переключатели. Вы можете нажать Alt+F9 in Microsoft Word, чтобы включить или выключить отображение кодов полей.
Например, после создания оглавления в документ вставляется следующее поле :{ TOC \o “1-3” \h \z \u } . Вы можете скопировать**\o “1-3” \h \z \u** и используйте его в качестве параметра переключателей.
Обратите внимание, чтоInsertTableOfContents
вставит только поле оглавления, но фактически не построит оглавление. Оглавление создается с помощью Microsoft Word при обновлении поля.
Если вы вставите оглавление с помощью этого метода, а затем откроете файл в Microsoft Word, вы не увидите оглавление, поскольку поле TOC еще не было обновлено.
В Microsoft Word поля не обновляются автоматически при открытии документа, , но вы можете обновить поля в документе в любое время, нажав F9.
Примеры
Показывает, как вставить оглавление (TOC) в документ, используя стили заголовков в качестве записей.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Вставляем оглавление первой страницы документа.
// Настройте таблицу так, чтобы она подбирала абзацы с заголовками уровней от 1 до 3.
// Также сделайте его записи гиперссылками, которые приведут нас
// к местоположению заголовка при щелчке левой кнопкой мыши в Microsoft Word.
builder.InsertTableOfContents("\\o \"1-3\" \\h \\z \\u");
builder.InsertBreak(BreakType.PageBreak);
// Заполняем оглавление, добавляя абзацы со стилями заголовков.
// Каждый такой заголовок уровня от 1 до 3 создаст запись в таблице.
builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading1;
builder.Writeln("Heading 1");
builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading2;
builder.Writeln("Heading 1.1");
builder.Writeln("Heading 1.2");
builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading1;
builder.Writeln("Heading 2");
builder.Writeln("Heading 3");
builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading2;
builder.Writeln("Heading 3.1");
builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading3;
builder.Writeln("Heading 3.1.1");
builder.Writeln("Heading 3.1.2");
builder.Writeln("Heading 3.1.3");
builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading4;
builder.Writeln("Heading 3.1.3.1");
builder.Writeln("Heading 3.1.3.2");
builder.ParagraphFormat.StyleIdentifier = StyleIdentifier.Heading2;
builder.Writeln("Heading 3.2");
builder.Writeln("Heading 3.3");
// Оглавление — это поле типа, которое необходимо обновить, чтобы отобразить актуальный результат.
doc.UpdateFields();
doc.Save(ArtifactsDir + "DocumentBuilder.InsertToc.docx");
Смотрите также
- class Field
- class DocumentBuilder
- пространство имен Aspose.Words
- сборка Aspose.Words