MCGS嵌入版说明书2.docx

1、MCGS嵌入版说明书2操作同上，表示的是鼠标双击右键的事件操作。MouseDown鼠标按下。参 数1：鼠标按下时的鼠标按键信息，为1时，表示左键按下，为2时，表示右键按下，为4时，表示中键按下。参 数2：鼠标按下时的键盘信息，为1时，表示SHIFT键按下，为2时，表示CONTROL键按下，为4时，表示ALT键按下。参 数3：鼠标按下时的X坐标。参 数4：鼠标按下时的Y坐标。鼠标按下事件，有四个参数，其具体设置如上。MouseMove鼠标移动。参 数1：鼠标按下时的鼠标按键信息，为1时，表示左键按下，为2时，表示右键按下，为4时，表示中键按下。参 数2：鼠标按下时的键盘信息，为1时，表示SHIF

2、T键按下，为2时，表示CONTROL键按下，为4时，表示ALT键按下。参 数3：鼠标的X坐标。参 数4：鼠标的Y坐标。鼠标移动事件，有四个参数，其具体设置如上。MouseUp鼠标抬起。参 数1：鼠标按下时的鼠标按键信息，为1时，表示左键按下，为2时，表示右键按下，为4时，表示中键按下。参 数2：鼠标按下时的键盘信息，为1时，表示SHIFT键按下，为2时，表示CONTROL键按下，为4时，表示ALT键按下。参 数3：鼠标抬起时的X坐标。参 数4：鼠标抬起时的Y坐标。鼠标抬起事件，有四个参数，其具体设置如上。KeyDown按下键盘按键。参 数1：数值型，按下按键的ASCII码。参 数2：数值型，0

3、7位是按键的扫描码。按下键盘按键事件，有两个参数，其具体设置如上。KeyUp键盘按键抬起。参 数1：数值型，按下按键的ASCII码。参 数2：数值型，07位是按键的扫描码。键盘按键抬起事件，有两个参数，其具体设置如上。17.1.2 动画对象的属性每一个动画构件都有以下基本的属性，通过这些基本属性，可以对构件有一个基本的描述和设置。属性Name属性意义：构件名字。属性类型：字符型；只读。Left属性意义：构件的X坐标。属性类型：数值型。Top属性意义：构件的Y坐标。属性类型：数值型。Width属性意义：构件的宽度。属性类型：数值型。Height属性意义：构件的高度。属性类型：数值型。Focus属

4、性意义：构件获得焦点。属性类型：数值型。Visible属性意义：构件的可见度。属性类型：数值型。17.2 输入框构件运行时的功能输入框构件用于接受用户从键盘输入的信息，通过合法性检查之后，将它转换适当的形式，赋予实时数据库中所连接的数据对象。输入框构件也可以作为数据输出的器件，显示所连接的数据对象的值。形象地说，输入框构件在用户窗口中提供了一个观察和修改实时数据库中数据对象的值的窗口。输入框构件具有激活编辑状态和不激活状态两种不同的工作模式。当输入框构件处于不激活状态时，作为数据输出用的窗口，将显示所连接的数据对象的值，并与数据对象的变化保持同步。用鼠标单击输入框构件，或按下设置的快捷键，可使

5、输入框进入激活状态。当输入框构件处于激活编辑状态时，将中断显示数据，表示操作者可以在此框内输入数据对象所需的内容（当该构件和数值型数据对象相连接时，应当输入一组数据，当它和字符型数据对象相连接时，你应当输入适当的字符）。输入完毕，按下Enter键，则结束输入框激活模式，系统自动将输入的内容赋与该构件所连接的数据对象。用户也可以按下Esc键，来结束激活模式，此时，用户所输入的内容将不被赋给所连接的数据对象。结束激活模式后，输入框构件的工作状态将转入不激活状态，输入框构件内的闪烁光标也将消失，并恢复数据显示功能。输入框构件具有可见与不可见两种状态。当指定的可见度表达式被满足时，呈现可见状态，鼠标光

6、标经过时,会呈现手掌形，此时用鼠标单击输入框，可使它处于激活状态。当不满足指定的可见度表达式时，输入框处于不可见状态，不能向输入框中输入信息，鼠标经过时，光标形状不变。如果不指定可见度表达式，即不对可见度属性进行设置时，输入框构件处于可见状态。组态时的属性设置组态过程中，用鼠标双击已经放置在用户窗口中的输入框构件，将弹出构件的属性设置对话框。本构件包括基本属性、操作属性和可见度属性三个属性窗口页。基本属性页基本属性页所需要设计的内容如下图所示。 边界类型：指定输入框构件的边界形式。其中“三维边框”是Windows95和WindowsNT下编辑框的标准外形，可以使整个界面具备三维效果；“无边框”

7、则主要用于将输入框与其他图形元素组合起来，从而实现具有输入功能的复杂图形。 对齐方式：包括向左对齐、向右对齐、向中对齐。是指输入框内的字符的显示方式。 构件外观：包括背景颜色、字符颜色、显示效果预览。操作属性页操作属性包括指定被操作的数据对象的名称及其数值范围，设置操作用的快捷键等。 对应数据对象的名称：本项内容必须设置，指定输入框构件所连接的数据对象名称。使用右侧的问号（“？”）按钮，可以方便地查找已经定义的所有数据对象，鼠标双击所要连接的数据对象，即可将其设置在栏内。可以连接的数据对象包括数值型、开关型和字符型三种类型。 快捷键：设定了快捷键后，在运行环境中，就可以使用快捷键来激活输入框构

8、件。快捷键不是必须设定的项目。 数值输入的取值范围：本项只对数值型数据对象有效，其它类型的数据对象可以略去。当连接的数据对象是数值型时，本项是必须设置的。设定了最小值和最大值也即确定了数值输入范围，超过了界限值，则运行时只取设定的界限值。可见度属性页可见度是指输入框在系统运行中是否可见，是由指定的表达式的值决定。 表达式：本项中可以输入一个表达式，用表达式的值来控制构件的可见度。如不设置任何表达式，则运行时，构件始终处于可见状态。可使用右侧的问号（“？”）按钮查找并设置所需的表达式。 当表达式非零时：本项指定表达式的值与构件可见度相对应。属性Text属性意义：输入框中的显示文本。属性类型：字符

9、型。事件Change当输入框内容改变时触发。注意事项输入框的最大值和最小值限制的是输入，对于显示没有限制，即，在输入框中输入变量值时，最大最小值有效，但显示变量值时，没有限制。17.3 流动块构件运行时的功能流动块构件是模拟管道内液体流动状态的动画图形。它具有流动状态和不流动状态两种工作模式，由该构件属性对话框中的流动属性条件表达式决定。当流动条件表达式被满足时，流动块处于不流动状态，显示的是管道内液体静止的状态；反之，处于流动状态，流动块构件将显示液体在管道内流动的状态，流动的速度由系统的闪烁频率决定。流动块构件具有显示和不显示两种状态，当指定的可见度表达式被满足时，流动块构件将呈现可见的状

10、态，否则，处于不可见状态。组态时的属性设置组态时用鼠标双击流动块构件，弹出构件的属性设置对话框。该构件包括基本属性、流动属性和可见度属性三个属性窗口页：基本属性页流动块构件的基本属性决定了管道内液体流动的外观特征及流动的方向、速度等。属性设置的具体内容见下图。 流动外观：包括块的长度、块间间隔、块和侧边的距离、块的颜色、填充颜色、边线颜色。 流动方向：设置构件模拟液体流动时的流动方向。 流动速度：流动速度分为快、中、慢三档，每档的实际时间和闪烁速度相同，可在主控窗口属性窗口页中设置。流动属性页 表达式：本项中输入一个表达式，决定流动开始和停止的条件。或利用右侧的问号（“？”）按钮，从显示的表达

11、式列表中选取。如不组态设置表达式，则流动块构件永远处于停止状态。 当表达式非零时：本项确定表达式的值和构件流动的关系。 当停止流动时，绘制流体：勾上此项，流动块停止流动时，绘制流动块，否则不绘制流动块。可见度属性页 表达式：本项中输入一个表达式，决定流动块构件是否可见。或利用右侧的问号（“？”）按钮，从显示的表达式列表中选取。如不设置任何表达式，则运行时，构件始终处于可见状态。 当表达式非零时：本项指定表达式的值和构件可见度的对应关系。属性该动画构件的基本属性请参照“动画对象的事件以及对象的属性”。事件事件中的其他操作参见“动画构件的事件以及对象的属性”。17.4 百分比填充构件运行时的功能百

12、分比填充构件是以变化长度的长条形图来可视化实时数据库中的数据对象。同时，在百分比填充构件的中间，可用数字的形式来显示当前填充的百分比。百分比填充构件具有显示和不显示两种状态，当指定的可见度表达式被满足时，构件可见，否则，构件不可见。利用构件可见与不可见的相对长度关系，即可实现按百分比填充的动画效果。组态时的属性设置组态时用鼠标双击百分比填充构件，弹出构件的属性设置对话框。本构件包括四个属性窗口页，即：基本属性页、刻度与标注属性页、操作属性页和可见度属性页。基本属性页 构件颜色：设置和调整构件的背景颜色、填充颜色、字符颜色。 边界类型：用于设置百分比填充构件的边界形式。其中，“三维边框”是Win

13、dows95和WindowsNT下填充框的标准外形，可以使整个界面具备三维效果。 不显示百分比填充信息：选中此复选框，将不在构件中间显示百分比填充信息。刻度与标注属性页 刻度：设置主划线和次划线的数目、颜色、长度、宽度。 标注属性：设置标注文字的颜色、字体、标注间隔和标注的小数位位数。 标注显示：设置是否显示标注以及标注的显示位置。操作属性页 表达式：本项输入的表达式为百分比填充构件所对应的数值型表达式，本构件把表达式的值转化成图形方式显示。 填充位置和表达式值的连接：设置没有填充和全部填充时所对应的表达式的值，运行时以此为依据，由表达式的值来计算对应的填充位置。可见度属性页百分比填充构件的可

14、见度属性页设置方法与意义与输入框构件相同。17.5 标准按钮构件运行时的功能标准按钮构件用于实现Windows下的按钮功能。标准按钮构件对应的按钮动作有：执行一个运行策略块、打开关闭指定的用户窗口以及执行特定脚本程序等。标准按钮构件具有可见与不可见两种显示状态，当指定的可见度表达式被满足时，标准按钮构件将呈现可见状态，否则，处于不可见状态。标准按钮构件在可见的状态下，当鼠标移过标准按钮上方时，将变为手状光标，表示可以进行鼠标按键操作。如果此标准按钮构件是轻触型按钮，鼠标经过时，整个按钮将显示出向上突起的三维效果。鼠标光标移到按钮上面后，光标形状将变为手掌形，此时单击鼠标左键，或按下指定的快捷键

15、，即可执行按钮所规定的操作功能。组态时的属性设置组态时用鼠标双击标准按钮构件，弹出构件的属性设置对话框。本构件包括基本属性、操作属性、脚本程序和可见度属性四个属性页。基本属性页 按钮标题：“按钮标题”栏目中设定标准按钮构件上注释文字、颜色和字体。 水平对齐和垂直对齐：指定标准按钮构件上的标题文字对齐方式，背景位图的对齐方式与标题文字的对齐方式正好相反。 按钮类型：“标准按钮”是具有三维效果的普通按钮。“轻触按钮”则实现了一种特殊的按钮轻触效果，适于与其它图形元素组合成具有特殊按钮功能的图形。 背景位图像：“装载背景位图”可以把对象元件库中的位图装入构件，作为背景位图，“清空背景位图”用于删除已

16、装入的背景位图，下面的图形预览框则显示出装入的位图。操作属性页指定标准按钮构件所完成的功能。为了设定某种功能，用户应该首先选择该功能项前面的复选框，否则所设定的功能无效。一个标准按钮构件可以同时指定几种功能，运行时构件将逐一执行。按钮动作可以完成的功能如下图所示。 执行运行策略块：此处可以指定用户所建立的策略块，MCGS嵌入版系统固有的三个策略块（启动策略块，循环策略块，退出策略块）不能被标准按钮构件调用。组态时，按下本栏右边按钮，从弹出的策略块列表中选取。 打开用户窗口和关闭用户窗口：此处可以设置打开或关闭一个指定的用户窗口。也可按下输入栏右侧的按钮，从弹出的用户窗口列表中选取。如果指定的用

17、户窗口已经打开，则该项设置将使MCGS嵌入版简单地把这一窗口弹到最前面；如果指定的用户窗口已经关闭，则关闭窗口的操作被MCGS嵌入版忽略。 隐藏用户窗口：此处执行后，关掉所选择的用户窗口界面，但是该窗口中的内容仍然执行。 数据对象的操作：本操作一般用于对开关型对象的值进行取反、清0、置1等操作。“按1松0”操作表示鼠标在构件上按下不放时，对应数据对象的值为1，而松开时，对应数据对象的值为0；“按0松1”的操作则相反。可以按下输入栏右侧的按钮（“？”），从弹出的数据对象列表中选取。 退出系统：本操作用于退出运行系统。 快捷键：指定标准按钮构件所对应的键盘操作。脚本程序页用户可在该属性页窗口内任意

18、键入完成特定功能的脚本程序，运行时，当完成一次按钮动作时，系统执行一次对应的脚本程序。可见度按钮页标准按钮构件的可见度属性页设置方法与意义与输入框构件相同。17.6 动画按钮构件运行时的功能动画按钮构件是一种特殊的按钮构件，专用于实现类似多档开关的效果。构件与实时数据库中的数据对象相连接，通过多幅位图显示对应数据对象的值所处的范围。构件也可以接受用户的按键输入，在规定的多个状态之间切换，以改变所连接的数据对象的值。动画按钮构件具有可见与不可见两种显示状态，当指定的可见度表达式被满足时，动画按钮构件将呈现可见状态，否则，处于不可见状态。动画按钮构件在可见的状态下，当鼠标移到构件上方时，将变为手状

19、光标，表示可以进行单击鼠标左键的操作。组态时的属性设置组态时用鼠标双击动画按钮构件，弹出构件的属性设置对话框。本构件包括基本属性和可见度属性两个属性页。基本属性页 对应数据对象的名称：该栏内指定与动画按钮构件建立连接的数据对象名称，本构件一般只与开关型和数值型数据对象建立连接。 分段点：一个段点对应于动画按钮构件的一种状态，运行时，用户的按钮动作使得构件在设定的多种状态之间切换。每个分段点对应于一个数值和一幅位图，动画按钮构件在每种状态下，用对应段点的值来设置所连接的数据对象的值，同时构件显示对应的一幅位图。当构件所连接的数据对象的值发生变化时，构件也自动调整到相应的段点状态，如果对应数据对象

20、的值与所有的段点值都不相同，则构件的状态不发生变化。应当指出，如果动画按钮构件所连接的数据对象是开关型数据对象，则构件只有两种状态：非0状态（开状态）和0状态（关状态）。 增加段点：按动此按钮，在分段点列表中增加一个段点，用鼠标双击段点的值，可激活段点，进入编辑状态，修改或输入新的段点值，按“Enter”键，接受新的段点值。 删除段点：按动此按钮，删除分段点列表中所选定的段点，同时，与该段点对应的位图也被删除。 装载位图：按动此按钮，可以把对象元件库中的位图装入到指定的段点。每个分段点除对应有一个段点值外，还对应有一幅位图，左边显示的是指定段点所对应的位图。在分段点列表中选定不同的段点，可显示

21、其对应的位图。 位图大小：选中“显示位图实际大小”复选框，运行时，构件在每种状态下都将以位图的实际大小来显示位图，否则，对位图进行缩放处理，以构件的大小为基准来显示每种状态下的位图。可见度属性页动画按钮构件的可见度属性页设置方法与意义与输入框构件相同。17.7 旋钮输入器构件运行时的功能旋钮输入器构件是模拟普通仪器设备上旋钮装置的一种动画图形，使用户能用旋钮操作，改变构件所连接的数据对象的值。运行时，当鼠标位于旋钮输入器构件的上方时，光标将变为带方向箭头的形状，表示可以执行旋钮操作。当光标位于旋钮的右半边时，为顺时针箭头，表示用户的操作将使旋钮沿顺时针方向旋转；当光标位于旋钮的左半边时，为逆时

22、针箭头，表示用户的操作将使旋钮沿逆时针方向旋转。用户单击鼠标左键或右键，旋钮输入器构件将按照用户的要求转动，旋钮上的指针所指向的刻度值即为所连接的数据对象的值。旋钮输入器构件具有可见与不可见两种显示状态，当指定的可见度表达式被满足时，旋钮输入器构件将呈现可见状态，否则，处于不可见状态。组态时的属性设置组态时用鼠标双击旋钮输入器构件，弹出构件的属性设置对话框。本构件包括基本属性、刻度与标注属性、操作属性和可见度属性四个属性页。基本属性页构件外观：设置旋钮外轮廓圆边线的颜色、线型以及旋钮上指针的颜色、指针与按钮边线的距离、指针的长度、指针的宽度等。刻度与标注属性页 刻度：设置主划线和次划线的数目、

23、颜色、长度、宽度。 标注属性：设置标注文字的颜色、字体、标注间隔和标注的小数位位数。 标注显示：设置是否显示标注文字以及标注的位置。操作属性页 对应数据对象的名称：旋钮输入器构件所对应的数据对象，一般为数值型，数据对象的值和旋钮指针的位置成一一对应的关系。 指针位置和数据对象值的连接：最大、最小位置所对应的数据对象的值。 输入属性：扭动旋钮一次，数据对象的值所产生的最小变化量。可见度属性页旋钮输入器构件的可见度属性页设置方法与意义与输入框构件相同。属性Value属性意义：旋钮输入器的当前值。属性类型：数值型。事件Change当旋转按钮值改变时触发。17.8 滑动输入器构件运行时的功能滑动输入器

24、构件是通过模拟滑块直线移动实现数值输入的一种动画图形，完成Windows下的滑轨输入功能。运行时，当鼠标经过滑动输入器构件的滑动块上方时，鼠标指针变为手状光标，表示可以执行滑动输入操作，按住鼠标左键拖动滑块，改变滑块的位置，进而改变构件所连接的数据对象的值。滑动输入器构件具有可见与不可见两种显示状态，当指定的可见度表达式被满足时，滑动输入器构件将呈现可见状态，否则，处于不可见状态。组态时的属性设置组态时用鼠标双击滑动输入器构件，弹出构件的属性设置对话框。本构件包括基本属性、刻度与标注属性、操作属性和可见度属性四个属性页。基本属性页 构件外观：设置滑块的高度、宽度、颜色以及滑轨的宽度、背景颜色、

25、填充颜色。 滑块指向：设置滑块的指针方向。刻度与标注属性页 刻度：设置主划线和次划线的数目、颜色、长度、宽度。 标注属性：设置标注文字的颜色、字体、标注间隔和标注的小数位位数。 标注显示：设置是否显示标注文字以及标注的位置。操作属性页 对应数据对象的名称：滑动输入器构件所对应的数据对象，一般为数值型，数据对象的值和滑块的位置成一一对应的关系。 指针位置和数据对象值的连接：建立滑块位置和所连接的数据对象数值之间的极限关系。运行时，根据此项设置，根据滑块实际的位置，计算数据对象的值。可见度属性页滑动输入器构件的可见度属性页设置方法和意义与输入框构件相同。属性Value属性意义：滑动输入器的当前值。

26、属性类型：数值型。事件Change当旋转按钮值改变时触发。17.9 旋转仪表构件运行时的功能旋转仪表构件是模拟旋转式指针仪表的一种动画图形，用其显示所连接的数值型数据对象的值。旋转仪表构件的指针随数据对象值的变化而不断改变位置，指针所指向的刻度值即为所连接的数据对象的当前值。旋转仪表构件具有可见与不可见两种显示状态，当指定的可见度表达式被满足时，旋转仪表构件将呈现可见状态，否则，处于不可见状态。组态时的属性设置组态时用鼠标双击旋转仪表构件，弹出构件的属性设置对话框。本构件包括基本属性、刻度与标注属性、操作属性和可见度属性四个属性页：基本属性页 构件外观：设置仪表圆边边线的颜色、线型以及仪表指针

27、的颜色、指针划过区域的填充颜色、指针与圆边边线之间的距离、指针的宽度。应当指出，指针划过区域显示的颜色并不是设置的填充颜色，而是它与背景颜色进行“异或”操作，最后才形成实际可见的填充颜色。 背景位图像：“装载背景位图”按钮可以把对象元件库中的位图装入构件作为背景位图，“清空背景位图”按钮用于删除已装入的背景位图。下面的图形预览框则显示出装入的位图。 位图坐标：背景位图的中心点相对于构件中心点的坐标，用位图坐标来精确调整位图在构件中的位置。刻度与标注属性页 刻度：设置主划线和次划线的数目、颜色、长度、宽度。 标注属性：设置标注文字的颜色、字体、标注间隔和标注的小数位位数。 标注显示：设置是否显示

28、标注文字以及标注的位置。操作属性页 对应数据对象的名称：旋转仪表构件所对应的数值型数据对象，数据对象的值和指针的位置成一一对应的关系。 指针位置和数据对象值的连接：建立旋转仪表构件的指针位置与所连接的数据对象值的极限关系。运行时，由数据对象的值计算仪表指针的实际位置。可见度属性页旋转仪表构件的可见度属性页设置方法与意义与输入框构件相同。属性和方法请参照“动画对象的事件以及对象的属性”。17.10 动画显示构件运行时的功能动画显示构件用于实现动画显示和多态显示的效果。通过和表达式建立连接，动画显示构件用表达式的值来驱动切换显示多幅位图。在多态显示方式下，构件用表达式的值来寻找分段点，显示指定分段

29、点对应的一幅位图。在动画显示方式下，当表达式的值为非0时，构件按指定的频率，循环顺序切换显示所有分段点对应的位图。多幅位图的动态切换显示就实现了特定的动画效果。动画显示构件具有可见与不可见两种显示状态，当指定的可见度表达式被满足时，动画显示构件将呈现可见状态，否则，处于不可见状态。组态时的属性设置组态时用鼠标双击动画显示构件，弹出构件的属性设置对话框。本构件包括基本属性、显示属性和可见度属性三个属性页。基本属性页 表达式：指定与动画显示构件建立连接的表达式。 分段点：一个段点对应于动画显示构件的一种状态，运行时，表达式值的变化驱动构件在设定的多种状态之间切换，显示与段点对应的一幅位图。 增加段

30、点：在分段点列表中增加一个段点，用鼠标双击段点的值，可激活段点进入编辑状态，修改或输入新的段点值，按“Enter”键，接受新的段点值。 删除段点：删除分段点列表中所选定的段点，同时，该段点对应的位图也被删除。 位图：每个分段点除对应有一个段点值外，还对应有一幅位图，左边显示的是指定段点所对应的位图。在分段点列表中选定不同的段点，可显示其对应的位图。“装载位图”按钮可以把对象元件库中的位图装入到指定的段点。 位图大小：选中“显示位图的实际大小”复选框，组态时，没有选择该复选框时，构件的大小是可以调整的，选择以后将不可调整；运行时，构件在每种状态下都将以位图的实际大小来显示位图，否则，对位图进行缩

31、放处理，以构件的大小为基准来显示每种状态下的位图。显示属性页动画显示的实现：可用两种不同的方法来实现动画显示效果，一种是用表达式的值来驱动，当表达式的值发生变化时，构件用表达式的值来寻找对应的分段点，同时显示与分段点对应的一幅位图，如找不到对应的分段点，则构件显示最后一个分段点的位图；另一种是由构件自己驱动实现，按设定的频率，自动循环显示各分段点对应的每一幅位图，当表达式的值为非0时，开始切换显示，当表达式的值为0时，停止切换显示。如果用多幅位图来表示一个物理对象的不同状态，那么，不停地切换显示代表不同状态的每一幅位图，就可以模拟物理对象不断变化的动态效果。可见度属性页动画显示构件的可见度属性页设置方法和意义与输入框构件相同。属性和方法请参照“动画对象的事件以及对象的属性”。17.