FormField

FormField class

Представляет одно поле формы.

public class FormField : SpecialChar

Характеристики

Имя Описание
CalculateOnExit { get; set; } Истинно, если ссылки на указанное поле формы автоматически обновляются при выходе из поля.
CheckBoxSize { get; set; } Получает или задает размер флажка в пунктах. Имеет эффект только тогда, когдаIsCheckBoxExactSize верно.
Checked { get; set; } Получает или задает проверенный статус поля формы флажка. Значение по умолчанию для этого свойства: ЛОЖЬ .
CustomNodeId { get; set; } Указывает идентификатор пользовательского узла.
Default { get; set; } Получает или задает значение по умолчанию для поля формы флажка. Значение по умолчанию для этого свойства: ЛОЖЬ .
virtual Document { get; } Получает документ, которому принадлежит этот узел.
DropDownItems { get; } Предоставляет доступ к элементам поля раскрывающейся формы.
DropDownSelectedIndex { get; set; } Получает или задает индекс, определяющий текущий выбранный элемент в поле раскрывающейся формы.
Enabled { get; set; } Истинно, если поле формы включено.
EntryMacro { get; set; } Возвращает или задает имя макроса ввода для поля формы.
ExitMacro { get; set; } Возвращает или задает имя макроса выхода для поля формы.
Font { get; } Предоставляет доступ к форматированию шрифта этого объекта.
HelpText { get; set; } Возвращает или задает текст, отображаемый в окне сообщения, когда поле формы находится в фокусе и пользователь нажимает F1.
IsCheckBoxExactSize { get; set; } Получает или задает логическое значение, указывающее, является ли размер текстового поля автоматическим или заданным явно.
virtual IsComposite { get; } Возвращает true, если этот узел может содержать другие узлы.
IsDeleteRevision { get; } Возвращает значение true, если этот объект был удален в Microsoft Word при включенном отслеживании изменений.
IsFormatRevision { get; } Возвращает значение true, если форматирование объекта было изменено в Microsoft Word при включенном отслеживании изменений.
IsInsertRevision { get; } Возвращает значение true, если этот объект был вставлен в Microsoft Word при включенном отслеживании изменений.
IsMoveFromRevision { get; } Возвращает истинный если этот объект был перемещен (удален) в Microsoft Word при включенном отслеживании изменений.
IsMoveToRevision { get; } Возвращает истинный если этот объект был перемещен (вставлен) в Microsoft Word при включенном отслеживании изменений.
MaxLength { get; set; } Максимальная длина текстового поля. Ноль, если длина не ограничена.
Name { get; set; } Получает или задает имя поля формы.
NextSibling { get; } Получает узел, следующий сразу за этим узлом.
override NodeType { get; } Возвращает NodeType.FormField .
OwnHelp { get; set; } Указывает источник текста, отображаемого в окне сообщения, когда поле формы находится в фокусе и пользователь нажимает F1.
OwnStatus { get; set; } Указывает источник текста, отображаемого в строке состояния, когда поле формы находится в фокусе.
ParentNode { get; } Получает непосредственного родителя этого узла.
ParentParagraph { get; } Извлекает родителяParagraph этого узла.
PreviousSibling { get; } Получает узел, непосредственно предшествующий этому узлу.
Range { get; } Возвращает Диапазон объект, представляющий часть документа, содержащегося в этом узле.
Result { get; set; } Получает или задает строку, представляющую результат этого поля формы.
StatusText { get; set; } Возвращает или задает текст, отображаемый в строке состояния, когда поле формы находится в фокусе.
TextInputDefault { get; set; } Получает или задает строку по умолчанию или выражение вычисления поля текстовой формы.
TextInputFormat { get; set; } Возвращает или задает форматирование текста для поля текстовой формы.
TextInputType { get; set; } Получает или задает тип поля текстовой формы.
Type { get; } Возвращает тип поля формы.

Методы

Имя Описание
override Accept(DocumentVisitor) Принимает посетителя.
Clone(bool) Создает дубликат узла.
GetAncestor(NodeType) Получает первого предка указанногоNodeType .
GetAncestor(Type) Получает первого предка указанного типа объекта.
override GetText() Получает специальный символ, который представляет этот узел.
NextPreOrder(Node) Получает следующий узел в соответствии с алгоритмом обхода дерева предварительного порядка.
PreviousPreOrder(Node) Получает предыдущий узел в соответствии с алгоритмом обхода дерева предварительного порядка.
Remove() Удаляет себя из родителя.
RemoveField() Удаляет все поле формы, а не только специальный символ поля формы.
SetTextInputValue(object) Применяет текстовый формат, указанный вTextInputFormat и сохраняет значение вResult .
ToString(SaveFormat) Экспортирует содержимое узла в строку в указанном формате.
ToString(SaveOptions) Экспортирует содержимое узла в строку, используя указанные параметры сохранения.

Примечания

Microsoft Word предоставляет следующие поля формы: флажок, ввод текста и раскрывающийся список (поле со списком).

FormField является встроенным узлом и может быть только потомком Параграф.

FormField представлен в документе специальным символом и расположен как символ в строке текста.

Полное поле формы в документе Word представляет собой сложную структуру, представленную несколькими узлами : начало поля, код поля, такой как FORMTEXT, данные поля формы, разделитель полей, результат поля , конец поля и закладка. Для программного создания полей формы в документе Word используйте DocumentBuilder.InsertCheckBox , DocumentBuilder.InsertTextInput и DocumentBuilder.InsertComboBox which убедитесь, что все узлы полей формы созданы в правильном порядке и в подходящем состоянии.

Примеры

Показывает, как форматировать весь FormField, включая значение поля.

Document doc = new Document(MyDir + "Form fields.docx");

FormField formField = doc.Range.FormFields[0];
formField.Font.Bold = true;
formField.Font.Size = 24;
formField.Font.Color = Color.Red;

formField.Result = "Aspose.FormField";

doc = DocumentHelper.SaveOpen(doc);

Run formFieldRun = doc.FirstSection.Body.FirstParagraph.Runs[1];

Assert.AreEqual("Aspose.FormField", formFieldRun.Text);
Assert.AreEqual(true, formFieldRun.Font.Bold);
Assert.AreEqual(24, formFieldRun.Font.Size);
Assert.AreEqual(Color.Red.ToArgb(), formFieldRun.Font.Color.ToArgb());

Показывает, как вставить поле со списком.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Write("Please select a fruit: ");

// Вставьте поле со списком, которое позволит пользователю выбрать вариант из набора строк.
FormField comboBox = builder.InsertComboBox("MyComboBox", new[] { "Apple", "Banana", "Cherry" }, 0);

Assert.AreEqual("MyComboBox", comboBox.Name);
Assert.AreEqual(FieldType.FieldFormDropDown, comboBox.Type);
Assert.AreEqual("Apple", comboBox.Result);

// Поле формы появится в виде html-тега select.
doc.Save(ArtifactsDir + "FormFields.Create.html");

Смотрите также