Робота з закладками
Закладки визначають у документі Microsoft Word місця або фрагменти, які ви вказуєте та ідентифікуєте для подальшого використання. Наприклад, ви можете використовувати закладку для визначення тексту, який ви хочете переглянути пізніше. Замість того, щоб прокручувати документ у пошуках потрібного тексту, ви можете перейти до нього за допомогою діалогового вікна “Закладки”.
Дії, які можна виконати із закладками за допомогою Aspose.Words, подібні до тих, які можна виконати за допомогою Microsoft Word. Ви можете вставити нову закладку, Видалити, Перемістити в закладку, отримати або задати назву закладки, отримати або задати текст, укладений в ній. За допомогою Aspose.Words ви також можете використовувати закладки у звітах або документах, щоб вставити в них деякі дані або застосувати спеціальне форматування до їх вмісту. Ви також можете використовувати закладки для вилучення тексту з певного місця у вашому документі.
Вставити закладку
Використовуйте StartBookmark та EndBookmark для створення закладки, позначивши її початок та кінець відповідно. Не забудьте вказати однакову назву закладки в обох методах. Закладки в документі можуть перекриватися і охоплювати будь-який діапазон. Неправильно оформлені закладки або закладки з повторюваними назвами будуть проігноровані при збереженні документа.
Наступний приклад коду показує, як створити нову закладку:
Отримувати закладки
Іноді необхідно отримати колекцію закладок для перебору закладок або для інших цілей. Використовуйте властивість Node.Range, надану будь-яким вузлом документа, який повертає об’єкт Range, Що представляє частину документа, що міститься в цьому вузлі. Використовуйте цей об’єкт для вилучення BookmarkCollection, а потім використовуйте індексатор колекції, щоб отримати певну закладку.
Наступний приклад коду показує, як отримати закладки з колекції закладок:
У наступному прикладі коду показано, як отримати або задати назву закладки і текст:
Наступний приклад коду показує, як додати таблицю в закладки:
Якщо ви зміните назву закладки на ім’я, яке вже існує в документі, помилка не буде згенерована, і при збереженні документа буде збережена тільки перша закладка.
Перейти до закладки
Якщо вам потрібно вставити розширений вміст (а не просто звичайний текст) у закладку, Вам слід використовувати MoveToBookmark для переміщення курсору на закладку, а потім використовувати методи та властивості DocumentBuilder’s для вставки вмісту.
Показувати і приховувати вміст закладок
Вся закладка (including the bookmarked content) може бути укладена в істинну частину поля IF за допомогою Aspose.Words. Це може бути так, що поле IF містить вкладене поле об’єднання у виразі (Left of Operator), і залежно від значення поля об’єднання поле IF відображає або приховує вміст закладки в документі Word.
Наступний приклад коду показує, як показувати / приховувати закладки: