第二十四章使用SE Client对象模型和显示代码.docx

第二十四章使用SE Client对象模型和显示代码.docx

《第二十四章使用SE Client对象模型和显示代码.docx》由会员分享，可在线阅读，更多相关《第二十四章使用SE Client对象模型和显示代码.docx（13页珍藏版）》请在冰点文库上搜索。

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

24章使用SEClient对象模型和显示代码

在图形显示画面中使用RSViewSEClient（RSViewSE客户端）对象模型和VisualBasicforApplications（VBA）代码可以定制和扩展RSViewSEClient的功能。

为此用户可以使用下面的方式：

与其它应用程序共享数据如果用户需要经常性的在诸如MicrosoftExcel或SQLServer等程序中使用RSView数据，则可以考虑使用RSViewSEClient对象模型和显示代码与VBA以便将RSView与这些应用程序进行集成。

为操作员创建自定义的窗体用户可以使用VBA创建自定义的窗体，例如创建一个操作员可以在运行时进行交互的弹出对话框。

用户还可以使用VBA逻辑来验证操作员的输入，例如：

确保操作员输入到一个数字输入框的数据在另一个数字输入框的数值的10%之间波动。

设计直观的图形显示画面使用RSViewSEClient对象模型将ActiveX控件与数据结合在一起，以便在图形显示画面中使用。

例如：

在图形显示画面中使用列表框和组合框以便允许操作员选择如recipeitem（配方项）等选项。

操作RSViewSEClient窗口根据RSViewSEClient窗口的尺寸，通过编写VBA代码来排列图形显示画面。

这样就可以让用户的应用项目动态地调整其大小，以便适用不同的屏幕桌面大小和分辨率。

使用SEClient对象模型和显示代码24-1

将自定义的信息发送到诊断日志文件使用VBA代码将特定的信息发送到DiagnosticsList（诊断列表）和Diagnosticslogfile（诊断日志文件），以便记录运行情况和事件。

保护系统通过RSViewSEClient对象模型，用户可以获得安全信息，得知谁在使用该系统，并且通过使用该安全信息和事件来控制对系统的访问。

例如：

用户可以编写一段代码，来限制用户在一台安全计算机上访问特定的图形显示画面，并且只有当与该图形显示画面具有相同的安全代码的用户名登录时，才可以显示该图形。

VBA集成的开发环境

RSView图形显示画面中包含了MicrosoftVisualBasicforApplications（VBA）。

使用VBA集成的开发环境（IDE）可以创建、测试和调试VBA过程，然后运行这些过程来响应在RSView图形显示画面中触发的事件。

本章对IDE进行了简要的说明，但没有谈及VBA的详细信息——假定用户熟悉VBA环境和VisualBasic编程语言。

本章重点谈到了VBA相对于RSViewStudio的很独特部分，并且讲述了如何在RSView图形显示画面中使用VBA。

关于如何访问VBA的信息的信息，请参阅第24-13页的“使用VBA帮助文件”。

打开IDE窗口

1.打开用户想要编写VBA代码的图形显示画面。

2.执行下面任意操作：

⏹在GraphicDisplays（图形显示）编辑器，点击View（查看）菜单，然后点击VisualBasicEditor（VisualBasic编辑器）。

24-2RSViewSupervisoryEdition用户指南（RSView管理版用户指南）

⏹

点击图形显示画面中的某个对象。

在Edit（编辑）菜单中，点击VBACode（VBA代码）。

代码窗口会打开，其内容为用户所选对象的代码。

⏹在GraphicDisplays（图形显示）编辑器中，点击Edit（编辑）菜单，然后点击VBACode（VBA代码）。

代码窗口会打开，其内容为图形显示画面的代码。

⏹右键点击已打开的图形显示画面，然后点击其上下文菜单中的VBACode（VBA代码），代码窗口会打开，其内容为图形显示画面的代码。

⏹右键点击画面中的对象，然后点击其上下文菜单中的VBACode（VBA代码）。

代码窗口会打开，其内容为用户右键点击对象的代码。

IDE窗口的组成部分

下图显示了IDE窗口的主要组成部分。

下面会具体说明每个部分。

ProjectExplorerwindow–工程浏览器窗口

Propertieswindow–属性窗口

ProcedureorCodewindow–过程或代码窗口

使用SEClient对象模型和显示代码24-3

工程浏览器窗口

对于每个图形显示画面，会自动创建一个名为DisplayCode的VBA工程。

对于在GraphicDisplay（图形显示）编辑器中打开的每个图形显示画面，工程浏览器都会显示该VBA工程。

每个工程都包含一个RSViewStudioObjects（RSViewStudio对象）文件夹。

该文件夹包含一个称为ThisDisplay的模块，它代表图形显示画面。

该模块包含了与画面中的对象进行交互的代码。

名为ThisDisplay的模块可以包含任何数量的过程。

用户可以创建额外的VBA模块和用户窗体。

要想在这些模块中使用过程或者使用用户窗体，用户必须从名为ThisDisplay的模块中调用这些过程。

属性窗口

该窗口列出了代码模块、类模块和VBA用户窗体及这些窗体上对象的属性设置。

用户不能够在RSView中直接调用窗体。

要想使用窗体，可以在名为ThisDisplay的代码模块的过程中调用该窗体。

过程或代码窗口

该窗口是用户可以编写或编辑VBA过程的窗口。

在ThisDisplay中，任何可以触发事件的RSViewSEClient对象都在该窗口左手侧的下拉列表中列出。

当在左侧列表中选择某个对象时，该对象的事件会在右手侧的下拉列表中列出。

24-4RSViewSupervisoryEdition用户指南（RSView管理版用户指南）

快速上手步骤

步骤1——开始创建一个图形显示画面

显示代码和图形显示画面一同保存。

在用户编写可以操作图形对象的VBA代码之前，用户应该首先创建图形显示画面和图形对象。

关于创建图形显示画面的详细信息，请参阅第16章，“创建图形显示”。

步骤2——创建用户的VBA代码

使用VisualBasic编程语言，可以在名为ThisDisplay模块的代码窗口中创建过程。

关于创建VisualBasic过程的信息，请参阅VBA帮助文件。

关于访问VBA帮助文件的信息，请参阅第24-13页的“使用VBA帮助”。

VBA代码是如何运行的

用户所创建的VBA过程被调用以响应画面事件。

当用户在运行时打开显示画面后，图形显示画面事件被触发。

响应该事件的过程会自动执行。

关于过程

过程被称为代码块，它以单元为单位运行。

过程的实例如VisualBasic子程序和函数。

名为ThisDisplay的模块可包含任何数量的过程，以响应画面事件。

用户在名为ThisDisplay的模块中创建的过程可以的调用其它窗体或模块中的任何过程。

使用SEClient对象模型和显示代码24-5

RSViewSEClient对象模型

RSViewSEClient对象模型包含能够代表RSViewSEClient特点的对象。

使用这些对象，用户可以通过编写代码与RSViewSEClient进行交互，这些代码在某个对象事件发生时运行。

VBA可以与下列RSViewSEClient对象模型中的对象进行交互：

ActiveXExtenderActiveXExtender对象将由RSView图形实现的属性和方法与ActiveX对象的属性和方法进行合并。

AlarmSummary代表RSViewAlarmSummary对象。

Application代表RSViewSEClient的容器程序。

使用这个对象来访问RSView图形显示集。

Arc代表RSView弧形对象。

Arrow代表RSView箭头对象。

BackspaceButton代表RSView退格按钮对象。

该对象如同键盘上的退格键一样工作。

BarGraph代表RSView柱状显示对象

Button代表RSView按钮对象。

ControlListSelector代表RSView控件列表选择器对象。

Display代表图形显示画面。

DisplayListSelector代表RSView图形显示画面列表选择器对象。

Displays包含多个图形显示画面对象的集合。

Element代表图形显示画面中的任何对象。

该对象包含了所有RSView对象的基本属性和方法。

24-6RSViewSupervisoryEdition用户指南（RSView管理版用户指南）

其成员与每个图形对象的特定成员相结合，并形成可以在VBA中使用的图形对象。

Elements代表多个元素对象的集合。

Ellipse代表RSView椭圆对象。

EmbeddedOLEEmbeddedOLE对象代表第三方对象，如Excel图表。

EndButton代表RSView结束按钮对象。

该对象如同键盘上的结束键一样工作。

EnterButton代表RSView回车按钮对象。

该对象如同键盘上的回车键一样工作。

Freehand代表RSView徒手画对象。

Gauge代表RSView测量盘对象。

Group代表画面上的一套已经被组合起来的对象。

要想编写可以响应组事件的VBA代码，用户必须在打开VBAIDE之前在图形显示画面中创建组。

如果用户没有首先在图形显示画面中创建组，则组对象将不会产生事件，且在运行时为该组编写的代码也不会响应组事件。

HomeButton代表RSView起始按钮对象。

该对象如同键盘上的起始键一样工作。

Image代表RSView图像对象。

InterlockedPushButton代表RSView互锁型按钮对象。

LatchedPushButton代表RSView锁定型按钮对象。

Line代表RSView画线对象。

ListIndicator代表RSView列表指示器对象。

使用SEClient对象模型和显示代码24-7

LocalMessageDisplay代表RSView本地信息显示对象。

MaintainedPushButton代表RSView保持型按钮对象。

MomentaryPushButton代表RSView瞬时型按钮对象。

MoveDownButton代表RSView向下移动按钮对象。

该对象如同键盘上的向下箭头键一样工作。

MoveLeftButton代表RSView向左移动按钮对象。

该对象如同键盘上的向左箭头键一样工作。

MoveRightButton代表RSView向右移动按钮对象。

该对象如同键盘上的向右箭头键一样工作。

MoveUpButton代表RSView向上移动按钮对象。

该对象如同键盘上的向上箭头键一样工作。

MultistateIndicator代表RSView多态指示器对象。

MultistatePushButton代表RSView多态按钮对象。

NumericDisplay代表RSView数字显示对象。

NumericInput代表RSView数字输入对象。

PageDownButton代表RSView向下翻页按钮对象。

该对象如同键盘上的向下翻页键一样工作。

PageUpButton代表RSView向上翻页按钮对象。

该对象如同键盘上的向上翻页键一样工作。

Panel代表RSView面板对象。

Picture代表RSView位图对象。

PilotCtrlListSelector代表RSView导航控制列表选择器对象。

24-8RSViewSupervisoryEdition用户指南（RSView管理版用户指南）

Polygon代表RSView多边形对象。

Polyline代表RSView折线对象。

PolyPolygon代表RSView多个多边形对象。

RampPushButton代表RSView斜坡增减型按钮对象。

Recipe代表RSView配方对象。

RoundedRectangle代表RSView圆角矩形对象。

使用多边形对象来表示矩形。

Scale代表RSView比例对象。

在柱状图中使用该对象。

StringDisplay代表RSView字符串显示对象。

StringInput代表RSView字符串输入对象。

Symbol代表RSView符号指示器对象。

StringList代表特殊字符串的集合。

Tag代表FactoryTalk标签对象。

使用标签对象可以为标签提供运行时的信息，或设置标签

的数值。

TagGroup代表标签对象的集合。

TagLabel代表RSView标签的标注对象。

Text代表RSView文本对象。

TimeDataDisplay代表RSView时间和日期显示对象。

Wedge代表RSView楔型对象。

使用SEClient对象模型和显示代码24-9

查看对象

使用ObjectBrowser（对象浏览器）可以查看VBAIDE中的RSViewSEClient对象。

要想打开ObjectBrowser（对象浏览器），可以执行下面任意操作：

⏹右键点击代码窗口的任何地方，然后点击上下文菜单中的ObjectBrowser。

⏹在View（查看）菜单中，点击ObjectBrowser。

⏹按下F2键

TodisplayonlythoseobjectsrelatedtotheRSViewSEClient,clickDisplayClient.

要想仅显示与RSViewSEClient相关的对象，点击DisplayClient。

ToviewallRSViewSEClientconstants,properties,methods,andevents,click.

要想查看所有的RSViewSEClient常量、属性、方法和事件，可以点击。

Selectanyobjecttoviewitsproperties,methods,andevents.

选择任何对象，以便浏览其属性、方法和事件。

要想查看全局对象变量，点击第一个列表中的DisplayClient。

获取RSViewSEClient对象的帮助

RSView包含每个RSViewSEClient对象的帮助，包含括该对象属性、方法和事件的详细描述。

要想打开帮助文件，选择ObjectBrowser（对象浏览器）中的某个条目，然后按下键盘上的F1键，或者点击工具栏上的“?

”按钮。

24-10RSViewSupervisoryEdition用户指南（RSView管理版用户指南）

从ObjectBrowser中打开帮助文件

1.打开ObjectBrowser（对象浏览器）。

2.在ObjectBrowser窗口顶部的列表中，点击DisplayClient。

3.在ClassesorMembers（类或成员）下，选择一个条目，然后按下键盘上的F1键，或者点击工具栏上的“?

”按钮。

从CodeWindow中打开帮助文件

要想从CodeWindow（代码窗口）中的某行代码处打开帮助文件，选择RSView对象名或选择RSView对象的属性或方法，然后按下F1键。

使用SEClient对象模型和显示代码24-11

从RSViewHelpContents窗口打开帮助文件

1.在RSView菜单栏，点击Help（帮助），然后点击Contents（内容）。

2.在Contents（内容）列表中，双击CreatingGraphicDisplays（创建图形显示画面）。

3.在话主题列表中，执行下面任意操作：

⏹要想查看话题概述列表，双击CreatingVBADisplayCode（创建VBA显示代码）。

⏹要想查看对象的详细信息，双击UsingtheRSViewSEClientObjectModel（使用RSViewSE客户端对象模型）。

VBA代码和RSViewClientObjectModel的帮助主题，会在RSViewHelp（RSView帮助）窗口顶部单独的窗口中打开。

要想返回到RSViewHelp窗口，可以关闭SEClientObjectModelHelp（SE客户端对象模型帮助）窗口。

24-12RSViewSupervisoryEdition用户指南（RSView管理版用户指南）

使用VBA帮助文件

VBA帮助文件伴随VBA而来。

要想访问该帮助文件，可以在VBAIDE中执行下面任意操作：

⏹点击Help（帮助）菜单，然后点击MicrosoftVisualBasicHelp（MicrosoftVisualBasic帮助）。

⏹在IDE的任何区域，按下F1键。

VBA文档

如果用户还不熟悉VisualBasic，用户也许需要阅读下列Microsoft出版物：

⏹《VisualBasic快速上手》

⏹《VisualBasic程序员指南》

使用SEClient对象模型和显示代码24-13