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);

// 表单字段将以“input”html标签的形式出现，类型为“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