Documentation – Обзор конструктора документов на C++

Cpp: Навигация с помощью курсора в C++

Mon, 01 Jan 0001 00:00:00 +0000

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

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

В этой статье объясняется, как перемещаться по документу и перемещаться с помощью виртуального курсора к различным его частям.

Определение текущего положения курсора

Прежде чем начать процесс навигации по документу, вам нужно будет указать узел, который выбран в данный момент. Вы можете получить точное положение курсора на выбранном узле, используя свойство 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.

В следующем примере кода показано, как перейти к определенному разделу и конкретному абзацу в документе:

Cpp: Используйте DocumentBuilder для вставки элементов документа

Mon, 01 Jan 0001 00:00:00 +0000

DocumentBuilder используется для изменения документов. В этой статье объясняется и описывается, как выполнять ряд задач:

Вставка текстовой строки

Просто передайте строку текста, которую вам нужно вставить в документ, методу DocumentBuilder.Write. Форматирование текста определяется свойством Font. Этот объект содержит различные атрибуты шрифта (название шрифта, размер шрифта, цвет и т.д.). Некоторые важные атрибуты шрифта также представлены свойствами DocumentBuilder, что позволяет получить к ним прямой доступ. Это логические свойства Font.Bold, Font.Italic и Font.Underline.

Обратите внимание, что заданное вами форматирование символов будет применяться ко всему тексту, вставленному начиная с текущей позиции в документе.

Приведенный ниже пример вставляет форматированный текст с помощью DocumentBuilder.

Вставка абзаца

DocumentBuilder.Writeln также вставляет строку текста в документ, но, кроме того, добавляет разрыв абзаца. Текущее форматирование шрифта также определяется свойством DocumentBuilder.Font, а текущее форматирование абзаца определяется свойством DocumentBuilder.ParagraphFormat. В приведенном ниже примере показано, как вставить абзац в документ.

Вставка таблицы

Базовый алгоритм создания таблицы с помощью DocumentBuilder прост:

Запустите таблицу с помощью DocumentBuilder.StartTable.
Вставьте ячейку, используя DocumentBuilder.InsertCell. При этом автоматически начнется новая строка. При необходимости используйте свойство DocumentBuilder.CellFormat, чтобы задать форматирование ячейки.
Вставьте содержимое ячейки, используя методы DocumentBuilder.
Повторяйте шаги 2 и 3, пока строка не будет завершена.
Вызовите DocumentBuilder.EndRow, чтобы завершить текущую строку. При необходимости используйте свойство DocumentBuilder.RowFormat, чтобы задать форматирование строки.
Повторяйте шаги 2-5, пока таблица не будет заполнена полностью.
Вызовите DocumentBuilder.EndTable, чтобы завершить создание таблицы. Ниже описаны соответствующие методы создания таблиц в DocumentBuilder.

Запуск таблицы

Вызов DocumentBuilder.StartTable является первым шагом в построении таблицы. Он также может быть вызван внутри ячейки, и в этом случае запускается вложенная таблица. Следующий вызываемый метод - DocumentBuilder.InsertCell.

Вставка ячейки

После вызова DocumentBuilder->InsertCell будет создана новая ячейка, и любое содержимое, добавленное с помощью других методов класса DocumentBuilder, будет добавлено в текущую ячейку. Чтобы создать новую ячейку в той же строке, снова вызовите DocumentBuilder->InsertCell. Используйте свойство DocumentBuilder.CellFormat, чтобы задать форматирование ячейки. Оно возвращает объект CellFormat, который представляет все форматирование ячейки таблицы.

Завершение строки

Вызовите DocumentBuilder.EndRow, чтобы завершить текущую строку. Если вы вызовете DocumentBuilder->InsertCell сразу после этого, таблица будет продолжена с новой строки.

Используйте свойство DocumentBuilder.RowFormat, чтобы указать форматирование строк. Оно возвращает объект RowFormat, который представляет все форматирование для строки таблицы.

Завершение таблицы

Вызовите DocumentBuilder.EndTable, чтобы завершить работу с текущей таблицей. Этот метод следует вызывать только один раз после вызова DocumentBuilder->EndRow. При вызове DocumentBuilder.EndTable курсор перемещается из текущей ячейки в позицию сразу за таблицей. В следующем примере показано, как создать отформатированную таблицу, содержащую 2 строки и 2 столбца.

