Работа с закладками

Закладки идентифицируют в Microsoft Word Документируйте места или фрагменты, которые вы называете и идентифицируете для будущей ссылки. Например, вы можете использовать закладку для идентификации текста, который вы хотите пересмотреть позже. Вместо того, чтобы прокручивать документ, чтобы найти текст, вы можете перейти к нему, используя диалоговое окно Bookmark.

Действия, которые можно выполнять с помощью закладок Aspose.Words те же, которые вы можете использовать Microsoft Word. Вы можете вставить новую закладку, удалить, перейти в закладку, получить или установить имя закладки, получить или установить текст, заключенный в нее.

Вставить закладку

Использовать StartBookmark и EndBookmark Создать закладку, отмечая ее начало и конец соответственно. Не забудьте передать одно и то же название закладки обоим методам. Закладки в документе могут перекрываться и охватывать любой диапазон. Плохо сформированные закладки или закладки с дублирующими именами будут игнорироваться при сохранении документа.

Следующий пример кода показывает, как создать новую закладку:

Получить закладки

Иногда необходимо получить коллекцию закладок для итерации через закладки или для других целей. Используйте Node.Range свойство, раскрытое любым узлом документа, который возвращает Range объект, представляющий часть документа, содержащегося в этом узле. Используйте этот объект для извлечения BookmarkCollection Затем используйте индексатор сбора, чтобы получить конкретную закладку.

Следующий пример кода показывает, как получить закладки из коллекции закладок:

Следующий пример кода показывает, как получить или установить имя закладки и текст:

Следующий пример кода показывает, как заложить таблицу:

Если вы измените название закладки на имя, которое уже существует в документе, ошибка не будет сгенерирована, и только первая закладка будет сохранена при сохранении документа.

Обратите внимание, что некоторые закладки в документе назначаются для формирования полей. Переходя к такой закладке и вставляя текст там вставляет текст в код поля формы. Хотя это не отменяет поле формы, вставленный текст не будет виден, потому что он становится частью кода поля.

Следующий пример кода показывает, как получить доступ к столбцам таблицы закладок:

Перейти к закладке

Если вам нужно вставить богатый контент (а не простой текст) в закладку, вы должны использовать MoveToBookmark Переместить курсор в закладку, а затем использовать DocumentBuilder’s Способы и свойства для вставки контента.

Показать скрытый контент закладки

Вся Закладка (включая закладки) может быть инкапсулирована в пределах Истинной части Закладки. IF поле используя Aspose.Words. Это может быть таким образом, что IF поле содержит вложенное поле слияния в выражении (Left of Operator) и в зависимости от значения поля слияния, IF поле показывает или скрывает содержание закладки в Word Document.

Следующий пример кода показывает, как показывать / скрывать закладки: