InsertTextInput

DocumentBuilder.InsertTextInput method

Вставляет поле текстовой формы в текущую позицию.

public FormField InsertTextInput(string name, TextFormFieldType type, string format, 
    string fieldValue, int maxLength)
ПараметрТипОписание
nameStringИмя поля формы. Может быть пустой строкой.
typeTextFormFieldTypeУказывает тип поля текстовой формы.
formatStringСтрока формата, используемая для форматирования значения поля формы.
fieldValueStringТекст, который будет отображаться в поле.
maxLengthInt32Максимальная длина, которую пользователь может ввести в поле формы. Установите ноль для неограниченной длины.

Возвращаемое значение

Узел поля формы, который был только что вставлен.

Примечания

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

Примеры

Показывает, как вставить поле формы ввода текста в документ.

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

// Вставьте форму, предлагающую пользователю ввести текст.
builder.InsertTextInput("TextInput", TextFormFieldType.Regular, "", "Enter your text here", 0);

doc.Save(ArtifactsDir + "DocumentBuilder.InsertTextInput.docx");

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

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

builder.Write("Please enter text here: ");

// Вставьте поле ввода текста, которое позволит пользователю щелкнуть и ввести текст.
// Назначьте некоторый текст-заполнитель, который пользователь может перезаписать и передать
// максимальная длина текста 0, чтобы не накладывать ограничений на содержимое поля формы.
builder.InsertTextInput("TextInput1", TextFormFieldType.Regular, "", "Placeholder text", 0);

// Поле формы будет отображаться в виде HTML-тега «input» с типом «text».
doc.Save(ArtifactsDir + "FormFields.TextInput.html");

Показывает, как создавать поля формы.

DocumentBuilder builder = new DocumentBuilder();

// Поля формы — это объекты в документе, с которыми пользователь может взаимодействовать, получая запросы на ввод значений.
// Мы можем создать их с помощью конструктора документов, и ниже приведены два способа сделать это.
// 1 - Основной ввод текста:
builder.InsertTextInput("My text input", TextFormFieldType.Regular, 
    "", "Enter your name here", 30);

// 2 — Поле со списком с текстом подсказки и диапазоном возможных значений:
string[] items =
{
    "-- Select your favorite footwear --", "Sneakers", "Oxfords", "Flip-flops", "Other"
};

builder.InsertParagraph();
builder.InsertComboBox("My combo box", items, 0);

builder.Document.Save(ArtifactsDir + "DocumentBuilder.CreateForm.docx");

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

DocumentBuilder.InsertTableOfContents DocumentBuilder.MoveTo