昆仑通态触摸屏McgsPro软件动画构件-组合框
日期:2023-01-28 点击:3148
昆仑通态触摸屏McgsPro软件动画构件-组合框
1、昆仑通态触摸屏McgsPro软件动画构件功能概述
用户对系统的操作中往往会遇到大量数据选择的情况，在个人计算机领域，微软公司提供的一个下拉列表构件给用户提供了方便操作，而应用在工控机领域的组态软件上，组合框构件也因此油然而生。McgsPro系列产品的组合框构件包括了2种类型（下拉列表框，下拉输入框），不同类型的组合框有不同的处理。如：
● 下拉输入框：提供用户编辑和选择功能；
● 下拉列表框：提供用户选择功能；
McgsPro系列产品组合框构件本质上是一个特殊的输入型构件，目的是对构件的数据关联对象进行赋值操作，赋值方式有：点击下拉项赋值并显示、改变ID关联变量值赋值并显示、弹出输入键盘输入赋值并显示（下拉输入框）。
由于组合框构件的多样性，用户可以组合不同类型的组合框构件，完成大部分的手工输入工作，再结合组合框构件的属性和方法脚本以及和实时变量的无缝连接，整个系统功能得到了增强。 McgsPro系列产品组合框构件由三个部分组成：组态环境组合框构件设计，运行环境组合框构件操作和运行环境组合框构件脚本函数。
2、昆仑通态触摸屏McgsPro软件动画构件组态配置
组态时用鼠标双击组合框构件，弹出构件的属性设置对话框。本构件包括基本属性、选项设置、脚本程序和安全属性页。
（1）基本属性页
基本属性配置页如图1所示，McgsPro系列产品中构件类型支持下拉列表框和下拉输入框。
● 控件名称：设置组合框构件的名称；
● 内容关联：设置输出到实时数据库变量的名称，可设置整数、浮点数、字符串变量；
● 序号关联：设置选项ID号关联的实时数据库变量。选择不同下拉选项后，关联变量值相应改变；或者关联变量值改变后，选项随之改变；
● 奇行背景：设置组合框构件编辑显示部分背景颜色及下拉列表奇行颜色；
● 偶行背景：设置组合框下拉列表偶行背景颜色；
● 文本颜色：设置组合框构件编辑显示部分文字颜色；
● 文本字体：设置组合框构件编辑显示部分和下拉菜单部分文字字体；
● 行高：设置显示栏和下拉列表行高；
● 弹出方向：指定运行时下拉列表弹出方向。
● 构件类型：McgsPro系列产品仅支持下拉列表框和下拉输入框类型。下拉输入框的编辑显示区域可以点击输入，下拉列表框则不能输入，只能通过下拉选项选择。
● 背景图：显示栏和下拉栏可关联背景图；
图1 组合框基本属性
（2）选项设置页
选项设置相同，如图2和3所示，在选项设置栏中每一行配置一个下拉选项，并对应一个ID号。选项设置支持多语言，详情请参考第十三章，下拉项配置8000项。
● 静态选项：设置下拉列表选项为固定内容；
● 动态选项：设置下拉列表选项从关联字符串变量中读取；
图2 组合框选项设置静态选项
图3 组合框选项设置动态选项
（3）脚本程序页
脚本程序可以设置组合框构件选项发生变化后，执行组态的脚本程序，如图4所示。
图4 组合框脚本程序
（4）安全属性页
安全属性是指构件在系统运行中是否可操作，是由指定的表达式的值决定。
● 表达式：本项中可以输入一个表达式，用表达式的值来控制构件是否可操作（即使能状态）。如不设置任何表达式，则运行时，构件始终处于可操作状态。可使用右侧的问号（“？”）按钮查找并设置所需的表达式。
● 条件设置：本项指定表达式的值与构件使能状态相对应。
● 失效样式：指定构件不可操作时（构件失效）构件的外观状态。
● 弹框确认：弹框确认可实现组合框选项变化前，对操作进行确认，以达到安全操作目的。确认等待时间指定弹出确认对话框自动消失的时间间隔。
图5 组合框安全属性
3、昆仑通态触摸屏McgsPro软件动画构件运行操作
（1）下拉输入框
运行工程后，下拉组合框显示如图6所示，操作包括：
● 键盘输入：点击编辑框区域，弹出输入键盘并输入值，组合框关联变量值随之改变；
● 下拉选择：点击下拉按钮弹出下拉菜单，选择下拉项，组合框关联变量值随之改变；
● 下拉菜单浏览：点击下拉菜单向上三角形按钮或向下三角形按钮，可以实现翻条操作；点击滚动条空白部分实现翻页操作；点击并拖动滚动条滑块实现任意浏览。
图6 下拉组合框操作
注意：若下拉项的字符串与组合框数据关联对象数据类型不一致时，下拉项字符串会强转为该数据类型（强转失败可能为0）
（2）下拉列表框
运行工程后，列表组合框运行效果如图7所示，其操作如下：
● 下拉选择：点击下拉按钮弹出下拉菜单，选择下拉项，组合框关联变量值随之改变；
● 下拉菜单浏览：点击下拉菜单向上三角形按钮或向下三角形按钮，可以实现翻条操作；点击滚动条空白部分实现翻页操作；点击并拖动滚动条滑块实现任意浏览。
图7 列表组合框操作
4、昆仑通态触摸屏McgsPro软件动画构件构件方法
组合框构件支持丰富的脚本操作函数，具体如下。
Clear()
函数意义： 清除当前组合框构件的列表内容
返 回 值： 无
参 数： 无
实 例： 窗口0.控件0.Clear()
GetSelText()
函数意义： 得到当前编辑框的内容
返 回 值： 字符串型
参 数： 无
实 例： data1 = 窗口0.控件0.GetSelText()，data1为字符串
GetSelFloat(reNum)
函数意义： 得到当前编辑框的数值内容
返 回 值： 整数
= 1，成功
= 0，失败
参 数： reNum， 浮点数，返回数值
实 例： 窗口0.控件0.GetSelFloat(data1)，data1为浮点数，返回数值。
AddItem(strItem)
函数意义： 增加一条记录到下拉列表
返 回 值： 整数
= 1，成功
= 0，失败
参 数： strItem：字符串型，新项目内容
实 例： 窗口0.控件0.AddItem( data1) ，data1为字符串
GetStrByID(ID,strItem)
函数意义： 通过ID得到字符串；
返 回 值： 整数
= 1，成功
= 0，失败
参 数： ID：整数，项目序号
strItem：字符串，返回字符串
实 例： 窗口0.控件0.GetStrByID( data1,data2) ，data1为浮点数，data2为字符串，用于保存结果
GetFloatByID(ID, nItem)
函数意义： 通过ID得到浮点值；
返 回 值： 整数
= 1，成功
= 0，失败
参 数： ID：整数，项目序号
nItem：浮点数，返回数值
实 例： 窗口0.控件0.GetFloatByID( data1,data2) data1:整数，data2:浮点数，用于接收结果；
GetTotalItemSum()
函数意义： 得到当前组合框下拉列表项总数；
返 回 值： 整数，项目总数
参 数： 无
实 例： data1 = 窗口0.控件0.GetTotalItemSum() data1：整数
SetCurSelByID(ID)
函数意义： 通过ID设置当前选择项；
返 回 值： 整数
= 1，成功
= 0，失败
参 数： ID：整数，项目序号
实 例： 窗口0.控件0.SetCurSelByID(data1) data1：整数
DeleteItem(ID)
函数意义： 通过ID删除某项；
返 回 值： 整数
= 1，成功
= 0，失败
参 数： ID：整数，项目序号
实 例： 窗口0.控件0.DeleteItem(data1) data1：整数
SetItemValueByID (ID,strItem)
函数意义： 通过ID修改下拉列表项的值；
返 回 值： 整数
= 1，成功
= 0，失败
参 数： ID： 整数，项目序号
strItem： 字符串，设置字符串
实 例： 窗口0.控件0. SetItemValueByID(data0,data1 ) data0:整数 data1:字符串
InsertItemByID(ID,strItem)
函数意义： 通过ID向下拉列表插入一条记录；
返 回 值： 整数
= 1，成功
= 0，失败
参 数： ID： 整数，项目序号
strItem： 字符串，插入字符串
实 例：窗口0.控件0.InsertItemByID(data0,data1 ) ，data0为整型，data1为字符串
5、昆仑通态触摸屏McgsPro软件动画构件构件属性
构件属性请参考（昆仑通态触摸屏McgsPro软件动画构件-公共属性）。
6、昆仑通态触摸屏McgsPro软件动画构件构件事件
构件属性请参考（昆仑通态触摸屏McgsPro软件动画构件-公共属性）。
1、昆仑通态触摸屏McgsPro软件动画构件功能概述
用户对系统的操作中往往会遇到大量数据选择的情况，在个人计算机领域，微软公司提供的一个下拉列表构件给用户提供了方便操作，而应用在工控机领域的组态软件上，组合框构件也因此油然而生。McgsPro系列产品的组合框构件包括了2种类型（下拉列表框，下拉输入框），不同类型的组合框有不同的处理。如：
● 下拉输入框：提供用户编辑和选择功能；
● 下拉列表框：提供用户选择功能；
McgsPro系列产品组合框构件本质上是一个特殊的输入型构件，目的是对构件的数据关联对象进行赋值操作，赋值方式有：点击下拉项赋值并显示、改变ID关联变量值赋值并显示、弹出输入键盘输入赋值并显示（下拉输入框）。
由于组合框构件的多样性，用户可以组合不同类型的组合框构件，完成大部分的手工输入工作，再结合组合框构件的属性和方法脚本以及和实时变量的无缝连接，整个系统功能得到了增强。 McgsPro系列产品组合框构件由三个部分组成：组态环境组合框构件设计，运行环境组合框构件操作和运行环境组合框构件脚本函数。
2、昆仑通态触摸屏McgsPro软件动画构件组态配置
组态时用鼠标双击组合框构件，弹出构件的属性设置对话框。本构件包括基本属性、选项设置、脚本程序和安全属性页。
（1）基本属性页
基本属性配置页如图1所示，McgsPro系列产品中构件类型支持下拉列表框和下拉输入框。
● 控件名称：设置组合框构件的名称；
● 内容关联：设置输出到实时数据库变量的名称，可设置整数、浮点数、字符串变量；
● 序号关联：设置选项ID号关联的实时数据库变量。选择不同下拉选项后，关联变量值相应改变；或者关联变量值改变后，选项随之改变；
● 奇行背景：设置组合框构件编辑显示部分背景颜色及下拉列表奇行颜色；
● 偶行背景：设置组合框下拉列表偶行背景颜色；
● 文本颜色：设置组合框构件编辑显示部分文字颜色；
● 文本字体：设置组合框构件编辑显示部分和下拉菜单部分文字字体；
● 行高：设置显示栏和下拉列表行高；
● 弹出方向：指定运行时下拉列表弹出方向。
● 构件类型：McgsPro系列产品仅支持下拉列表框和下拉输入框类型。下拉输入框的编辑显示区域可以点击输入，下拉列表框则不能输入，只能通过下拉选项选择。
● 背景图：显示栏和下拉栏可关联背景图；
图1 组合框基本属性
（2）选项设置页
选项设置相同，如图2和3所示，在选项设置栏中每一行配置一个下拉选项，并对应一个ID号。选项设置支持多语言，详情请参考第十三章，下拉项配置8000项。
● 静态选项：设置下拉列表选项为固定内容；
● 动态选项：设置下拉列表选项从关联字符串变量中读取；
图2 组合框选项设置静态选项
图3 组合框选项设置动态选项
（3）脚本程序页
脚本程序可以设置组合框构件选项发生变化后，执行组态的脚本程序，如图4所示。
图4 组合框脚本程序
（4）安全属性页
安全属性是指构件在系统运行中是否可操作，是由指定的表达式的值决定。
● 表达式：本项中可以输入一个表达式，用表达式的值来控制构件是否可操作（即使能状态）。如不设置任何表达式，则运行时，构件始终处于可操作状态。可使用右侧的问号（“？”）按钮查找并设置所需的表达式。
● 条件设置：本项指定表达式的值与构件使能状态相对应。
● 失效样式：指定构件不可操作时（构件失效）构件的外观状态。
● 弹框确认：弹框确认可实现组合框选项变化前，对操作进行确认，以达到安全操作目的。确认等待时间指定弹出确认对话框自动消失的时间间隔。
图5 组合框安全属性
3、昆仑通态触摸屏McgsPro软件动画构件运行操作
（1）下拉输入框
运行工程后，下拉组合框显示如图6所示，操作包括：
● 键盘输入：点击编辑框区域，弹出输入键盘并输入值，组合框关联变量值随之改变；
● 下拉选择：点击下拉按钮弹出下拉菜单，选择下拉项，组合框关联变量值随之改变；
● 下拉菜单浏览：点击下拉菜单向上三角形按钮或向下三角形按钮，可以实现翻条操作；点击滚动条空白部分实现翻页操作；点击并拖动滚动条滑块实现任意浏览。
图6 下拉组合框操作
注意：若下拉项的字符串与组合框数据关联对象数据类型不一致时，下拉项字符串会强转为该数据类型（强转失败可能为0）
（2）下拉列表框
运行工程后，列表组合框运行效果如图7所示，其操作如下：
● 下拉选择：点击下拉按钮弹出下拉菜单，选择下拉项，组合框关联变量值随之改变；
● 下拉菜单浏览：点击下拉菜单向上三角形按钮或向下三角形按钮，可以实现翻条操作；点击滚动条空白部分实现翻页操作；点击并拖动滚动条滑块实现任意浏览。
图7 列表组合框操作
4、昆仑通态触摸屏McgsPro软件动画构件构件方法
组合框构件支持丰富的脚本操作函数，具体如下。
Clear()
函数意义： 清除当前组合框构件的列表内容
返 回 值： 无
参 数： 无
实 例： 窗口0.控件0.Clear()
GetSelText()
函数意义： 得到当前编辑框的内容
返 回 值： 字符串型
参 数： 无
实 例： data1 = 窗口0.控件0.GetSelText()，data1为字符串
GetSelFloat(reNum)
函数意义： 得到当前编辑框的数值内容
返 回 值： 整数
= 1，成功
= 0，失败
参 数： reNum， 浮点数，返回数值
实 例： 窗口0.控件0.GetSelFloat(data1)，data1为浮点数，返回数值。
AddItem(strItem)
函数意义： 增加一条记录到下拉列表
返 回 值： 整数
= 1，成功
= 0，失败
参 数： strItem：字符串型，新项目内容
实 例： 窗口0.控件0.AddItem( data1) ，data1为字符串
GetStrByID(ID,strItem)
函数意义： 通过ID得到字符串；
返 回 值： 整数
= 1，成功
= 0，失败
参 数： ID：整数，项目序号
strItem：字符串，返回字符串
实 例： 窗口0.控件0.GetStrByID( data1,data2) ，data1为浮点数，data2为字符串，用于保存结果
GetFloatByID(ID, nItem)
函数意义： 通过ID得到浮点值；
返 回 值： 整数
= 1，成功
= 0，失败
参 数： ID：整数，项目序号
nItem：浮点数，返回数值
实 例： 窗口0.控件0.GetFloatByID( data1,data2) data1:整数，data2:浮点数，用于接收结果；
GetTotalItemSum()
函数意义： 得到当前组合框下拉列表项总数；
返 回 值： 整数，项目总数
参 数： 无
实 例： data1 = 窗口0.控件0.GetTotalItemSum() data1：整数
SetCurSelByID(ID)
函数意义： 通过ID设置当前选择项；
返 回 值： 整数
= 1，成功
= 0，失败
参 数： ID：整数，项目序号
实 例： 窗口0.控件0.SetCurSelByID(data1) data1：整数
DeleteItem(ID)
函数意义： 通过ID删除某项；
返 回 值： 整数
= 1，成功
= 0，失败
参 数： ID：整数，项目序号
实 例： 窗口0.控件0.DeleteItem(data1) data1：整数
SetItemValueByID (ID,strItem)
函数意义： 通过ID修改下拉列表项的值；
返 回 值： 整数
= 1，成功
= 0，失败
参 数： ID： 整数，项目序号
strItem： 字符串，设置字符串
实 例： 窗口0.控件0. SetItemValueByID(data0,data1 ) data0:整数 data1:字符串
InsertItemByID(ID,strItem)
函数意义： 通过ID向下拉列表插入一条记录；
返 回 值： 整数
= 1，成功
= 0，失败
参 数： ID： 整数，项目序号
strItem： 字符串，插入字符串
实 例：窗口0.控件0.InsertItemByID(data0,data1 ) ，data0为整型，data1为字符串
5、昆仑通态触摸屏McgsPro软件动画构件构件属性
构件属性请参考（昆仑通态触摸屏McgsPro软件动画构件-公共属性）。
6、昆仑通态触摸屏McgsPro软件动画构件构件事件
构件属性请参考（昆仑通态触摸屏McgsPro软件动画构件-公共属性）。
本文摘自：网络 2023-01-28