11.1Windows控件

Window常用控件主要包括文本框、下拉框、列表框和复选框。

11.1.1文本框

文本框是提供用户输入或显示文本信息的工具。在基本绘图工具条中选择文本框控件，然后在图形窗口中拖动即可绘制一个文本编辑框。

1. 文本框使用配置

在其属性页-属性中包括元件、控制字、外观和文本框配置几个属性项。

• 名称：必配置项， 访问文本框时的唯一标识。
• 控制字-允许在脚本中控制：需要运行态设置文本框属性时，必须启用该功能。
• 文本框配置：
• 对齐方式：文本框内字符串对齐方式，下拉框选择左对齐、右对齐和中间对齐。
• 文本颜色：文本框内显示字符串颜色。
• 文本字体：文本框内显示字符串的字体。
• 输入框类型：文本框特殊应用设置，可选项包括：
• 普通输入框：响应用户输入任何字符串，可设置文本框内字符串是否可编辑，文本框内字符串是否自动换行显示。
• 正则表达式验证输入框：限制只允许用户输入验证正则表达式的值。
• 密码输入框：将用户输入的字符以“*”方式显示。
• IP地址输入框：以IP地址的格式分节输入数值，并做校验。
• 整数输入框：限制只允许用户输入整型数值。可设置被限制的整型数值区间。

• 浮点数输入框：限制只允许用户输入浮点类型数值，可设置被限制的浮点型数值区间。

• 文本框访问

系统提供访问文本框的一组专用脚本函数，调用格式为：元件名称.函数。

getText

语法：string object.getText()

参数：无

返回值：文本框的当前内容

备注说明：返回文本框的内容，结果为字符串型

示例：text.getText() 获得text文本框的内容，“text”为用户定义的文本框控件名称。

setText

语法：object.setText(string item)

参数：string item，需要设置到文本框的内容

返回值：无

备注说明：设置文本框的内容显示为指定的字符串

示例：text.setText(“this is a textbox”) 设置text文本框的内容，“text”为用户定义的文本框控件名称。

TextLoad

语法：object.TextLoad(String srcDir )

参数：String srcDir，文件地址

返回值：无

备注说明：设置文本框中显示指定文本文件的内容

示例：text.TextLoad(“C:/Document/111.txt”) 设置text文本框显示111.txt文本中的内容，“text”为用户定义的文本框控件名称。

TextSave

语法：object.TexSave(String srcDir )

参数：String srcDir，文件地址

返回值：无

备注说明：保存文本框中的内容到指定的文本文件

示例：text.TextSave(“C:/Document/111.txt”) 保存text文本框的内容到111.txt文本中，“text”为用户定义的文本框控件名称。

1. 文本框驱动

属性页-驱动中包括几项配置文本框信息显示的功能驱动。

1. 文本框事件

2. 内容改变事件：事件以系统脚本的形式配置。当文本框内输入的字符串内容发生改变时，触发执行事件配置的脚本代码。

注意：文本框内容改变以用户输入的回车为结束标志。

• 元件定时器事件：事件以系统脚本形式配置。当时间达到脚本执行周期时，触发事件中配置的脚本代码。

11.1.2下拉框

下拉框是由文本框与列表框组合而成。列表框中可以显示多行文本，每行即为下拉框的下拉成员选项，选中下拉框中某一个成员项后，当前选项就在文本框中显示。下拉框同一时刻只能显示一个成员项。

在基本绘图工具条中选择下拉框控件，然后在图形窗口中拖动即可绘制一个下拉框。

1. 下拉框使用配置

下拉框属性中包括元件、控制字、外观、初始化和数据绑定配置几项。

• 名称：必配置项， 访问下拉框时的唯一标识。
• 控制字-允许在脚本中控制：需要运行态设置下拉框属性时，必须启用该功能；
• 初始化内容：用户可以在编辑态下指定下拉框初始显示的列表成员。双击“初始化内容”选项，弹出多行文本输入窗口，每个列表成员项单独一行。

• 数据绑定：下拉框可以配合数据源控件完成特殊需求的组态实现，下拉框中的下拉项是数据源中的所有数据记录。详细配合使用方法请参考数据源控件章节。

• 下拉框访问

系统提供访问下拉框的一组专用脚本函数，调用格式为：元件名称.函数；

getSelectIndex

语法：int object.getSelectIndex()

参数：无

返回值：下拉框已选择的成员ID

备注说明：返回下拉框已选择项的ID，从0开始

示例：commbox.getSelectIndex() “commbox”为用户已定义的控件名称

getSelectValue

语法： object.getSelectValue()

参数：无

返回值：下拉框或列表框选择的数据值

备注说明：方法只适用于绑定了模拟量数据集的下拉框或列表框，将根据关联的“数据字段”获得返回值的类型和值

示例：commbox.getSelectValue() “commbox”为用户已定义的控件名称

getSelectText

语法：string object.getSelectText()

参数：无

返回值：下拉框选项的内容

备注说明：返回下拉框选择项的内容，结果为字符串

示例：commbox.getSelectText() “commbox”为用户已定义的控件名称

setSelectedIndex

语法： object.setSelectedIndex(index)

参数：int index 下拉框选项序号，由0开始；

返回值：无

备注说明： 设置下拉框/列表框的被选择项。调用方法特殊，请参考示例。

示例：commbox.GetComp().setSelectedIndex(2); “commbox”为用户已定义的控件名称

addItem

语法：object. addItem(String Item)

参数：String Item，选项内容

返回值：无

备注说明：添加指定成员项到下拉框或者列表框中

示例：commbox. addItem(“选项一”) “commbox”为用户已定义的控件名称

listbox.addItem(“选项一”) “listbox”为用户已定义的控件名称

deleteItem

语法：object.deleteItem(int Index)

参数：int Index，所要删除的下拉框（列表框）中成员项的ID号

返回值：无

备注说明：删除下拉框（列表框）中某一成员项，成员项的ID号从0开始

示例：commbox. deleteItem (1) “commbox”为用户已定义的控件名称

clear

语法：object.clear()

参数：无

返回值：无

备注说明：删除下拉框（列表框）中所有成员项。

示例：commbox. clear () “commbox”为用户已定义的控件名称

Load

语法： object.Load(String srcDir )

参数：String srcDir，文件地址

返回值：无

备注说明：设置下拉框（列表框）中显示指定文本文件的内容（该文本文件必须为CyberControl系统Save函数保存的指定格式）

示例：commbox.Load(“C:/Document/111.txt”)

Save

语法： object.Save(String srcDir )

参数：String srcDir，文件地址

返回值：无

备注说明：保存下拉框（列表框）中的内容到指定文本文件。

示例：commbox.Save(“C:/Document/111.txt”)

1. 下拉框驱动

提供对象绑定驱动，效果等同于属性页中数据绑定功能。

1. 下拉框事件

属性页-事件中包括“选项改变”和“元件加载”脚本事件。

• 选项改变事件：系统以脚本方式配置，当用户选择下拉框选项发生变化时触发脚本配置代码。
• 元件加载事件：系统以脚本方式配置。下拉框控件存储在窗口图形内，当窗口图形打开时将加载所有图元控件，此时触发该事件配置的脚本代码。

注意：下拉框初始化显示第一个选项，当用户初始仍选择第一个选项时，不作为选项改变处理。

• 元件定时器事件：事件以系统脚本形式配置。当时间达到脚本执行周期时，触发事件中配置的脚本代码。

11.1.3列表框

列表框中可以显示多行文本，每行即为列表框的成员选项。列表框同时显示所有成员项。

在基本绘图工具条中选择列表框控件，然后在图形窗口中拖动即可绘制一个列表框。

1. 列表框使用配置

列表框属性中包括元件、控制字、外观、控件风格、初始化和数据绑定配置几项。

• 名称：必配置项， 访问列表框时的唯一标识。
• 控制字-允许在脚本中控制：需要运行态设置列表框属性时，必须启用该功能；
• 初始化内容：用户可以在编辑态下指定列表框初始显示的列表成员。双击“初始化内容”选项，弹出多行文本输入窗口，每个列表成员项单独一行。

• 复选框：允许用户在列表成员项内同时选择几个成员，必须启用该功能。

• 数据绑定：列表框可以配合数据源控件完成特殊需求的组态实现，列表框中的列表项是数据源中的所有数据记录。详细配合使用方法请参考数据源控件章节。

• 列表框访问

系统提供访问列表框的一组专用脚本函数，调用格式为：元件名称.函数；

getSelectIndex

语法：int object.getSelectIndex()

参数：无

返回值：下拉框/列表框已选择的成员ID

备注说明：返回下拉框/列表框已选择项的ID，从0开始

示例：listbox.getSelectIndex() “listbox”为用户已定义的控件名称

getSelectValue

语法： object.getSelectValue()

参数：无

返回值：下拉框或列表框选择的数据值

备注说明：方法只适用于绑定了模拟量数据集的下拉框或列表框，将根据关联的“数据字段”获得返回值的类型和值

示例：commbox.getSelectValue() “commbox”为用户已定义的控件名称

getSelectText

语法：string object.getSelectText()

参数：无

返回值：下拉框/列表框选项的内容

备注说明：返回下拉框/列表框选择项的内容，结果为字符串

示例：commbox.getSelectText() “commbox”为用户已定义的控件名称

setSelectedIndex

语法： object.setSelectedIndex(index)

参数：int index 下拉框/列表框选项序号，由0开始；

返回值：无

备注说明： 设置下拉框/列表框的被选择项。调用方法特殊，请参考示例。

示例：commbox.GetComp().setSelectedIndex(2); “commbox”为用户已定义的控件名称

addItem

语法：object. addItem(String Item)

参数：String Item，选项内容

返回值：无

备注说明：添加指定成员项到下拉框或者列表框中

示例：commbox. addItem(“选项一”) “commbox”为用户已定义的控件名称

listbox.addItem(“选项一”) “listbox”为用户已定义的控件名称

deleteItem

语法：object.deleteItem(int Index)

参数：int Index，所要删除的下拉框（列表框）中成员项的ID号

返回值：无

备注说明：删除下拉框（列表框）中某一成员项，成员项的ID号从0开始

示例：commbox. deleteItem (1) “commbox”为用户已定义的控件名称

clear

语法：object.clear()

参数：无

返回值：无

备注说明：删除下拉框（列表框）中所有成员项。

示例：commbox. clear () “commbox”为用户已定义的控件名称

Load

语法： object.Load(String srcDir )

参数：String srcDir，文件地址

返回值：无

备注说明：设置下拉框（列表框）中显示指定文本文件的内容（该文本文件必须为CyberControl系统Save函数保存的指定格式）

示例：commbox.Load(“C:/Document/111.txt”)

Save

语法： object.Save(String srcDir )

参数：String srcDir，文件地址

返回值：无

备注说明：保存下拉框（列表框）中的内容到指定文本文件。

示例：commbox.Save(“C:/Document/111.txt”)

1. 列表框驱动

无。

1. 列表框事件

属性页-事件中包括“选项改变”、“元件加载”和”鼠标双击条目”脚本事件。

• 选项改变事件：系统以脚本方式配置，当用户选择列表框选项发生变化时触发脚本配置代码；
• 元件加载事件：系统以脚本方式配置。列表框控件存储在窗口图形内，当窗口图形打开时将加载所有图元控件，此时触发该事件配置的脚本代码。

注意：下拉框初始化显示第一个选项，当用户初始仍选择第一个选项时，不作为选项改变处理。

• 鼠标双击条目事件：系统以脚本方式配置。鼠标双击列表框成员项时触发该时间配置脚本代码。
• 元件定时器事件：事件以系统脚本形式配置。当时间达到脚本执行周期时，触发事件中配置的脚本代码。

11.1.4复选框

复选框左边为一个小矩形框，右边是文字说明。选中时左边方框中会有一“对号”，这时其值为1，否则相反为0.

在基本绘图工具条中选择复选框控件，然后在图形窗口中拖动即可绘制一个复选框。

1. 复选框使用配置

属性页中包括元件、控制字、外观和Check框配置。

• 名称：必配置项， 访问复选框时的唯一标识。
• 控制字-允许在脚本中控制：需要运行态设置复选框属性时，必须启用该功能。
• 文字：复选框代表的对象含义命名，允许输入字符串。

• 文字颜色：复选框文字的颜色.

• 复选框访问

系统提供访问复选框的一组专用脚本函数，调用格式为：元件名称.函数；

getCheck

语法：boolean object.getCheck()

参数：无

返回值：1，当前复选框处于选中状态；0，当前复选框处于未选中状态

备注说明： 获取复选框是否选中状态

示例：check.getCheck() “check”为用户已定义的控件名称

setCheck

语法：object.setCheck(boolean CheckFlag)

参数：boolean CheckFlag，复选框选中标记

返回值：无

备注说明：设置复选框的选中标记，CheckFlag=1，选中；CheckFlag=0，取消

示例：check.setCheck(1) “check”为用户已定义的控件名称

1. 复选框驱动

无

1. 复选框事件

2. 选项改变事件：系统以脚本方式配置，当复选框在选中与取消之间切换时触发脚本配置代码；

3. 元件加载事件：系统以脚本方式配置。复选框控件存储在窗口图形内，当窗口图形打开时将加载所有图元控件，此时触发该事件配置的脚本代码。
4. 元件定时器事件：事件以系统脚本形式配置。当时间达到脚本执行周期时，触发事件中配置的脚本代码。

11.1.5微调框

微调框由一个数值显示区域和上下调节按钮两部分组成，实现变量的调整功能。

1. 微调框配置：

选中绘图工具中的微调框控件，按住鼠标左键在窗口工作区内拖动绘制出微调框。打开其属性页中完成微调框配置项。

调节类型：分为整数调节和浮点数调节。

最小值：调节时向下的最小值限制；

最大值：调节时向上的最大值限制；

调节步长：每次点击上下调节按钮时变量变化的幅值；

初始值：微调框初始化时显示的变量数值；

1. 微调框访问：

系统提供访问微调框的一组专用脚本函数，调用格式为：元件名称.函数；

getValue

语法：object.getValue()

参数：无

返回值：变量值

备注说明：可配合选项改变事件完成变量控制命令的下发。

1. 微调框事件：

2. 选项改变事件：系统以脚本方式配置，当操作微调框上下调解按钮时触发的脚本配置代码；

3. 元件加载事件：系统以脚本方式配置。微调框控件存储在窗口图形内，当窗口图形打开时将加载所有图元控件，此时触发该事件配置的脚本代码。
4. 元件定时器事件：事件以系统脚本形式配置。当时间达到脚本执行周期时，触发事件中配置的脚本代码。

11.1.6时间日期框

时间日期控件是系统提供的输入时间的交互工具。

1. 时间日期框配置：

选中绘图工具中的时间日期框控件，按住鼠标左键在窗口工作区内拖动绘制出时间日期框。打开其属性页中完成时间控件配置项。

格式：时间控件可配置为时间输入、日期输入、时间日期输入三种格式，区分运行时提供给用户输入的内容选择项。

日期选择方式如下，

时间输入直接在框内输入数值或通过右侧调节按钮调节。

1. 时间日期框访问：

系统提供访问时间框的一组专用脚本函数，调用格式为：元件名称.函数；

getDate

语法：object.getDate()

参数：无

返回值：时间字符串

备注说明：返回java类型的日期函数。

getFormatDate

语法：object.getFormatDate()

参数：无

返回值：时间字符串

备注说明：按照给定的格式串格式化控件返回时间字符串。

举例：getFormatDate(“yyyy/mm/dd”);返回形如2009/10/26的格式

在getDate()函数的基础上扩展访问函数包括：

• • getDate().getYear() +1900 返回日期年
  • getDate().getMonth() +1 返回日期月
  • getDate().getDay()+6 返回日期日
  • getDate().getHours() 返回日期小时
  • getDate().getMinutes() 返回日期分钟
  • getDate().getSeconds() 返回日期秒钟