Вставка разрыва

Если вы хотите явно начать новую строку, абзац, столбец, раздел или страницу, вызовите DocumentBuilder.InsertBreak. Передайте этому методу тип разрыва, который вам нужно вставить, который представлен перечислением BreakType. В приведенном ниже примере показано, как вставлять разрывы страниц в документ.

Вставка изображения

DocumentBuilder предоставляет несколько дополнений к методу DocumentBuilder->InsertImage, который позволяет вставлять встроенное или плавающее изображение. Если изображение представляет собой метафайл EMF или WMF, оно будет вставлено в документ в формате метафайла. Все остальные изображения будут сохранены в формате PNG. Метод DocumentBuilder->InsertImage позволяет использовать изображения из разных источников:

Из файла или URL, передав строковый параметр DocumentBuilder->InsertImage.
Из потока путем передачи параметра Stream DocumentBuilder->InsertImage.
Из объекта Image путем передачи параметра Image DocumentBuilder->InsertImage.
Из массива байтов путем передачи параметра массива байтов DocumentBuilder.InsertImage.Для каждого из методов DocumentBuilder->InsertImage существуют дополнительные перегрузки, которые позволяют вставлять изображение со следующими параметрами:
Встроенный или плавающий в определенном положении, например, DocumentBuilder->InsertImage.
Процентный масштаб или пользовательский размер, например, DocumentBuilder.InsertImage. Кроме того, метод DocumentBuilder->InsertImage возвращает объект Shape, который был только что создан и вставлен, чтобы вы могли дополнительно изменять свойства фигуры.

Вставка встроенного изображения

Передайте одну строку, представляющую файл, содержащий изображение, в DocumentBuilder->InsertImage, чтобы вставить изображение в документ в качестве встроенной графики. В приведенном ниже примере показано, как вставить встроенное изображение в положение курсора в документе.

Вставка плавающего (абсолютно расположенного) Изображение

В этом примере вставляется плавающее изображение из файла или URL в указанном положении и размере.

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

Чтобы вставить закладку в документ, вам необходимо выполнить следующие действия:

Вызовите DocumentBuilder->StartBookmark, передав ему желаемое название закладки.
Вставьте текст закладки, используя методы DocumentBuilder.
Вызовите DocumentBuilder.EndBookmark, передав ему то же имя, которое вы использовали в DocumentBuilder->StartBookmark.
Закладки могут перекрываться и охватывать любой диапазон. Чтобы создать действительную закладку, вам нужно вызвать как DocumentBuilder->StartBookmark, так и DocumentBuilder->EndBookmark с одинаковым именем закладки.

Неправильно оформленные закладки или закладки с повторяющимися названиями будут проигнорированы при сохранении документа.

В приведенном ниже примере показано, как вставить закладку в документ с помощью конструктора документов.

Вставка поля <code>Form</code>

Поля формы - это частный случай полей Word, которые позволяют “взаимодействовать” с пользователем. Поля формы в Microsoft Word включают текстовое поле, поле со списком и флажок.DocumentBuilder предоставляет специальные методы для вставки каждого типа полей формы в документ: DocumentBuilder.InsertTextInput, DocumentBuilder->InsertCheckBox и DocumentBuilder.InsertComboBox. Обратите внимание, что если вы укажете имя для поля формы, то автоматически будет создана закладка с таким же именем.

Вставка текста для ввода

DocumentBuilder.InsertTextInput чтобы вставить текстовое поле в документ. В приведенном ниже примере показано, как вставить поле формы ввода текста в документ.

Установка флажка

Вызовите DocumentBuilder.InsertCheckBox, чтобы вставить флажок в документ. В приведенном ниже примере показано, как вставить поле формы с флажком в документ.

Вставка поля со списком

Вызовите DocumentBuilder.InsertComboBox, чтобы вставить поле со списком в документ. В приведенном ниже примере показано, как вставить поле формы со списком в документ.

Вставка языкового стандарта на уровне поля

Теперь пользователи могут указывать языковой стандарт на уровне поля и могут лучше контролировать его. С каждым полем в DocumentBuilder можно связать идентификаторы языкового стандарта. Приведенные ниже примеры иллюстрируют, как использовать эту опцию.

Вставка гиперссылки

Используйте DocumentBuilder.InsertHyperlink, чтобы вставить гиперссылку в документ. Этот метод принимает три параметра: текст ссылки, которая будет отображаться в документе, адрес назначения ссылки (URL или название закладки внутри документа) и логический параметр, который должен иметь значение true, если URL является именем закладки внутри документа.DocumentBuilder.InsertHyperlink выполняет внутренний вызов DocumentBuilder.InsertField.Этот метод всегда добавляет апострофы в начале и конце URL-адреса. Обратите внимание, что вам необходимо явно указать форматирование шрифта для отображаемого текста гиперссылки, используя свойство Font. Приведенный ниже пример вставляет гиперссылку в документ с помощью DocumentBuilder.

Вставка Ole-объекта

Если вам нужен Ole-объект, вызовите DocumentBuilder.InsertOleObject. Передайте этому методу значение ProgId явно с другими параметрами. В приведенном ниже примере показано, как вставить Ole-объект в документ.

Задайте имя и расширение файла при вставке Ole-объекта

OLE-пакет - это устаревший и “недокументированный” способ хранения внедренного объекта, если обработчик OLE неизвестен. В ранних версиях Windows, таких как Windows 3.1, 95 и 98, было Packager.exe приложение, которое можно было использовать для встраивания данных любого типа в документ. Теперь это приложение исключено из Windows, но MS Word и другие приложения по-прежнему используют его для встраивания данных, если обработчик OLE отсутствует или неизвестен. Класс OlePackage позволяет получить доступ к свойствам пакета OLE. В приведенном ниже примере показано, как задать имя файла, расширение и отображаемое имя для OLE-пакета.

Вставка HTML-кода

Вы можете легко вставить HTML-строку, содержащую HTML-фрагмент или весь HTML-документ целиком, в документ Word. Просто передайте эту строку методу DocumentBuilder->InsertHtml. Одной из полезных реализаций метода является сохранение HTML-строки в базе данных и вставка ее в документ во время Mail Merge для добавления отформатированного содержимого вместо его создания с помощью различных методов конструктора документов. В приведенном ниже примере показано, как HTML-строка вставляется в документ с помощью DocumentBuilder.

Вставить горизонтальную линейку в документ

В примере low code показано, как вставить форму горизонтальной линейки в документ, используя метод DocumentBuilder->InsertHorizontalRule.

Cpp: Использование DocumentBuilder для простого изменения документа

Mon, 01 Jan 0001 00:00:00 +0000

Задание форматирования

Форматирование шрифта

Текущее форматирование шрифта представлено объектом Font, возвращаемым свойством DocumentBuilder.Font. Класс Font содержит широкий спектр свойств шрифта, доступных в Microsoft Word. В приведенном ниже примере показано, как задать форматирование шрифта.

Форматирование абзаца

Текущее форматирование абзаца представлено объектом ParagraphFormat, который возвращается свойством DocumentBuilder.ParagraphFormat. Этот объект инкапсулирует различные свойства форматирования абзаца, доступные в Microsoft Word. Вы можете легко изменить форматирование абзаца по умолчанию на обычный стиль, выровненный по левому краю, без отступов, без интервалов, без границ и без затенения, вызвав команду ParagraphFormat.ClearFormatting. В приведенном ниже примере показано, как настроить форматирование абзаца.

Работа с азиатской типографикой

Автоматическая регулировка интервала между азиатским и латинским текстом, цифрами

Если вы разрабатываете шаблон, содержащий как восточноазиатский, так и латинский текст, и хотите улучшить внешний вид шаблона формы, регулируя пробелы между обоими типами текста, вы можете настроить свой шаблон формы таким образом, чтобы он автоматически корректировал пробелы между этими двумя типами текста. Для достижения этой цели вы можете использовать свойства AddSpaceBetweenFarEastAndAlpha и AddSpaceBetweenFarEastAndDigit класса ParagraphFormat.

Следующий пример кода показывает, как использовать свойства ParagraphFormat.AddSpaceBetweenFarEastAndAlpha и ParagraphFormat.AddSpaceBetweenFarEastAndDigit.

Измените азиатский интервал между абзацами и отступы

В следующем примере кода показано, как изменить азиатский интервал между абзацами и отступы.

Установите параметры разрыва строки

На вкладке “Азиатская типографика” диалогового окна “Свойства” Paragraph в MS Word есть группа “Разрыв строки”. Параметры этой группы можно настроить с помощью параметров FarEastLineBreakControl, WordWrap, HangingPunctuation класса ParagraphFormat. В примереlow code показано, как использовать эти свойства.

Форматирование ячеек

Форматирование ячеек используется при построении таблицы. Оно представлено объектом CellFormat, возвращаемым свойством DocumentBuilder.CellFormat. CellFormat инкапсулирует различные свойства ячеек таблицы, такие как ширина или выравнивание по вертикали. В приведенном ниже примере показано, как создать таблицу, содержащую одну отформатированную ячейку.

Форматирование строк

Текущее форматирование строк определяется объектом RowFormat, который возвращается свойством DocumentBuilder.RowFormat. Этот объект содержит информацию о форматировании всех строк таблицы. В приведенном ниже примере показано, как создать таблицу, содержащую одну ячейку, и применить форматирование строк.

Форматирование списка

Aspose.Words позволяет легко создавать списки, применяя форматирование списка. DocumentBuilder предоставляет свойство DocumentBuilder.ListFormat, которое возвращает объект ListFormat. У этого объекта есть несколько методов для начала и завершения списка, а также для увеличения/уменьшения отступа. В Microsoft Word существует два основных типа списков: маркированные и нумерованные.

Чтобы запустить маркированный список, наберите ListFormat.ApplyBulletDefault.
Чтобы запустить нумерованный список, наберите ListFormat.ApplyNumberDefault.

Маркер или номер и форматирование добавляются к текущему абзацу и ко всем последующим абзацам, созданным с помощью DocumentBuilder, до тех пор, пока не будет вызван параметр ListFormat.RemoveNumbers, который остановит форматирование маркированного списка. В документах Word списки могут содержать до девяти уровней. Форматирование списка для каждого уровня определяет, какой маркер или число используется, отступ слева, пробел между маркером и текстом и т.д.

Чтобы увеличить уровень списка текущего абзаца на один уровень, вызовите ListFormat.ListIndent.
Чтобы уменьшить уровень списка текущего абзаца на один уровень, вызовите ListFormat.ListOutdent.

Методы изменяют уровень списка и применяют свойства форматирования нового уровня.

Вы также можете использовать свойство ListFormat.ListLevelNumber, чтобы получить или задать уровень списка для абзаца. Уровни списка пронумерованы от 0 до 8.

В приведенном ниже примере показано, как создать многоуровневый список.

Настройка страницы и форматирование разделов

Свойства настройки страницы и раздела заключены в объект PageSetup, который возвращается свойством DocumentBuilder.PageSetup. Объект содержит все атрибуты настройки страницы для раздела (левое поле, нижнее поле, формат бумаги и т.д.) в качестве свойств. В приведенном ниже примере показано, как задать такие свойства, как размер страницы и ориентация для текущего раздела.

Применение стиля

Некоторые объекты форматирования, такие как Font или ParagraphFormat, поддерживают стили. Отдельный встроенный или определяемый пользователем стиль представлен объектом Style, который содержит соответствующие свойства стиля, такие как название, базовый стиль, форматирование шрифта и абзаца в стиле и так далее.

Кроме того, объект Style предоставляет свойство Style.StyleIdentifier, которое возвращает идентификатор стиля, не зависящий от языка, представленный значением перечисления Style.StyleIdentifier. Дело в том, что названия встроенных стилей в Microsoft Word локализованы для разных языков. Используя идентификатор стиля, вы можете найти правильный стиль независимо от языка документа. Значения перечисления соответствуют встроенным стилям Microsoft Word, таким как обычный, Heading 1, Heading 2 и т.д. Всем пользовательским стилям присваивается значение StyleIdentifier.User value. В приведенном ниже примере показано, как применить стиль абзаца.

Границы и затенение

Границы представлены коллекцией BorderCollection. Это коллекция объектов Border, доступ к которым осуществляется по индексу или по типу границы. Тип границы представлен перечислением BorderType. Некоторые значения перечисления применимы к нескольким или только к одному элементу документа. Например, BorderType.Bottom применимо к абзацу или ячейке таблицы, в то время как BorderType.DiagonalDown определяет диагональную границу только в ячейке таблицы.

Как коллекция границ, так и каждая отдельная граница имеют схожие атрибуты, такие как цвет, стиль линии, ширина линии, расстояние от текста и необязательная тень. Они представлены одноименными свойствами. Комбинируя значения свойств, вы можете создавать различные типы границ. Кроме того, как объекты BorderCollection, так и объекты Border позволяют вам сбросить эти значения до значений по умолчанию, вызвав метод Border.ClearFormatting. Обратите внимание, что при сбросе свойств границы до значений по умолчанию граница становится невидимой. Класс Shading содержит атрибуты затенения для элементов документа. Вы можете задать желаемую текстуру затенения и цвета, которые будут применяться к фону и переднему плану элемента.

Текстура затенения задается значением перечисления TextureIndex, которое позволяет применять различные узоры к объекту Shading. Например, чтобы задать цвет фона для элемента документа, используйте значение TextureIndex.TextureSolid и соответствующим образом задайте цвет затенения переднего плана. В приведенном ниже примере показано, как применить границы и затенение к абзацу.

Привязка к сетке

Aspose.Words предоставляет два свойства ParagraphFormat.SnapToGrid и Font.SnapToGrid для получения и установки привязки свойств абзаца к сетке.

Перемещение курсора

Определение текущего положения курсора

Вы можете в любой момент узнать, где в данный момент находится курсор конструктора. Свойство DocumentBuilder.CurrentNode возвращает узел, который в данный момент выбран в этом конструкторе. Узел является прямым дочерним элементом абзаца. Любые операции вставки, которые вы выполняете с помощью DocumentBuilder, будут вставлены перед DocumentBuilder.CurrentNode. Если текущий абзац пуст или курсор установлен непосредственно перед концом абзаца, DocumentBuilder.CurrentNode возвращает значение null.

Также вы можете использовать свойство DocumentBuilder.CurrentParagraph, которое возвращает абзац, выбранный в данный момент в этом DocumentBuilder. В приведенном ниже примере показано, как получить доступ к текущему узлу в конструкторе документов. Вы можете загрузить файл шаблона для этого примера отсюда.

Переход к любому узлу (абзацам и их дочерним элементам)

Если у вас есть узел объекта документа, который является абзацем или прямым дочерним элементом абзаца, вы можете навести курсор конструктора на этот узел. Для этого используйте метод DocumentBuilder.MoveTo. В приведенном ниже примере показано, как переместить курсор на указанный узел. Вы можете скачать файл шаблона для этого примера здесь.

Переход к началу/концу документа

Если вам нужно перейти к началу документа, вызовите DocumentBuilder.MoveToDocumentStart. Если вам нужно перейти к концу документа, вызовите DocumentBuilder.MoveToDocumentEnd. В приведенном ниже примере показано, как переместить курсор в начало или конец документа. Вы можете скачать файл шаблона для этого примера здесь.

Переход к разделу

Если вы работаете с документом, содержащим несколько разделов, вы можете перейти к нужному разделу с помощью DocumentBuilder.MoveToSection. Этот метод перемещает курсор в начало указанного раздела и принимает индекс нужного раздела. Если индекс раздела больше или равен 0, то задается индекс от начала документа, где 0 - первый раздел. Если индекс раздела меньше 0, то задается индекс от конца документа, где -1 - последний раздел. В приведенном ниже примере показано, как переместить курсор в указанную секцию. Вы можете скачать файл шаблона для этого примера здесь.

Переход к верхнему/нижнему колонтитулу

Когда вам нужно поместить какие-либо данные в верхний или нижний колонтитул, вы должны сначала переместиться туда, используя DocumentBuilder.MoveToHeaderFooter. Метод принимает значение перечисления HeaderFooterType, которое определяет тип верхнего или нижнего колонтитула, куда следует переместить курсор. Если вы хотите создать верхние и нижние колонтитулы, отличающиеся для первой страницы, вам нужно установить для свойства PageSetup.DifferentFirstPageHeaderFooter значение true. Если вы хотите создать верхние и нижние колонтитулы, отличающиеся для четных и нечетных страниц, вам нужно установить для параметра PageSetup.OddAndEvenPagesHeaderFooter значение true.

