Работа с полями формы

Документ, содержащий заполняемые поля, называется формой. Например, в Microsoft Word можно создать регистрационную форму, в которой используются раскрывающиеся списки, из которых пользователи могут выбирать записи. Поле Form - это место, где хранятся данные определенного типа, такие как имя или адрес. Поля формы в Microsoft Word включают ввод текста, combobox и checkbox.

Вы можете использовать поля формы в своем проекте для “общения” с пользователями. Например, вы создаете документ, содержимое которого защищено, но доступны для редактирования только поля формы. Пользователи могут вводить данные в поля формы и отправлять документ. Ваше приложение, использующее Aspose.Words, может извлекать данные из полей формы и обрабатывать их.

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

Вставка полей формы

Поля формы являются частным случаем полей Word, которые позволяют “взаимодействовать” с пользователем. Поля формы в Microsoft Word включают текстовое поле, поле со списком и checkbox.

DocumentBuilder

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

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

Используйте метод insertTextInput, чтобы вставить текстовое поле в документ.

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

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

Вызовите insertCheckBox, чтобы вставить checkbox в документ.

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

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

Вызовите insertComboBox, чтобы вставить combobox в документ.

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

Получение полей формы

Набор полей формы представлен классом FormFieldCollection, который можно получить с помощью свойства Range.getFormFields. Это означает, что вы можете получить поля формы, содержащиеся в любом узле документа, включая сам документ.

В следующем примере кода показано, как получить набор полей формы:

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

В следующем примере кода показано, как получить доступ к полям формы:

Свойства FormField позволяют вам работать с именем, типом и результатом поля формы.

В следующем примере кода показано, как работать с именем, типом и результатом поля формы: