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

代表一个文本型窗体域。

说明

使用 FormFields(Index) 可返回一个 FormField 对象，其中 Index 是与文本型窗体域或索引号相关联的书签名称。使用 TextInput 属性和 FormField 对象可返回一个 TextInput 对象。以下示例删除活动文档中名为“Text1”的文本型窗体域的内容。

示例代码 
ActiveDocument.FormFields.Item("Text1").TextInput.Clear()

索引号代表窗体域在 FormFields 集合中的位置。以下示例检查活动文档中第一个窗体域的类型。如果该窗体域是文本型窗体域，则该示例将“Mission Critical”设置为该域的值。

示例代码 
if(ActiveDocument.FormFields.Item(1).Type == wdFieldFormTextInput){
    ActiveDocument.FormFields.Item(1).Result = "Mission Critical"
}

以下示例确定 ffield 变量在设置为默认的文本以前，是否在活动文档中代表一个有效的文本型窗体域。

示例代码 
let ffield = ActiveDocument.FormFields.Item(1).TextInput

if(ffield.Valid == true){
    ffield.Default = "Type your name here"
}
else{
    MsgBox("First field is not a text box")
}

使用 Add 方法和 FormFields 对象可添加一个文本型窗体域。以下示例在活动文档的开始处添加文本型窗体域，然后将该窗体域的名称设置为“FirstName”。

示例代码 
let ffield = ActiveDocument.FormFields.Add(ActiveDocument.Range(0, 0), wdFieldFormTextInput)
ffield.Name = "FirstName"


请参阅