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

Существует несколько способов вставить поля в документ:

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

Вставка полей в документ с помощью DocumentBuilder

В Aspose.Words тот insert_field Метод используется для вставки новых полей в документ. Первый параметр принимает полный код поля, подлежащего вставке. Второй параметр является необязательным и позволяет задавать результат поля вручную. Если это не предусмотрено, то поле обновляется автоматически. Вы можете передать нуль или пустой к этому параметру, чтобы вставить поле с пустым значением поля. Если вы не уверены в конкретном синтаксисе кода поля, создайте поле в Microsoft Word Сначала переключитесь, чтобы увидеть код поля.

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

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

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

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

Укажите местоположение на уровне поля

Идентификатор языка является стандартной международной цифровой аббревиатурой языка в стране или географическом регионе. с Aspose.Words, Вы можете указать Локально на уровне поля. The locale_id Имущество получает или устанавливает локальный идентификатор поля.

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

Вставить нетипированное/пустое поле

Если вы хотите вставить незапечатанные/пустые поля{}) просто как Microsoft Word позволяет, вы можете использовать insert_field метод с помощью FieldType.FIELD_NONE параметр. Чтобы вставить поле в документ Word, можно нажать комбинацию клавиш “Ctrl + F9”.

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

Вставка полей в документ с помощью FieldBuilder

Альтернативный способ вставить поля в Aspose.Words Это FieldBuilder класс. Он обеспечивает свободный интерфейс для указания переключателей полей и значений аргументов в виде текста, узлов или даже вложенных полей.

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

Вставка полей с использованием DOM

Вы также можете вставлять различные типы полей, используя Aspose.Words Document Object Model (DOM). В этом разделе мы рассмотрим несколько примеров.

Включить слияние Поле в документе с использованием DOM

The MERGEFIELD поле в документе Word может быть представлено FieldMergeField класс. Вы можете использовать FieldMergeField класс для выполнения следующих операций:

  • указать название поля слияния
  • указать форматирование поля слияния
  • указать текст, который находится между разделителем поля и концом поля поля слияния поля
  • указать текст, который должен быть вставлен после поля слияния, если поле не является пустым
  • указать текст, который следует вставить перед полем слияния, если поле не является пустым

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

Вставка Mail Merge ADDRESSBLOCK поле в документ, использующий DOM

The ADDRESSBLOCK поле используется для вставки mail merge Блок адресов в документе Word. ADDRESSBLOCK поле в документе Word может быть представлено FieldAddressBlock класс. Вы можете использовать FieldAddressBlock класс для выполнения следующих операций:

  • указать, следует ли включать название страны/региона в поле;
  • указать, форматировать ли адрес в соответствии со страной/регионом получателя, как определено POST*CODE (Universal Postal Union 2006)
  • указать название исключенной страны/региона
  • указать название и формат адреса
  • указать идентификатор языка, используемый для форматирования адреса

Следующий пример кода показывает, как добавить Mail Merge ADDRESSBLOCK Полевое использование DOM к пункту в документе:

Вставка ADVANCE полей в Документ без использования DocumentBuilder

The ADVANCE Поле используется для смещения последующего текста в строке слева, справа, вверх или вниз. The ADVANCE поле в документе Word может быть представлено FieldAdvance класс. Вы можете использовать FieldAdvance класс для выполнения следующих операций:

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

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

Вставка ASK полей в Документ без использования DocumentBuilder

The ASK Поле используется для того, чтобы побудить пользователя присвоить текст закладке в документе Word. ASK поле в документе Word может быть представлено FieldAsk класс. Вы можете использовать FieldAsk класс для выполнения следующих операций:

  • указать название закладки
  • указать ответ пользователя по умолчанию (первоначальное значение, содержащееся в окне подсказки)
  • указать, должен ли ответ пользователя быть получен один раз за mail merge операция
  • указать текст запроса (заголовок окна запроса)

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

Вставка AUTHOR полей в Документ без использования DocumentBuilder

The AUTHOR поле используется для указания имени автора документа из Document свойств. The AUTHOR поле в документе Word может быть представлено FieldAuthor класс. Вы можете использовать FieldAuthor класс для выполнения следующих операций:

  • указать имя автора документа

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

Вставка INCLUDETEXT полей в Документ без использования DocumentBuilder

The INCLUDETEXT поле вставляет текст и графику, содержащиеся в документе, названном в коде поля. Вы можете вставить весь документ или часть документа, на которую ссылается закладка. Это поле в документе Word представлено INCLUDETEXT. Вы можете использовать FieldIncludeText класс для выполнения следующих операций:

  • указать название закладки включенного документа
  • указать местонахождение документа

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

Вставка TOA полей в Документ без использования DocumentBuilder

The TOA (* Таблица полномочий*) поле строит и вставляет таблицу полномочий. The TOA поле собирает записи, отмеченные TA (*Table of Authorities Entry*) поля. Microsoft Office Word вставляет TOA поле, когда вы нажимаете *Вставить таблицу полномочий* в **Таблица полномочий** группа на **References** вкладка. Когда вы смотрите на TOA Поле в вашем документе, синтаксис выглядит так:

{ TOA [Switches ] }

Вы можете использовать FieldToa класс для выполнения операций с TOA поле.

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