InsertCheckBox

InsertCheckBox(string, bool, int)

在当前位置插入复选框表单字段。

public FormField InsertCheckBox(string name, bool checkedValue, int size)
范围类型描述
nameString表单字段的名称。可以是空字符串。超过 20 个字符的值将被截断。
checkedValueBoolean已检查复选框表单字段的状态。
sizeInt32指定复选框的大小（以磅为单位）。为 MS Word 指定 0 以自动计算复选框的大小。

返回值

刚刚插入的表单字段节点。

评论

如果您为表单字段指定名称，则会自动创建同名的书签。

例子

演示如何将复选框插入到文档中。

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

// 插入不同大小和默认选中状态的复选框。
builder.Write("Unchecked check box of a default size: ");
builder.InsertCheckBox(string.Empty, false, false, 0);
builder.InsertParagraph();

builder.Write("Large checked check box: ");
builder.InsertCheckBox("CheckBox_Default", true, true, 50);
builder.InsertParagraph();

// 表单字段的名称长度限制为 20 个字符。
builder.Write("Very large checked check box: ");
builder.InsertCheckBox("CheckBox_OnlyCheckedValue", true, 100);

Assert.AreEqual("CheckBox_OnlyChecked", doc.Range.FormFields[2].Name);

// 我们可以通过双击 Microsoft Word 中的这些复选框进行交互。
doc.Save(ArtifactsDir + "DocumentBuilder.InsertCheckBox.docx");

也可以看看

InsertCheckBox(string, bool, bool, int)

在当前位置插入复选框表单字段。

public FormField InsertCheckBox(string name, bool defaultValue, bool checkedValue, int size)
范围类型描述
nameString表单字段的名称。可以是空字符串。超过 20 个字符的值将被截断。
defaultValueBoolean复选框表单字段的默认值。
checkedValueBoolean复选框表单字段的当前选中状态。
sizeInt32指定复选框的大小（以磅为单位）。为 MS Word 指定 0 以自动计算复选框的大小。

返回值

刚刚插入的表单字段节点。

评论

如果您为表单字段指定名称，则会自动创建同名的书签。

例子

演示如何将复选框插入到文档中。

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

// 插入不同大小和默认选中状态的复选框。
builder.Write("Unchecked check box of a default size: ");
builder.InsertCheckBox(string.Empty, false, false, 0);
builder.InsertParagraph();

builder.Write("Large checked check box: ");
builder.InsertCheckBox("CheckBox_Default", true, true, 50);
builder.InsertParagraph();

// 表单字段的名称长度限制为 20 个字符。
builder.Write("Very large checked check box: ");
builder.InsertCheckBox("CheckBox_OnlyCheckedValue", true, 100);

Assert.AreEqual("CheckBox_OnlyChecked", doc.Range.FormFields[2].Name);

// 我们可以通过双击 Microsoft Word 中的这些复选框进行交互。
doc.Save(ArtifactsDir + "DocumentBuilder.InsertCheckBox.docx");

也可以看看

DocumentBuilder.InsertChart DocumentBuilder.InsertComboBox