Aspose::Words::DocumentBuilder::InsertTextInput method

DocumentBuilder::InsertTextInput method

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

System::SharedPtr<Aspose::Words::Fields::FormField> Aspose::Words::DocumentBuilder::InsertTextInput(const System::String &name, Aspose::Words::Fields::TextFormFieldType type, const System::String &format, const System::String &fieldValue, int32_t maxLength)
ПараметрТипОписание
nameconst System::String&Имя текстового поля формы. Может быть пустой строкой.
типAspose::Words::Fields::TextFormFieldTypeУказывает тип текстового поля формы.
форматconst System::String&Строка формата, используемая для форматирования значения текстового поля формы.
fieldValueconst System::String&Текст, который будет отображаться в поле.
maxLengthint32_tМаксимальная длина, которую пользователь может ввести в текстовое поле формы. Установите 0 для неограниченной длины.

ReturnValue

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

Примечания

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

Примеры

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

auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>();

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

// 2 -  Выпадающий список с подсказкой и диапазоном возможных значений:
System::ArrayPtr<System::String> items = System::MakeArray<System::String>({u"-- Select your favorite footwear --", u"Sneakers", u"Oxfords", u"Flip-flops", u"Other"});

builder->InsertParagraph();
builder->InsertComboBox(u"My combo box", items, 0);

builder->get_Document()->Save(get_ArtifactsDir() + u"DocumentBuilder.CreateForm.docx");

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

auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);

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

doc->Save(get_ArtifactsDir() + u"DocumentBuilder.InsertTextInput.docx");

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

auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);

builder->Write(u"Please enter text here: ");

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

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

См. также

Aspose::Words::DocumentBuilder::InsertTableOfContents method Метод Aspose::Words::DocumentBuilder::Is