Метод TablesOfContents.Add (Word)

Статья
04/07/2023

Возвращает объект TableOfContents , представляющий оглавление, добавленное в документ.

Синтаксис

expression. Add (Range, UseHeadingStyles, UpperHeadingLevel, LowerHeadingLevel, UseFields, TableID, RightAlignPageNumbers, IncludePageNumbers, AddedStyles, UseHyperlinks, HidePageNumbersInWeb, UseOutlineLevels)

выражение (обязательно). Переменная, представляющая коллекцию TablesOfContents.

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
Range	Обязательный	Объект Range	Диапазон, в котором нужно отображать оглавление. Оглавление заменяет диапазон, если диапазон не свернут.
UseHeadingStyles	Необязательный	Variant	Значение true для использования встроенных стилей заголовков для создания оглавлиния. Значение по умолчанию — True.
UpperHeadingLevel	Необязательный	Variant	Начальный уровень заголовка для оглавлиния. Соответствует начальному значению, используемому с параметром \o для поля оглавление (Оглавление). Значение по умолчанию равно 1.
LowerHeadingLevel	Необязательный	Variant	Конечный уровень заголовка для оглавлиния. Соответствует конечному значению, используемому с параметром \o для поля Оглавление (Оглавление). По умолчанию параметр имеет значение 9.
UseFields	Необязательный	Variant	Значение true , если для создания оглавление используются поля оглавление (TC). Используйте метод MarkEntry , чтобы пометить записи, которые должны быть включены в оглавление. Значение по умолчанию — False.
TableID	Необязательный	Variant	Однобуквенный идентификатор, используемый для построения оглавлиния на основе полей TC. Соответствует параметру \f для поля оглавление (ОГЛА). Например, "T" создает оглавление из полей TC с использованием идентификатора таблицы T. Если этот аргумент опущен, поля TC не используются.
RightAlignPageNumbers	Необязательный	Variant	Значение true , если номера страниц в оглавлении выровнены по правому краю. Значение по умолчанию — True.
IncludePageNumbers	Необязательный	Variant	Значение true для включения номеров страниц в оглавление. Значение по умолчанию — True.
AddedStyles	Необязательный	Variant	Имя строки для дополнительных стилей, используемых для компиляции оглавлиния (стили, отличные от стилей Заголовки 1 – Заголовок 9). Используйте метод Add объекта HeadingStyles для создания новых стилей заголовков.
UseHyperlinks	Необязательный	Variant	Значение true , если записи в оглавлении должны быть отформатированы в виде гиперссылок при публикации документа в Интернете. Значение по умолчанию — True.
HidePageNumbersInWeb	Необязательный	Variant	Значение true , если номера страниц в оглавлении должны быть скрыты при публикации документа в Интернете. Значение по умолчанию — True.
UseOutlineLevels	Необязательный	Variant	Значение true для использования уровней структуры для создания оглавлиния. Значение по умолчанию - false.

Возвращаемое значение

TableOfContents

Пример

В этом примере в начале активного документа добавляется оглавление. Оглавление строится на основе абзацев, стили в стиле Заголовок 1, Заголовок 2 и Заголовок 3 или пользовательские стили myStyle и yourStyle.

Set myRange = ActiveDocument.Range(0, 0) 
ActiveDocument.TablesOfContents.Add _ 
 Range:=myRange, _ 
 UseFields:=False, _ 
 UseHeadingStyles:=True, _ 
 LowerHeadingLevel:=3, _ 
 UpperHeadingLevel:=1, _ 
 AddedStyles:="myStyle, yourStyle"

См. также

Объект коллекции TablesOfContents

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.