第二十四章使用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 与这些应用程序进行集成。为操

2、作员创建自定义的窗体 用户可以使用 VBA 创建自定义的窗体，例如创建一个操作员 可以在运行 时进行交互的弹出对话框。用户还可以使用 VBA 逻辑来验证操作员的输入，例 如：确保操作员输入 到一个数字输入框的数据在另一个数字输入框的数值的10% 之间波动。设计直观的图形显示画面 使用 RSView SE Client 对象模型将 ActiveX 控件与数据结合在一 起，以 便在图形显示画面中使用。 例如： 在图形显示画面中使用列表框和组合框以便允许操 作员选择如 recipe item （配方项）等选项。操作 RSView SE Client 窗口 根据 RSView SE Client 窗口

3、的尺寸， 通过编写 VBA 代码来排 列图形 显示画面。 这样就可以让用户的应用项目动态地调整其大小， 以便适用不同的屏幕桌 面大小和分辨 率。将自定义的信息发送到诊断日志文件 使用 VBA 代码将特定的信息发送到 Diagnostics List （诊断列 表）和 Diagnostics log file （诊断日志文件） ，以便记录运行情况和事件。保护系统 通过 RSView SE Client 对象模型，用户可以获得安全信息，得知谁在使用该系统， 并且通过使用该安全信息和事件来控制对系统的访问例如： 用户可以编写一段代码，来限 制用户在一台安全计算机上访问特定的图形显示画面，并且只有当与

4、该图形显示画面具有相同的安全代码的Visual Basic EditorVisual Basic 编辑器）。用户名登录时，才可以显示该图形VBA 集成的开发环境RSView 图形显示画面中包含了 Microsoft Visual Basic for Applications （ VBA ）。使用 VBA 集 成 的开发环境 （IDE ）可以创建、 测试和调试 VBA 过程，然后运行这些过程来响应在 RSView 图形 显示画面中触发的事件。本章对 IDE 进行了简要的说明，但没有谈及 VBA 的详细信息假定用户熟悉 VBA 环境 和 Visual Basic 编程语言。 本章重点谈到了 VBA

5、 相对于 RSView Studio 的很独特部分， 并且 讲述了如何在 RSView 图形显示画面中使用 VBA 。关于如何访问 VBA 的信息的信息，请参阅第 24-13 页的“使用 VBA 帮助文件”。 打开 IDE 窗口1. 打开用户想要编写 VBA 代码的图形显示画面。2. 执行下面任意操作：在 Graphic Displays （图形显示）编辑器， 点击 View （查看） 菜单， 然后点击点击图形显示画面中的某个对象。在Edit （编辑）菜单中，点击 VBA Code （VBA代码）。代码窗口会打开，其内容为用户所选对象的代码。在Graphic Displays （图形显示）编辑

6、器中，点击 Edit （编辑）菜单，然后点击 VBA Code（VBA代码）。代码窗口会打开，其内容为图形显示画面的代码。右键点击已打开的图形显示画面，然后点击其上下文菜单中的VBA Code （VBA代码），代码窗口会打开，其内容为图形显示画面的代码。右键点击画面中的对象，然后点击其上下文菜单中的口会 VBA Code （ VBA代码）。代码窗打开，其内容为用户右键点击对象的代码。IDE窗口的组成部分F图显示了 IDE窗口的主要组成部分。下面会具体说明每个部分。Frojed Explorer血wPropijrtie- wiridoAProcedure crCode -.v in doAPro

7、ject Explorer wi ndow-工程浏览器窗口Properties win dow -属性窗口Procedure or Code window-过程或代码窗口工程浏览器窗口 对于每个图形显示画面，会自动创建一个名为 DisplayCode 的 VBA 工程。对于在 Graphic Display （图形显示）编辑器中打开的每个图形显示画面， 工程浏览器都会显示该 VBA 工程。每个工程都包含一个 RSView Studio Objects （ RSView Studio 对象）文件夹。该文件夹包含 一个称 为 ThisDisplay 的模块，它代表图形显示画面。该模块包含了与画面中

8、的对象进行交 互的代码。名为 ThisDisplay 的模块可以包含任何数量的过程。用户可以创建额外的 VBA 模块和用户窗体。 要想在这些模块中使用过程或者使用用户窗体， 用户必 须从名为 ThisDisplay 的模块中调用这些过程。属性窗口该窗口列出了代码模块、类模块和 VBA 用户窗体及这些窗体上对象的属性设置。用户不能 够在 RSView 中直接调用窗体。要想使用窗体，可以在名为 ThisDisplay 的代码模块的过程 中调用该窗 体。过程或代码窗口该窗口是用户可以编写或编辑 VBA 过程的窗口。在 ThisDisplay 中，任何可以触发事件的 RSView SE Client

9、对象都在该窗口左手侧的下拉列表中列出。 当在左侧列表中选择某个对象 时，该对象的事 件会在右手侧的下拉列表中列出。快速上手步骤步骤 1开始创建一个图形显示画面 显示代码和图形显示画面一同保存。在用户编写可以操作图形 对象的 VBA 代码之前，用户 应该首先创建图形显示画面和图形对象。关于创建图形显示画面的详细信息，请参阅第16 章，“创建图形显示” 。步骤 2 创建用户的 VBA 代码使用 Visual Basic 编程语言，可以在名为 ThisDisplay 模块的代码窗口中创建过程。关于创建 Visual Basic 过程的信息， 请参阅 VBA 帮助文件。关于访问 VBA 帮助文件的信息

10、， 请 参阅第 24-13 页的“使用 VBA 帮助”。VBA 代码是如何运行的用户所创建的 VBA 过程被调用以响应画面事件。当用户在运行时打开显示画面后，图形显 示画面事 件被触发。响应该事件的过程会自动执行。关于过程过程被称为代码块，它以单元为单位运行。过程的实例如 Visual Basic 子程序和函数。名为 ThisDisplay 的模块可包含任何数量的过程，以响应画面事件。用户在名为 ThisDisplay 的模块中创建的过程可以的调用其它窗体或模块中的任何过程。RSView SE Client 对象模型RSView SE Client 对象模型包含能够代表 RSView SE C

11、lient 特点的对象。使用这些对象，用 户可以 通过编写代码与 RSView SE Client 进行交互，这些代码在某个对象事件发生时运行。VBA 可以与下列 RSView SE Client 对象模型中的对象进行交互：ActiveXExtender ActiveXExtender 对象将由 RSView 图形实现的属性和方法与 ActiveX 对 象的属性 和方法进行合并。AlarmSummary 代表 RSView Alarm Summary 对象。Application 代表 RSView SE Client 的容器程序。 使用这个对象来访问 RSView 图形显示集。Arc 代表

12、RSView 弧形对象。Arrow 代表 RSView 箭头对象。BackspaceButton 代表 RSView 退格按钮对象。该对象如同键盘上的退格键一样工作。BarGraph 代表 RSView 柱状显示对象Button 代表 RSView 按钮对象。ControlListSelector 代表 RSView 控件列表选择器对象。Display 代表图形显示画面。DisplayListSelector 代表 RSView 图形显示画面列表选择器对象。Displays 包含多个图形显示画面对象的集合。Element 代表图形显示画面中的任何对象。 该对象包含了所有 RSView 对象的基

13、本属性和方 法。其成员与每个图形对象的特定成员相结合，并形成可以在 VBA 中使用的图形对象。Elements 代表多个元素对象的集合。Ellipse 代表 RSView 椭圆对象。EmbeddedOLE EmbeddedOLE 对象代表第三方对象，如 Excel 图表。EndButton 代表 RSView 结束按钮对象。该对象如同键盘上的结束键一样工作。EnterButton 代表 RSView 回车按钮对象。该对象如同键盘上的回车键一样工作。Freehand 代表 RSView 徒手画对象。Gauge 代表 RSView 测量盘对象。Group 代表画面上的一套已经被组合起来的对象。要想

