Работа с закладками
Закладки определяют в документе Microsoft Word местоположения или фрагменты, которые вы указываете и идентифицируете для дальнейшего использования. Например, вы можете использовать закладку для определения текста, который хотите просмотреть позже. Вместо того чтобы прокручивать документ в поисках нужного текста, вы можете перейти к нему с помощью диалогового окна “Закладки”.
С помощью Aspose.Words вы можете использовать закладки в отчетах или документах, чтобы вставить в них некоторые данные или применить специальное форматирование к их содержимому. Вы также можете использовать закладки для извлечения текста из определенного места в вашем документе.
Действия, которые можно выполнить с закладками с помощью Aspose.Words, аналогичны тем, которые вы можете выполнить с помощью Microsoft Word. Вы можете вставить новую закладку, удалить, переместить в закладку, получить или задать название закладки, получить или задать текст, заключенный в ней.
Вставить закладку
Используйте startBookmark и endBookmark для создания закладки, отметив ее начало и конец соответственно. Не забудьте указать одинаковое название закладки в обоих методах. Закладки в документе могут перекрываться и охватывать любой диапазон. Неправильно оформленные закладки или закладки с повторяющимися названиями будут проигнорированы при сохранении документа.
В следующем примере кода показано, как создать новую закладку:
Получать закладки
Иногда необходимо получить коллекцию закладок для перебора закладок или для других целей. Используйте свойство Node.getRange, предоставляемое любым узлом документа, которое возвращает объект Range, представляющий часть документа, содержащуюся в этом узле. Используйте этот объект для извлечения BookmarkCollection, а затем используйте индексатор коллекции, чтобы получить определенную закладку.
В следующем примере кода показано, как получить закладки из коллекции закладок:
В следующем примере кода показано, как получить или задать название закладки и текст:
В следующем примере кода показано, как добавить таблицу в закладки:
Если вы измените название закладки на имя, которое уже существует в документе, ошибка сгенерирована не будет, и при сохранении документа будет сохранена только первая закладка.
Обратите внимание, что некоторые закладки в документе назначены полям формы. При переходе к такой закладке и вставке текста в нее текст будет вставлен в код поля формы. Хотя это не приведет к аннулированию поля формы, вставленный текст не будет виден, поскольку он станет частью кода поля.
В следующем примере кода показано, как получить доступ к столбцам таблицы с закладками:
Перейти к закладке
Если вам нужно вставить расширенный контент (не только обычный текст) в закладку, вы должны использовать moveToBookmark для перемещения курсора на закладку, а затем использовать DocumentBuilder методы и свойства для вставки содержимого.
Показывать и скрывать содержимое закладок
Вся закладка (including the bookmarked content) может быть заключена в истинную часть поля IF с помощью Aspose.Words. Это может быть сделано таким образом, что поле IF содержит вложенное поле объединения в выражении (Left of Operator), и в зависимости от значения поля объединения поле IF отображает или скрывает содержимое закладки в документе Word.
В следующем примере кода показано, как показывать/ скрывать закладки.