WPS 加载项开发 > 文字 API 参考 > CheckBox > CheckBox 对象

代表一个复选框窗体域。

说明

使用 FormFields(Index) 返回单个 FormField 对象（其中 Index 是与复选框关联的索引编号或书签名称）。可将 CheckBox 属性与 FormField 对象配合使用，返回 CheckBox 对象。以下示例从活动文档中选择名为“Check1”的复选框窗体域。

示例代码 
ActiveDocument.FormFields.Item("Check1").CheckBox.Value = true

索引编号代表窗体域在 FormFields 集合中的位置。以下示例检查第一个窗体域的类型，如果是复选框，则选中该复选框。

示例代码 
if(ActiveDocument.FormFields.Item(1).Type == wdFieldFormCheckBox){
    ActiveDocument.FormFields.Item(1).CheckBox.Value = true
}

以下示例先判断 ffield 对象是否有效，然后再将复选框大小修改为 14 磅。

示例代码 
let ffield = ActiveDocument.FormField.Item(1).CheckBox
if(ffield.Valid == true){ 
    ffield.AutoSize = false
    ffield.Size = 14
}
else {
    MsgBox("First field is not a check box")
}

可将 Add 方法与 FormFields 对象配合使用，添加一个复选框窗体域。以下示例在活动文档的开头添加一个复选框，并将其命名为“Color”，然后选定该复选框。

示例代码 
let rng = ActiveDocument.FormFields.Add(ActiveDocument.Range(0,0),wdFieldFormCheckBox)
rng.Name = "Color"
rng.CheckBox.Value = true


请参阅