14、编写可以响应组事件的 VBA 代码， 用户必须 在打开 VBA IDE 之前在图形显示画面中创建组。如果用户没有首先在图形显示画 面中创建组，则组 对象将不会产生事件，且在运行时为该组编写的代码也不会响应组事件。HomeButton 代表 RSView 起始按钮对象。该对象如同键盘上的起始键一样工作。Image 代表 RSView 图像对象。InterlockedPushButton 代表 RSView 互锁型按钮对象。LatchedPushButton 代表 RSView 锁定型按钮对象。Line 代表 RSView 画线对象。ListIndicator 代表 RSView 列表指示器对象。

15、LocalMessageDisplay 代表 RSView 本地信息显示对象。MaintainedPushButton 代表 RSView 保持型按钮对象。MomentaryPushButton 代表 RSView 瞬时型按钮对象。MoveDownButton 代表 RSView 向下移动按钮对象。 该对象如同键盘上的向下箭头键一样工 作。MoveLeftButton 代表 RSView 向左移动按钮对象。该对象如同键盘上的向左箭头键一样工 作。MoveRightButton 代表 RSView 向右移动按钮对象。 该对象如同键盘上的向右箭头键一样工 作。MoveUpButton 代表 RSV

16、iew 向上移动按钮对象。 该对象如同键盘上的向上箭头键一样工作。MultistateIndicator 代表 RSView 多态指示器对象。MultistatePushButton 代表 RSView 多态按钮对象。NumericDisplay 代表 RSView 数字显示对象。NumericInput 代表 RSView 数字输入对象PageDownButton 代表 RSView 向下翻页按钮对象。该对象如同键盘上的向下翻页键一样工PageUpButton 代表 RSView 向上翻页按钮对象。 该对象如同键盘上的向上翻页键一样工作。 Panel 代表 RSView 面板对象。Pictu

17、re 代表 RSView 位图对象。PilotCtrlListSelector 代表 RSView 导航控制列表选择器对象。Polygon 代表 RSView 多边形对象。Polyline 代表 RSView 折线对象。PolyPolygon 代表 RSView 多个多边形对象。RampPushButton 代表 RSView 斜坡增减型按钮对象。Recipe 代表 RSView 配方对象。RoundedRectangle 代表 RSView 圆角矩形对象。使用多边形对象来表示矩形。Scale 代表 RSView 比例对象。在柱状图中使用该对象。StringDisplay 代表 RSView

18、字符串显示对象。StringInput 代表 RSView 字符串输入对象。Symbol 代表 RSView 符号指示器对象。StringList 代表特殊字符串的集合。的数值。Tag 代表 FactoryTalk 标签对象。使用标签对象可以为标签提供运行时的信息，或设置标签TagGroup 代表标签对象的集合。TagLabel 代表 RSView 标签的标注对象。Text 代表 RSView 文本对象。TimeDataDisplay 代表 RSView 时间和日期显示对象。Wedge 代表 RSView 楔型对象。查看对象 使用Object Browser （对象浏览器）可以查看VBA ID

19、E中的RSView SE Client对象要想打开Object Browser （对象浏览器），可以执行下面任意操作：右键点击代码窗口的任何地方，然后点击上下文菜单中的Object Browser在View （查看）菜单中，点击 Object Browser。按下F2键- IxlTo display orly Uiosd objBcte related to the RSV ew SE Clie nt, clicx Di&playC iorcashesIn 订私 All RS7ew 8E Cl tent con sta nts, propertiesnneihtxfe, and 凶苛丫 .CI

20、IGK vglrhAlFiAltmSu nnn 3*YApolicjii nnAnwen bers oc-gubatis3 卢sptayrifles tyyt ziCflti&nAppi raunnbNmf眨 Ai(0W虚 BAKpacAButiori克 ttargrsp n3eleci an/ object vi&w ibprupcriitfs. methods, andeve nts.虐 riLttcn睜 iiiACJWCitegoivGor 錚 cliAcrivihSfrVeilvCoiKd iActiW? MgorvC o nuTi a nd illMtMlvc ategoiyOomn

21、u nl cauo n Hi Activity HtegoryC u * J m 1R wgot n usimz I i Ai Hwib/C gaiyC u m 3:illAttlvitvcu sb m 4iliActivfUCirtwciorvFe nnflr*徉垃 ccnrausiseedor腔 Dkpia/垃 DupiarLisSeietwr克 Displays:HActMiyC Hie gorrsu D system liArHAiilvA Rtp goryTag Fend iliMMtvCateQorylagViArte iliActi ) fllv8ewrityE nor丨Lbra

22、iyTo display on ly those objects related to the RSView SE Clie nt, click DisplayClie nt. RSView SE Client 相关的对象，点击DisplayClient。要想仅显示与To view all RSView SE Clie nt con sta n ts, properties, methods, and eve n ts, click .要想查看所有的RSView SE Client常量、属性、方法和事件，可以点击vglobals。Select any object to view its pr

23、operties, methods, and eve nts. 和事件。选择任何对象，以便浏览其属性、方法要想查看全局对象变量，点击第一个列表中的获取RSView SE Client对象的帮助DisplayClient。RSView包含每个RSView SE Client对象的帮助，包含括该对象属性、方法和事件的详细描述。要想打开帮助文件，选择 Object Browser （对象浏览器）中的某个条目，然后按下键盘上的F1键，或者点击工具栏上的“ ？ ”按钮。从 Object Browser 中打开帮助文件1. 打开 Object Browser （对象浏览器）2. 在 Object Brow

24、ser 窗口顶部的列表中，点击 DisplayClient3. 在 Classes orMembers （类或成员）下，选择一个条目，然后按下键盘上的F1 键，或者点击工具栏上的“ ？”按钮。-n|y|卜衽卩砂Client弋1鬲1知卑11 2皿Closes-nlxiQ AtiYeAEA nder 由 AlarmSurrmar/ 曲 ApplicdflonArc 也 Arrow 園Back5pac?Button辽 I 6 arg rapr迫譚 cllActhdfcCatogarvC or 歸 cliAttN 也 CcntrolL 曲 Display 由Sel应Butt on object7he

25、Qutlon objevt repr&seritathe in tri nsic butt oncbject His n ot 3 rrsafable rtijfidButt on objects are accessible via an He merits collecti onDi: ?plfl(y=.The object-spei ific properties and methods for the Butt on object e ruerAed withthe Element cbjectsproperties and meihucs m(j&d ccjeci is wtiat

26、me user wrtiisee whe n direcuy ing th 日 object from VBA usrig the abjscTs nan A. Clickferti&s o r Methods fin kabwe to see the object-specific o perties ormethods.Class Butt onMcrwbA ofR?latod topicslit, qej 吨Flemu nt objectAn vbied that rsiresent? a SElvm 甘 nt$ uull 匕匚 lion从Code Window中打开帮助文件RSView

27、对象名或选要想从Code Window （代码窗口）中的某行代码处打开帮助文件，选择 择RSView对象的属性或方法，然后按下F1键。使用SE Client对象模型和显示代码24-11从RSView Help Contents 窗口打开帮助文件1. 在RSView菜单栏，点击 Help （帮助），然后点击 Contents （内容）2. 在Contents （内容）列表中，双击Creati ng Graphic Displays（创建图形显示画面）。3. 在话主题列表中，执行下面任意操作：要想查看话题概述列表，双击Creati ng VBA Display Code（创建VBA显示代码）要想查

28、看对象的详细信息，双击 RSView SE客户端对象模型）。Us ing the RSView SE Clie nt Object Model(使用RSView Supervisory Edition Studio HelpHideIn dex Search FavoritesPrint OptionsWelcome to RSView Supervisory Editi onCrealng (irAptiic DispLisjJ 0 UMtrtgaid /Animating日记 |Aboutcode? About the Visu al Bas : ic f -J Working th th

29、e VBA e -団V 別 irg object? in Me q 巴 Cicatc and Icsl on ever 刑Filer Pending in VRA ut 3 Pioctduie queui ng and 电Eno rka ndi ng ewaw piesQJ Usi ng UieRSViewSEClie nl*AL MJUUI- Tiappable endre 金Applicatior Obect Graph c Obiecte * TAg Object 牟 电 Cprjlfl nAHsview aupepisory Editioncorset or several pieces of softwareVOL can u se to bu I d autornation appHcetions. Depending on the pArticjlarsoftvafe pAcloges you ourchased and in silled you will have one or more or these pieces orsorware:RSView studio i