Использовать `DocumentBuilder` Включить элементы документов

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

Вставить строку текста

Просто передайте строку текста, которую нужно вставить в документ, на DocumentBuilder.write метод. Форматирование текста определяется Font собственность. Этот объект содержит различные атрибуты шрифта (имя шрифта, размер шрифта, цвет и так далее). Некоторые важные атрибуты шрифта также представлены DocumentBuilder Свойства, позволяющие получить к ним прямой доступ. Это булевы свойства Font.getBold, Font.getItalic, и Font.getUnderline.

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

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

Включить пункт

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

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

Вставить стол

Основной алгоритм для создания таблицы с использованием DocumentBuilder Это просто:

Начните использовать стол DocumentBuilder.startTable.
Вставьте клетку, используя DocumentBuilder.insertCell. Это автоматически запускает новый ряд. При необходимости используйте DocumentBuilder.getCellFormat свойство определять форматирование ячеек.
Вставьте содержимое ячейки, используя DocumentBuilder методы.
Повторяйте шаги 2 и 3 до завершения строки.
Звони. DocumentBuilder.endRow Чтобы закончить текущий ряд. При необходимости использовать DocumentBuilder.RowFormat свойство указывать форматирование строк.
Повторите шаги 2 - 5, пока таблица не будет завершена.
Звони. DocumentBuilder.endTable Чтобы закончить строительство стола. Соответствующие методы создания таблицы DocumentBuilder описаны ниже.

Начинаем столик

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

Вставить клетку

После звонка в DocumentBuilder. вставить Ячейка, создается новая ячейка и любой контент, который вы добавляете, используя другие методы. DocumentBuilder Класс будет добавлен к текущей ячейке. Чтобы запустить новую ячейку в том же ряду, позвоните в DocumentBuilder. вставить Снова камера. Используйте DocumentBuilder.getCell Свойство формата для определения форматирования ячеек. возвращается a getCellFormat объект, представляющий все форматирование для ячейки стола.

Окончание ряда

Позвоните по адресу DocumentBuilder.end Завершить текущий ряд. Позвоните в DocumentBuilder. вставить Ячейка сразу после этого, затем столик продолжает по новому ряду. Используйте DocumentBuilder.RowFormat свойство указывать форматирование строк. возвращается a RowFormat Объект, который представляет все форматирование для строки таблицы.

Окончание стола

Позвоните по адресу DocumentBuilder.end Таблица для завершения текущей таблицы. Этот метод следует называть только один раз после DocumentBuilder. Был назван EndRow. Когда звонят, DocumentBuilder.end Таблица перемещает курсор из текущей ячейки в положение сразу после таблицы. Следующий пример показывает, как построить отформатированную таблицу, которая содержит 2 строки и 2 столбца.

Вставить перерыв

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

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

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

из файла или URL Пройдя струнный параметр
из ручья, проходя мимо Stream параметр
от объекта изображения путем прохождения параметра изображения
из байтового массива путем пропускания параметра байтового массива
и другие

Для каждого из конструкторов документов. вставить Методы изображения, есть дополнительные перегрузки, которые позволяют вставить изображение со следующими опциями:

Наклон или плавание в определенном положении
Процентная шкала или пользовательский размер

Кроме того, DocumentBuilder.insert Метод изображения возвращает Shape Объект, который был только что создан и вставлен, чтобы вы могли дополнительно изменять свойства формы.

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

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

Вставить плавающее (абсолютно позиционированное) изображение

Этот пример вставляет плавающее изображение из файла или URL в определенном положении и размере.

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

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

Звони. DocumentBuilder.startBookmark Дайте ему желаемое название закладки.
Включить текст закладки с использованием DocumentBuilder методы.
Звони. DocumentBuilder.endBookmark Передав ему то же имя, которое вы использовали с DocumentBuilder.startBookmark.

Закладки могут перекрывать и охватывать любой диапазон. Чтобы создать действительную закладку, вам нужно позвонить в DocumentBuilder.startBookmark и DocumentBuilder.endBookmark с одинаковым названием закладки.

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

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

Вставить поле

Поля в Microsoft Word Документы состоят из кода поля и результата поля. Код поля подобен формуле, а результат поля - значение, которое формула производит. Код поля может также содержать переключатели поля, которые являются дополнительными инструкциями для выполнения конкретного действия. Вы можете переключаться между отображением полевых кодов и результатами в вашем документе. Microsoft Word использование сочетания клавиш Alt+F9. Полевые коды появляются между кудрявыми брекетами ( { } Использовать DocumentBuilder.insertField Создание полей в документе. Вам нужно указать тип поля, код поля и значение поля. Если вы не уверены в конкретном синтаксисе кода поля, создайте поле в Microsoft Word Сначала переключитесь, чтобы увидеть код поля Следующий пример кода вставляет поле слияния в документ с использованием DocumentBuilder.

Вставить `Form` поле

Поля форм представляют собой особый случай полей Word, который позволяет “взаимодействовать” с пользователем. Форма поля в Microsoft Word К ним относятся текстовый ящик, Combobox и чекбокс. DocumentBuilder предоставляет специальные методы для вставки каждого типа поля формы в документ: DocumentBuilder.insertTextInput , DocumentBuilder.insertCheckBox, и DocumentBuilder.insertComboBox. Обратите внимание, что если указать имя поля формы, то закладка автоматически создается с таким же названием.

Вставить текстовый вход

DocumentBuilder.insertTextInput для вставки текстового ящика в документ. Следующий пример кода показывает, как вставить поле формы ввода текста в документ.

Вставить `CheckBox`

Вызов DocumentBuilder.insert CheckBox вставляет флажок в документ. Следующий пример кода показывает, как вставить поле формы флажка в документ.

Вставить комбо-бокс

Вызов DocumentBuilder.insertComboBox Вставить в документ комбо-бокс. Следующий пример кода показывает, как вставить поле формы комбо-бокса в документ.

Вставка локализации на уровне поля

Клиенты могут указать Локализуйтесь на уровне поля сейчас и сможете добиться лучшего контроля. местность Иды могут быть связаны с каждым полем внутри DocumentBuilder. Приведенные ниже примеры иллюстрируют, как использовать этот вариант.

Вставка HTML

Вы можете легко вставить строку HTML, которая содержит фрагмент HTML или весь HTML-документ в документ Word. Просто передайте эту строку конструктору документов. вставить Метод Html. Одной из полезных реализаций метода является хранение HTML-струны в базе данных и вставка ее в документ во время mail merge Добавить отформатированный контент вместо того, чтобы строить его с помощью различных методов конструктора документов. Следующий пример кода показывает вставки HTML в документ с помощью DocumentBuilder.

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

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

Вставить таблицу содержимого

Вы можете вставить TOC (таблица содержания) поле в документе на текущей позиции по вызову DocumentBuilder.insertTableOfContents метод. Метод DocumentBuilder.insertTableOfContents включает в себя TOC поле в документе. Чтобы построить таблицу содержимого и отобразить их в соответствии с номерами страниц, оба Document.UpdateFieldsМетод должен быть назван после вставки поля. Следующий пример кода показывает, как вставить поле “Таблица содержимого” в документ.

Вставка Ole Object

Если вам нужен Ole Object DocumentBuilder.insertOleObjectAsIcon.

Установите имя файла и расширение при вставке Ole Object

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

Получить доступ к OLE Object Raw Data

Следующий пример кода показывает, как получить OLE Объектные необработанные данные с использованием OleFormat.GetRawData() метод.

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

Следующий пример кода показывает, как вставить горизонтальную форму правила в документ, используя DocumentBuilder.InsertHorizontalRule метод.

Работа с формами

Встраивание встроенных и свободно плавающих форм

Вы можете вставить встроенную форму с определенным типом и размером и свободно плавающую форму с указанным положением, размером и типом текстовой обертки в документ, используя DocumentBuilder.InsertShape метод. The DocumentBuilder.InsertShape Способ позволяет вставить форму DML в модель документа. Документ должен быть сохранен в формате, поддерживающем формы DML, иначе такие узлы будут преобразованы в форму VML, при этом сохраняется документ. Следующий пример кода показывает, как вставить эти типы фигур в документ.

Создайте прямоугольник Snip Corner

Вы можете создать угловой прямоугольник с помощью Aspose.Words. Типы фигур: SingleCornerSnipped, TopCornersSnipped, DiagonalCornersSnipped, TopCornersOneRounded OneSnipped, SingleCornerRounded, TopCornersRounded и DiagonalCornersRounded. Форма DML создается с использованием DocumentBuilder.InsertShape Метод с этими типами форм. Эти типы не могут быть использованы для создания форм VML. Попытка создать форму с помощью общественного конструктора класса “Форма” поднимает исключение “Неподдерживаемый Исключение”. Следующий пример кода показывает, как вставить эти типы фигур в документ.

Импорт форм с помощью Math XML в виде форм DOM

Вы можете использовать LoadOptions.ConvertShapeToOfficeMath свойство преобразовывать формы с помощью EquationXML в объекты Office Math. Значение по умолчанию этого свойства соответствует поведению MS Word, т.е. формы с уравнением XML не преобразуются в объекты математики Office.

Навигация с помощью Cursor in Java Использовать `DocumentBuilder` Изменить документ