Работа с отметки
Отметките идентифицират в документ 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.
Следващият пример за код показва как да се показват / скриват отметките: