第二十四章使用SEClient对象模型和显示代码

1、24章 使用SE Client对象模型和显示代码在图形显示画面中使用RSView SE Client（RSView SE客户端）对象模型和Visual Basic for Applications（VBA）代码可以定制和扩展RSView SE Client的功能。为此用户可以使用下面的方式：与其它应用程序共享数据 如果用户需要经常性的在诸如Microsoft Excel或SQL Server等程序中使用RSView数据，则可以考虑使用RSView SE Client对象模型和显示代码与VBA以便将RSView与这些应用程序进行集成。为操作员创建自定义的窗体 用户可以使用VBA创建自定义的窗体，

2、例如创建一个操作员可以在运行时进行交互的弹出对话框。用户还可以使用VBA逻辑来验证操作员的输入，例如：确保操作员输入到一个数字输入框的数据在另一个数字输入框的数值的10%之间波动。设计直观的图形显示画面 使用RSView SE Client对象模型将ActiveX控件与数据结合在一起，以便在图形显示画面中使用。例如：在图形显示画面中使用列表框和组合框以便允许操作员选择如recipe item（配方项）等选项。操作RSView SE Client窗口 根据RSView SE Client窗口的尺寸，通过编写VBA代码来排列图形显示画面。这样就可以让用户的应用项目动态地调整其大小，以便适用不同的屏

3、幕桌面大小和分辨率。使用SE Client对象模型和显示代码 24-1将自定义的信息发送到诊断日志文件 使用VBA代码将特定的信息发送到Diagnostics List（诊断列表）和Diagnostics log file（诊断日志文件），以便记录运行情况和事件。保护系统 通过RSView SE Client对象模型，用户可以获得安全信息，得知谁在使用该系统，并且通过使用该安全信息和事件来控制对系统的访问。例如：用户可以编写一段代码，来限制用户在一台安全计算机上访问特定的图形显示画面，并且只有当与该图形显示画面具有相同的安全代码的用户名登录时，才可以显示该图形。VBA集成的开发环境RSView

4、图形显示画面中包含了Microsoft Visual Basic for Applications（VBA）。使用VBA集成的开发环境（IDE）可以创建、测试和调试VBA过程，然后运行这些过程来响应在RSView图形显示画面中触发的事件。本章对IDE进行了简要的说明，但没有谈及VBA的详细信息假定用户熟悉VBA环境和Visual Basic编程语言。本章重点谈到了VBA相对于RSView Studio的很独特部分，并且讲述了如何在RSView图形显示画面中使用VBA。关于如何访问VBA的信息的信息，请参阅第24-13页的“使用VBA帮助文件”。打开IDE窗口1. 打开用户想要编写VBA代码的图

5、形显示画面。2. 执行下面任意操作：n 在Graphic Displays（图形显示）编辑器，点击View（查看）菜单，然后点击Visual Basic Editor（Visual Basic编辑器）。24-2 RSView Supervisory Edition用户指南（RSView管理版用户指南）n 点击图形显示画面中的某个对象。在Edit（编辑）菜单中，点击VBA Code（VBA代码）。代码窗口会打开，其内容为用户所选对象的代码。n 在Graphic Displays（图形显示）编辑器中，点击Edit（编辑）菜单，然后点击VBA Code（VBA代码）。代码窗口会打开，其内容为图形显示

6、画面的代码。n 右键点击已打开的图形显示画面，然后点击其上下文菜单中的VBA Code（VBA代码），代码窗口会打开，其内容为图形显示画面的代码。n 右键点击画面中的对象，然后点击其上下文菜单中的VBA Code（VBA代码）。代码窗口会打开，其内容为用户右键点击对象的代码。IDE窗口的组成部分下图显示了IDE窗口的主要组成部分。下面会具体说明每个部分。Project Explorer window 工程浏览器窗口Properties window 属性窗口Procedure or Code window 过程或代码窗口使用SE Client对象模型和显示代码 24-3工程浏览器窗口对于每个图

7、形显示画面，会自动创建一个名为DisplayCode的VBA工程。对于在Graphic Display（图形显示）编辑器中打开的每个图形显示画面，工程浏览器都会显示该VBA工程。每个工程都包含一个RSView Studio Objects（RSView Studio对象）文件夹。该文件夹包含一个称为ThisDisplay的模块，它代表图形显示画面。该模块包含了与画面中的对象进行交互的代码。名为ThisDisplay的模块可以包含任何数量的过程。用户可以创建额外的VBA模块和用户窗体。要想在这些模块中使用过程或者使用用户窗体，用户必须从名为ThisDisplay的模块中调用这些过程。属性窗口该窗

8、口列出了代码模块、类模块和VBA用户窗体及这些窗体上对象的属性设置。用户不能够在RSView中直接调用窗体。要想使用窗体，可以在名为ThisDisplay的代码模块的过程中调用该窗体。过程或代码窗口该窗口是用户可以编写或编辑VBA过程的窗口。在ThisDisplay中，任何可以触发事件的RSView SE Client对象都在该窗口左手侧的下拉列表中列出。当在左侧列表中选择某个对象时，该对象的事件会在右手侧的下拉列表中列出。24-4 RSView Supervisory Edition用户指南（RSView管理版用户指南）快速上手步骤步骤1开始创建一个图形显示画面显示代码和图形显示画面一同保存

9、。在用户编写可以操作图形对象的VBA代码之前，用户应该首先创建图形显示画面和图形对象。关于创建图形显示画面的详细信息，请参阅第16章，“创建图形显示”。步骤2创建用户的VBA代码使用Visual Basic编程语言，可以在名为ThisDisplay模块的代码窗口中创建过程。关于创建Visual Basic过程的信息，请参阅VBA帮助文件。关于访问VBA帮助文件的信息，请参阅第24-13页的“使用VBA帮助”。VBA代码是如何运行的用户所创建的VBA过程被调用以响应画面事件。当用户在运行时打开显示画面后，图形显示画面事件被触发。响应该事件的过程会自动执行。关于过程过程被称为代码块，它以单元为单位

10、运行。过程的实例如Visual Basic子程序和函数。名为ThisDisplay的模块可包含任何数量的过程，以响应画面事件。用户在名为ThisDisplay的模块中创建的过程可以的调用其它窗体或模块中的任何过程。使用SE Client对象模型和显示代码 24-5RSView SE Client对象模型RSView SE Client对象模型包含能够代表RSView SE Client特点的对象。使用这些对象，用户可以通过编写代码与RSView SE Client进行交互，这些代码在某个对象事件发生时运行。VBA可以与下列RSView SE Client对象模型中的对象进行交互：ActiveX

11、Extender ActiveXExtender对象将由RSView图形实现的属性和方法与ActiveX对象的属性和方法进行合并。AlarmSummary 代表RSView Alarm Summary对象。Application 代表RSView SE Client的容器程序。使用这个对象来访问RSView图形显示集。Arc 代表RSView弧形对象。Arrow 代表RSView箭头对象。BackspaceButton代表RSView退格按钮对象。该对象如同键盘上的退格键一样工作。BarGraph 代表RSView柱状显示对象Button 代表RSView按钮对象。ControlListSel

12、ector代表RSView控件列表选择器对象。Display 代表图形显示画面。DisplayListSelector代表RSView图形显示画面列表选择器对象。Displays 包含多个图形显示画面对象的集合。Element 代表图形显示画面中的任何对象。该对象包含了所有RSView对象的基本属性和方法。24-6 RSView Supervisory Edition用户指南（RSView管理版用户指南）其成员与每个图形对象的特定成员相结合，并形成可以在VBA中使用的图形对象。Elements 代表多个元素对象的集合。Ellipse 代表RSView椭圆对象。EmbeddedOLE Embed

13、dedOLE对象代表第三方对象，如Excel图表。EndButton 代表RSView结束按钮对象。该对象如同键盘上的结束键一样工作。EnterButton 代表RSView回车按钮对象。该对象如同键盘上的回车键一样工作。Freehand代表RSView徒手画对象。Gauge代表RSView测量盘对象。Group 代表画面上的一套已经被组合起来的对象。要想编写可以响应组事件的VBA代码，用户必须在打开VBA IDE之前在图形显示画面中创建组。如果用户没有首先在图形显示画面中创建组，则组对象将不会产生事件，且在运行时为该组编写的代码也不会响应组事件。HomeButton代表RSView起始按钮对

14、象。该对象如同键盘上的起始键一样工作。Image代表RSView图像对象。InterlockedPushButton代表RSView互锁型按钮对象。LatchedPushButton代表RSView锁定型按钮对象。Line代表RSView画线对象。ListIndicator代表RSView列表指示器对象。使用SE Client对象模型和显示代码 24-7LocalMessageDisplay代表RSView本地信息显示对象。MaintainedPushButton代表RSView保持型按钮对象。MomentaryPushButton代表RSView瞬时型按钮对象。MoveDownButton代

15、表RSView向下移动按钮对象。该对象如同键盘上的向下箭头键一样工作。MoveLeftButton代表RSView向左移动按钮对象。该对象如同键盘上的向左箭头键一样工作。MoveRightButton代表RSView向右移动按钮对象。该对象如同键盘上的向右箭头键一样工作。MoveUpButton代表RSView向上移动按钮对象。该对象如同键盘上的向上箭头键一样工作。MultistateIndicator代表RSView多态指示器对象。MultistatePushButton代表RSView多态按钮对象。NumericDisplay代表RSView数字显示对象。NumericInput代表RSV

16、iew数字输入对象。PageDownButton代表RSView向下翻页按钮对象。该对象如同键盘上的向下翻页键一样工作。PageUpButton代表RSView向上翻页按钮对象。该对象如同键盘上的向上翻页键一样工作。Panel 代表RSView面板对象。Picture代表RSView位图对象。PilotCtrlListSelector代表RSView导航控制列表选择器对象。24-8 RSView Supervisory Edition用户指南（RSView管理版用户指南）Polygon代表RSView多边形对象。Polyline代表RSView折线对象。PolyPolygon代表RSView多

17、个多边形对象。RampPushButton代表RSView斜坡增减型按钮对象。Recipe代表RSView配方对象。RoundedRectangle代表RSView圆角矩形对象。使用多边形对象来表示矩形。Scale代表RSView比例对象。在柱状图中使用该对象。StringDisplay代表RSView字符串显示对象。StringInput 代表RSView字符串输入对象。Symbol代表RSView符号指示器对象。StringList 代表特殊字符串的集合。Tag 代表FactoryTalk标签对象。使用标签对象可以为标签提供运行时的信息，或设置标签的数值。TagGroup代表标签对象的集合

18、。TagLabel代表RSView标签的标注对象。Text 代表RSView文本对象。TimeDataDisplay代表RSView时间和日期显示对象。Wedge代表RSView楔型对象。使用SE Client对象模型和显示代码 24-9查看对象使用Object Browser（对象浏览器）可以查看VBA IDE中的RSView SE Client对象。要想打开Object Browser（对象浏览器），可以执行下面任意操作：n 右键点击代码窗口的任何地方，然后点击上下文菜单中的Object Browser。n 在View（查看）菜单中，点击Object Browser。n 按下F2键To d

19、isplay only those objects related to the RSView SE Client, click DisplayClient. 要想仅显示与RSView SE Client相关的对象，点击DisplayClient。To view all RSView SE Client constants, properties, methods, and events, click <globals>. 要想查看所有的RSView SE Client常量、属性、方法和事件，可以点击<globals>。Select any object to view

20、 its properties, methods, and events. 选择任何对象，以便浏览其属性、方法和事件。要想查看全局对象变量，点击第一个列表中的DisplayClient。获取RSView SE Client对象的帮助RSView包含每个RSView SE Client对象的帮助，包含括该对象属性、方法和事件的详细描述。要想打开帮助文件，选择Object Browser（对象浏览器）中的某个条目，然后按下键盘上的F1键，或者点击工具栏上的“?”按钮。24-10 RSView Supervisory Edition用户指南（RSView管理版用户指南）从Object Browser中打开帮助文件1. 打开Object Browser（对象浏览器）。2. 在Object Browser窗口顶部的列表中，点击DisplayClient。3. 在Classes or Members（类或成员）下，选择一个条目，然后按下键盘上的F1键，或者点击工具栏上的“?”按钮。从Code Window中打开帮助文件要想从Code Window（代码窗口）中的某行代码处打开帮助文件，选择RSView对象名或选择RSView对象的属性或方法，然后按下F1键。使用SE Client对象模型和显示代码 24-11从RSView Help Contents窗口打开帮助