组态王6.5使用手册 第14章 控件(共101页 74~101页)

“函数声明”：控件事件函数的类型都为“VOID”型，该项不可修改。控件事件函数同一般组态王自定义函数相同，都需要定义一个函数名称，如“DatTimChange( )”，函数声明中可以带有参数。
注：函数声明中函数名称不管是否有参数，都要加小括号。命令语言编辑器和自定义函数的定义、使用方法请参见本手册第十章 创建命令语言程序。
5、为控件曲线赋值：设置画面命令语言，初始化控件，和在运行过程中为各条曲线赋值。假设在组态王中的变量：实数1、实数2、实数3代表三个步骤的数值。
定义画面定义画面命令语言显示时：
初始化图表为三行三列。
定义画面定义画面命令语言存在时：1000毫秒
步骤图.Column=1;
步骤图.Row=1;
//为第一行第一列的第一条曲线赋值
图14.54 控件事件函数编辑器
编辑：编辑控件属性已关联的事件函数。当控件事件关联有事件函数时，单击鼠标右键，该项有效。
删除：删除控件属性已关联的事件函数。当控件事件关联有事件函数时，单击鼠标右键，该项有效。
例1：在日历控件的“Change”事件中添加一个控件事件函数，用组态王的变量读取控件的属性值。操作方法如下：
步骤图.Row=2;
步骤图.Data=StrFromReal( \\本站点\实型2*1.8, 2, "f" );
步骤图.Column=3;
步骤图.Row=3;
步骤图.Data=StrFromReal( \\本站点\实型3*1.8, 2, "f" );
保存画面后，切换到组态王运行系统，运行结果如下图所示。
图14.63 设置控件属性
控件名：一个Video视频控件对应一个控件名称，而且是唯一的，不能重复命名，控件名由工程人员设定，例如设为“监控”。
优先级：用于设置访问该控件的操作优先级级别，优先级级别从0-999。
安全区：单击右侧的“安全区选择”按钮，选择该控件的操作安全区。
14.3.3.3Video视频控件的使用
当控件创建成功，并定义了名称后，就可以在命令语言中调用其属性和方法了。下面以在按钮命令语言中调用日历控件的属性和方法为例介绍如何在命令语言中使用控件的属性和方法。
例1：通过一个按钮将日历控件的时间值赋值给组态王变量。实现步骤为
1、按照14.3.2.1节所述，在画面上创建日历控件，定义动画连接属性，控件名称为“DatTimCtrl”。
3、设置控件固有属性：在控件上单击右键，在弹出的快捷菜单上选择“控件属性”命令，弹出控件固有属性对话框，如下图所示。
在图表属性页中的图表类型中选择“二维”、“步骤”选项。在图表选项中选择“显示图例”选项，该选项选中后，在图表的右侧将出现关于图表中各种颜色与曲线对应情况的标识。
在文本属性页中定义图表各个标签的标题。在“属性名称”列表框中选择对象，如标题，为图表的标题，在“文本”编辑框中输入标题名称，如“步骤图”。然后可以选择“X轴”、“Y轴”定义其标签名称。然后可以通过“对齐”、“方向”选项分别定义各个标签的对齐方式和方向。
事件属性页列表共分为两列：第一列为事件的名称；第二列为与该事件关联的组态王自定义函数，即可以定义一个组态王自定义函数，当控件的事件产生时，组态王可以自动调用该函数。但需要注意的是，控件事件的关联函数必须在控件属性页中添加和编辑。
在相应事件的“关联函数”表格中单击鼠标右键，弹出快捷菜单，如图14.53所示。
双击该控件，弹出控件的“关于”对话框，如图所示。
使用Microsoft Chart Control控件可以制作如棒图、散点图、曲线图、分布图等图表。用户可以按照例中的方法使用。
Active X控件按照其功能的不同，其属性、方法、事件有多有少，复杂程度也不同。建议用户在使用Active X控件前最好先参阅一下控件厂家的说明、帮助等，如属于Microsoft的控件，可以参阅MSDN。
2、在画面上创建按钮，双击按钮，弹出按钮动画连接对话框，选择“弹起时”命令语言，弹出命令语言编辑器，在命令语言编辑器的底部按钮区中单击“控件”按钮，弹出“控件属性和方法”对话框，如图14.58所示。该对话框由三个列表组成：
控件名称：为下拉列表框，该列表框中列出当前工程中创建的所有Active X控件的名称。选择需要引用的控件的名称，如“DatTimCtrl”。“查看类型”列表框将变为有效。
步骤图.Data=StrFromReal( \\本站点\实型3, 2, "f" );
步骤图.Column=2;
步骤图.Row=1;
步骤图.Data=StrFromReal( \\本站点\实型1*1.2, 2, "f" );
步骤图.Column=2;
步骤图.Row=2;
步骤图.Data=StrFromReal( \\本站点\实型2*1.2, 2, "f" );
Video控件的使用主要依靠调用控件提供的方法来实现。控件提供的方法主要有以下几种：
AboutBox()
CapVideoToAVI(STRING lpszAVIName)
GetDevNum()
OpenAVI(STRING lpszFileName)
OpenVideo(LONG nResIndex)
ReadPort(LONG nAddr)
14.3.3 组态王提供的Video视频控件
Video视频控件由组态王提供的支持视频显示的Active X控件。用户可通过该控件与各种型号的视频设备相连接。Video视频控件的使用步骤为：
14.3.3.1画面上创建Video视频控件
操作步骤如下：
第一步：单击工具箱中的“插入通用控件”按钮或选择菜单命令“编辑\插入通用控件”，则弹出“插入控件”对话框。
查看类型：从列表框中选择查看的类型：控件属性或控件方法。
属性或方法：当选择“查看类型”后，在属性或方法列表中将列出相应类型的列表。如选择控件属性，则在属性或方法列表中列出日历控件的所有属性。如图14.59所示。
图14.58 控件属性和方法对话框
图14.59 日历控件的控件属性
4、在属性列表中选择控件的属性，如“Year”，单击对话框的“确定”按钮，或在列表中直接双击该属性，控件属性和方法列表框自动关闭，控件的属性自动添加到命令语言编辑器中。如图14.60所示。
步骤图.Column=2;
步骤图.Row=3;
步骤图.Data=StrFromReal( \\本站点\实型3*1.2, 2, "f" );
步骤图.Column=3;
步骤图.Row=1;
步骤图.Data=StrFromReal( \\本站点\实型1*1.8, 2, "f" );
步骤图.Column=3;
SaveVideoFrame(STRING lpszPicName)
SaveVideoFrmeToRect(STRING lpszPicName)
图14.53 控件事件函数编辑快捷菜单
在快捷菜单中共有三个菜单项：
添加：对控件事件添加一个函数。选择“添加”命令后，弹出“控件事件函数”命令语言编辑器，如图14.54所示。控件事件函数命令语言编辑器与通用的命令语言编辑器的使用方法相同，唯一特殊的是图中划圈的地方：
“事件”标签后的内容表示当前编辑的控件事件的名称，如“Change（）”事件，如果事件带有参数，则会在事件名称内的括号中直接给出。
第十四章 控 件
14.3.2.3.3动画连接属性页——事件页
单击动画连接属性的“事件”标签，显示“事件”页。如图14.52所示。
图14.52 控件动画连接属性对话框——事件页
在事件属性页中，列举出了该控件的所有事件。如单击控件事件——“Click”，控件数据变化事件——“Change”等。控件的各个事件的具体含义请参见控件的说明文档（如本例中的日历控件可以查看MSDN等资料）。
步骤图.Data=StrFromReal( \\本站点\实型1, 2, "f" );
步骤图.Column=1;
步骤图.Row=2;
//为第一行第一列的第二条曲线赋值
步骤图.Data=StrFromReal( \\本站点\实型2, 2, "f" );
步骤图.Column=1;
步骤图.Row=3;
//为第一行第一列的第三条曲线赋值
本例使用Microsoft Chart Control控件为例说明如何利用该控件作一个步骤图。
1、新建画面，单击工具箱上的“插入通用控件”按钮，或选择菜单“编辑/插入通用控件”命令，弹出插入控件对话框，如下图所示。
2、插入控件：在对话框中选择“Microsoft Chart Control”项，然后单击“确定”按钮。对话框自动消失，鼠标箭头变为小“十”字型，在画面中绘制图表的区域按下鼠标左键，然后拖动鼠标，拖动出的矩形框为图表的区域，松开鼠标键后，图表创建成功，显示在画面上，如下图所示。
图14.60 在命令语言中引用控件的属性
例2：通过按钮命令语言调用控件的方法。操作步骤如下：
1、使用例1中的日历控件。在画面上创建按钮，在按钮命令语言编辑器中单击“控件”按钮。
2、在弹出的“控件属性和方法”对话框中，选择控件名称“DatTimCtrl”，在查看类型中选择“控件方法”。如图14.61所示。如在本例中选择控件的关于——“AboutBox”。选择后，单击“确定”，关闭对话框。如图14.62所示，为在命令语言中调用的控件的方法。
图14.56 添加控件的MouseDown事件函数
图14.57 控件的MouseDown事件函数
14.3.2.4在命令语言中调用Active X控件的属性和方法
控件与组态王关联除了在控件属性中关联组态王变量和定义控件事件函数外，还可以在组态王的任何命令语言程序中调用控件的属性和方法。如画面命令语言、动画连接命令语言、应用程序命令语言等。但需要注意的是，当在运行系统中命令语言满足条件执行时，含有控件的画面在运行系统中应该是运行着的（不一定是当前画面），否则会出现调用调用控件属性或方法失败的情况，即得不到控件返回的值。
例2：组态王提供了一个表格控件“KVDBGrid”。在工具箱上选择插入通用控件，在控件列表中选择“KVDBGrid Class”，创建控件。定义控件的动画连接属性中控件名称为“KVDBGridCtrl”。如图14.56所示，添加其“MouseDown”事件函数。定义当鼠标左键按下时，表格的行数加1；鼠标右键按下时，表格的列数加1。定义的命令语言程序如图14.57所示。
第二步：在“插入控件”对话框内选择Video Control，如下图所示：
第三步：用鼠标左键单击“确定”按钮，鼠标变成十字形。然后在画面上画一个矩形框，Video视频控件就放到画面上了。可以任意移动、缩放Video视频控件，如同处理一个单元图素一样。
14.3.3.2设置Video视频控件的属性
用左键双击Video控件，弹出“动画连接属性”对话框，或者用右键单击Video控件选择菜单命令“动画连接”，则也弹出“动画连接属性”对话框如下:
图14.61 控件方法列表
图14.62 调用控件的方法
按照上述例程中的方法，可以在组态王的其它命令语言中调用控件的方法和属性。
14.3.2.5一个Active X控件的使用例程
Active X控件的使用极大的方便了用户，使用户很多在组态软件中无法使用的功能，通过Active X控件轻而易举的实现了。下面详细举例说明Active X控件在组态王中如何使用。
1、创建日历控件，定义控件的动画连接属性中的名称，如“DatTim”。
2、在控件的事件属性页中的“Chang”事件关联函数格中，单击右键，选择“添加”菜单命令。
3、在函数声明的编辑框中输入函数名称“DatTimChange( )”。
4、在命令语言编辑区输入命令语言程序，如图14.55所示。
图14.55 控件事件函数1
在字体属性页中定义各个标签的字体及字体颜色。定义完成的图表如下图所示。
4、设置控件名称和函数：在组态王中每一个控件必须要有一个唯一的名称。双Байду номын сангаас该图表控件，弹出动画连接属性对话框，如下图所示。
常规属性页中，在“控件名”编辑框中输入控件的名称，如“步骤图”。
在事件属性页中定义一个函数：当用户双击该图表时，弹出图表控件的版本信息。双击“DblClick”对应的“关联函数”，弹出控件事件函数对话框，定义函数的名称为“hanshu()”,单击“控件”按钮，在弹出的控件属性和方法对话框中选择“步骤图”的方法“AboutBox”方法。如下图所示。