Если вам нужно вернуться к основной истории, используйте DocumentBuilder.MoveToSection, чтобы перейти от верхнего или нижнего колонтитула. В приведенном ниже примере создаются верхние и нижние колонтитулы в документе с помощью DocumentBuilder.

Переход к абзацу

Используйте DocumentBuilder.MoveToParagraph, чтобы переместить курсор на нужный абзац в текущем разделе. Вы должны передать этому методу два параметра: paragraphIndex (индекс абзаца, к которому нужно перейти) и characterIndex (индекс символа внутри абзаца).

Навигация осуществляется внутри текущей истории текущего раздела. То есть, если вы переместили курсор на основной заголовок первого раздела, то paragraphIndex указывает индекс абзаца внутри этого заголовка этого раздела.

Если значение paragraphIndex больше или равно 0, то указывается индекс от начала раздела, где 0 - первый абзац. Если значение paragraphIndex меньше 0, то указывается индекс от конца раздела, где -1 - последний абзац.

В настоящее время индекс символа может быть указан только как 0 для перехода к началу абзаца или -1 для перехода к концу абзаца. В приведенном ниже примере показано, как переместить курсор в указанное положение абзаца. Вы можете скачать файл шаблона для этого примера здесь.

Переход к ячейке таблицы

Используйте DocumentBuilder.MoveToCell, если вам нужно переместить курсор в ячейку таблицы в текущем разделе. Этот метод принимает четыре параметра:

tableIndex - индекс таблицы, к которой нужно перейти.
RowIndex - индекс строки в таблице.
ColumnIndex - индекс столбца в таблице.
characterIndex - индекс символа внутри ячейки.

Навигация выполняется внутри текущей истории текущего раздела. Для параметров индекса, когда значение индекса больше или равно 0, задается индекс с самого начала, где 0 является первым элементом. Когда индекс меньше 0, он указывает индекс с конца, где -1 является последним элементом.

Также обратите внимание, что characterIndex в настоящее время может указывать только 0 для перемещения в начало ячейки или -1 для перемещения в конец ячейки. В приведенном ниже примере показано, как переместить курсор в указанную ячейку таблицы. Вы можете скачать файл шаблона для этого примера здесь.

Переход к закладке

Закладки часто используются для обозначения определенных мест в документе, куда необходимо вставить новые элементы. Чтобы перейти к закладке, используйте DocumentBuilder.MoveToBookmark. Этот метод имеет две перегрузки. Самый простой из них не принимает ничего, кроме названия закладки, на которую нужно переместить курсор. В приведенном ниже примере показано, как переместить курсор на закладку. Вы можете скачать файл шаблона для этого примера здесь.

Эта перегрузка перемещает курсор в положение сразу после начала закладки с указанным именем. Другая перегрузка DocumentBuilder.MoveToBookmark перемещает курсор на закладку с большей точностью. Она принимает два дополнительных логических параметра:

isStart определяет, следует ли переместить курсор в начало или в конец закладки.
isAfter определяет, следует ли переместить курсор в начальную или конечную позицию закладки или переместить курсор в начальную или конечную позицию закладки.

В приведенном ниже примере показано, как переместить курсор сразу после окончания закладки.

Сравнение для обоих методов не чувствительно к регистру.

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

Как произвести преобразование между единицами измерения

Большинство свойств объекта, предоставляемых в API Aspose.Words, которые представляют некоторые измерения (ширину/высоту, поля и различные расстояния), принимают значения в пунктах (1 дюйм равен 72 точкам). Иногда это неудобно, поэтому существует класс ConvertUtil, который предоставляет вспомогательные функции для преобразования между различными единицами измерения. Он позволяет преобразовывать дюймы в точки, точки в дюймы, пиксели в точки и точки в пиксели. Когда пиксели преобразуются в точки и наоборот, это может быть выполнено с разрешением 96 точек на дюйм (dpi) или с указанным разрешением dpi. Преобразующий