Навігація за допомогою курсору
При роботі з документом, навіть якщо він короткий або довгий, вам потрібно буде переміщатися по ньому. Навігація за допомогою віртуального курсору являє собою можливість переміщатися між різними вузлами документа.
У короткому документі легко переміщатися по тексту, оскільки ви можете переміщати точку вставки, навіть використовуючи клавіші зі стрілками на клавіатурі або клацаючи мишею, щоб знайти точку вставки в потрібному місці. Але якщо у вас великий документ з великою кількістю сторінок, цих основних методів буде недостатньо.
У цій статті пояснюється, як переміщатися по документу та переміщатися за допомогою віртуального курсору до різних його частин.
Визначення поточного положення курсору
Перш ніж почати процес навігації по документу, вам потрібно буде вказати вузол, який обраний в даний момент. Ви можете отримати точне положення курсору на вибраному вузлі, використовуючи властивість CurrentNode. Крім того, замість отримання поточного вузла ви можете отримати поточний вибраний абзац або поточний вибраний розділ, використовуючи властивості CurrentParagraph та CurrentSection.
Усі операції вставки, які ви виконуєте за допомогою DocumentBuilder, будуть вставлені перед CurrentNode. Якщо поточний абзац порожній або курсор встановлений безпосередньо перед кінцем абзацу, CurrentNode повертає значення nullptr.
Методи навігації по документу
Коли ви редагуєте текст, важливо знати, як переміщатися по документу і куди саме переміщатися в ньому. Aspose.Words дозволяє переміщатися по документу і переходити до його різних розділів і частин – це аналогічно функціональності панелі навігації в Microsoft Word для переходу до сторінки або заголовка в документі Word без прокрутки.
Основний метод полягає в тому, щоб мати можливість перемістити положення курсору до певного вузла у вашому документі, ви можете досягти цього за допомогою методу MoveTo.
Наступний приклад коду показує, як перемістити DocumentBuilder до різних вузлів документа:
Але крім базового методу MoveTo, є і більш специфічні.
Перейдіть до початку або кінця документа
Ви можете перейти до початку або кінця документа, використовуючи методи MoveToDocumentStart та MoveToDocumentEnd.
Наступний приклад коду показує, як перемістити курсор на початок або кінець документа:
Навігація за допомогою закладок
Ви можете позначити місце, яке хочете знайти, і легко перейти до нього знову. Ви можете вставити в документ скільки завгодно закладок, а потім переміщатися по них, присвоюючи закладкам унікальні назви. Ви можете перейти до закладки, використовуючи метод MoveToBookmark.
Наступні приклади коду показують, як перемістити курсор на закладку:
Перейдіть до клітинок таблиці
Ви можете перейти до комірки таблиці, використовуючи метод MoveToCell. Цей метод дозволить вам перемістити курсор до будь-якої комірки певної таблиці. Крім того, ви можете вказати індекс для переміщення курсору в будь-яку позицію або на вказаний символ у комірці за допомогою методу MoveToCell.
Наступний приклад коду показує, як перемістити курсор до вказаної комірки таблиці:
Перейдіть до поля
Ви можете перейти до певного поля у вашому документі, використовуючи метод MoveToField. Крім того, ви можете перейти до певного поля об’єднання, використовуючи метод MoveToMergeField.
Наступний приклад коду показує, як перемістити курсор конструктора документів на певне поле:
Перейдіть до верхнього або нижнього колонтитула
Ви можете перейти до початку верхнього або нижнього колонтитула, використовуючи метод MoveToHeaderFooter.
Наступний приклад коду показує, як перемістити курсор конструктора документів у верхній або нижній колонтитул документа:
Перейдіть до розділу або абзацу
Ви можете перейти до певного розділу або абзацу, використовуючи методи MoveToParagraph або MoveToSection. Крім того, ви можете вказати індекс для переміщення курсору в будь-яку позицію або на вказаний символ в абзаці за допомогою методу MoveToParagraph.
Наступний приклад коду показує, як перейти до певного розділу та певного абзацу в документі: