第二十四章使用SEClient對(duì)象模型和顯示代碼

1、24章 使用SE Client對(duì)象模型和顯示代碼在圖形顯示畫(huà)面中使用RSView SE Client（RSView SE客戶端）對(duì)象模型和Visual Basic for Applications（VBA）代碼可以定制和擴(kuò)展RSView SE Client的功能。為此用戶可以使用下面的方式：與其它應(yīng)用程序共享數(shù)據(jù) 如果用戶需要經(jīng)常性的在諸如Microsoft Excel或SQL Server等程序中使用RSView數(shù)據(jù)，則可以考慮使用RSView SE Client對(duì)象模型和顯示代碼與VBA以便將RSView與這些應(yīng)用程序進(jìn)行集成。為操作員創(chuàng)建自定義的窗體 用戶可以使用VBA創(chuàng)建自定義的窗體，

2、例如創(chuàng)建一個(gè)操作員可以在運(yùn)行時(shí)進(jìn)行交互的彈出對(duì)話框。用戶還可以使用VBA邏輯來(lái)驗(yàn)證操作員的輸入，例如：確保操作員輸入到一個(gè)數(shù)字輸入框的數(shù)據(jù)在另一個(gè)數(shù)字輸入框的數(shù)值的10%之間波動(dòng)。設(shè)計(jì)直觀的圖形顯示畫(huà)面 使用RSView SE Client對(duì)象模型將ActiveX控件與數(shù)據(jù)結(jié)合在一起，以便在圖形顯示畫(huà)面中使用。例如：在圖形顯示畫(huà)面中使用列表框和組合框以便允許操作員選擇如recipe item（配方項(xiàng)）等選項(xiàng)。操作RSView SE Client窗口 根據(jù)RSView SE Client窗口的尺寸，通過(guò)編寫(xiě)VBA代碼來(lái)排列圖形顯示畫(huà)面。這樣就可以讓用戶的應(yīng)用項(xiàng)目動(dòng)態(tài)地調(diào)整其大小，以便適用不同的屏

3、幕桌面大小和分辨率。使用SE Client對(duì)象模型和顯示代碼 24-1將自定義的信息發(fā)送到診斷日志文件 使用VBA代碼將特定的信息發(fā)送到Diagnostics List（診斷列表）和Diagnostics log file（診斷日志文件），以便記錄運(yùn)行情況和事件。保護(hù)系統(tǒng) 通過(guò)RSView SE Client對(duì)象模型，用戶可以獲得安全信息，得知誰(shuí)在使用該系統(tǒng)，并且通過(guò)使用該安全信息和事件來(lái)控制對(duì)系統(tǒng)的訪問(wèn)。例如：用戶可以編寫(xiě)一段代碼，來(lái)限制用戶在一臺(tái)安全計(jì)算機(jī)上訪問(wèn)特定的圖形顯示畫(huà)面，并且只有當(dāng)與該圖形顯示畫(huà)面具有相同的安全代碼的用戶名登錄時(shí)，才可以顯示該圖形。VBA集成的開(kāi)發(fā)環(huán)境RSView

4、圖形顯示畫(huà)面中包含了Microsoft Visual Basic for Applications（VBA）。使用VBA集成的開(kāi)發(fā)環(huán)境（IDE）可以創(chuàng)建、測(cè)試和調(diào)試VBA過(guò)程，然后運(yùn)行這些過(guò)程來(lái)響應(yīng)在RSView圖形顯示畫(huà)面中觸發(fā)的事件。本章對(duì)IDE進(jìn)行了簡(jiǎn)要的說(shuō)明，但沒(méi)有談及VBA的詳細(xì)信息假定用戶熟悉VBA環(huán)境和Visual Basic編程語(yǔ)言。本章重點(diǎn)談到了VBA相對(duì)于RSView Studio的很獨(dú)特部分，并且講述了如何在RSView圖形顯示畫(huà)面中使用VBA。關(guān)于如何訪問(wèn)VBA的信息的信息，請(qǐng)參閱第24-13頁(yè)的“使用VBA幫助文件”。打開(kāi)IDE窗口1. 打開(kāi)用戶想要編寫(xiě)VBA代碼的圖

5、形顯示畫(huà)面。2. 執(zhí)行下面任意操作：n 在Graphic Displays（圖形顯示）編輯器，點(diǎn)擊View（查看）菜單，然后點(diǎn)擊Visual Basic Editor（Visual Basic編輯器）。24-2 RSView Supervisory Edition用戶指南（RSView管理版用戶指南）n 點(diǎn)擊圖形顯示畫(huà)面中的某個(gè)對(duì)象。在Edit（編輯）菜單中，點(diǎn)擊VBA Code（VBA代碼）。代碼窗口會(huì)打開(kāi)，其內(nèi)容為用戶所選對(duì)象的代碼。n 在Graphic Displays（圖形顯示）編輯器中，點(diǎn)擊Edit（編輯）菜單，然后點(diǎn)擊VBA Code（VBA代碼）。代碼窗口會(huì)打開(kāi)，其內(nèi)容為圖形顯示

6、畫(huà)面的代碼。n 右鍵點(diǎn)擊已打開(kāi)的圖形顯示畫(huà)面，然后點(diǎn)擊其上下文菜單中的VBA Code（VBA代碼），代碼窗口會(huì)打開(kāi)，其內(nèi)容為圖形顯示畫(huà)面的代碼。n 右鍵點(diǎn)擊畫(huà)面中的對(duì)象，然后點(diǎn)擊其上下文菜單中的VBA Code（VBA代碼）。代碼窗口會(huì)打開(kāi)，其內(nèi)容為用戶右鍵點(diǎn)擊對(duì)象的代碼。IDE窗口的組成部分下圖顯示了IDE窗口的主要組成部分。下面會(huì)具體說(shuō)明每個(gè)部分。Project Explorer window 工程瀏覽器窗口Properties window 屬性窗口Procedure or Code window 過(guò)程或代碼窗口使用SE Client對(duì)象模型和顯示代碼 24-3工程瀏覽器窗口對(duì)于每個(gè)圖

7、形顯示畫(huà)面，會(huì)自動(dòng)創(chuàng)建一個(gè)名為DisplayCode的VBA工程。對(duì)于在Graphic Display（圖形顯示）編輯器中打開(kāi)的每個(gè)圖形顯示畫(huà)面，工程瀏覽器都會(huì)顯示該VBA工程。每個(gè)工程都包含一個(gè)RSView Studio Objects（RSView Studio對(duì)象）文件夾。該文件夾包含一個(gè)稱(chēng)為T(mén)hisDisplay的模塊，它代表圖形顯示畫(huà)面。該模塊包含了與畫(huà)面中的對(duì)象進(jìn)行交互的代碼。名為T(mén)hisDisplay的模塊可以包含任何數(shù)量的過(guò)程。用戶可以創(chuàng)建額外的VBA模塊和用戶窗體。要想在這些模塊中使用過(guò)程或者使用用戶窗體，用戶必須從名為T(mén)hisDisplay的模塊中調(diào)用這些過(guò)程。屬性窗口該窗

8、口列出了代碼模塊、類(lèi)模塊和VBA用戶窗體及這些窗體上對(duì)象的屬性設(shè)置。用戶不能夠在RSView中直接調(diào)用窗體。要想使用窗體，可以在名為T(mén)hisDisplay的代碼模塊的過(guò)程中調(diào)用該窗體。過(guò)程或代碼窗口該窗口是用戶可以編寫(xiě)或編輯VBA過(guò)程的窗口。在ThisDisplay中，任何可以觸發(fā)事件的RSView SE Client對(duì)象都在該窗口左手側(cè)的下拉列表中列出。當(dāng)在左側(cè)列表中選擇某個(gè)對(duì)象時(shí)，該對(duì)象的事件會(huì)在右手側(cè)的下拉列表中列出。24-4 RSView Supervisory Edition用戶指南（RSView管理版用戶指南）快速上手步驟步驟1開(kāi)始創(chuàng)建一個(gè)圖形顯示畫(huà)面顯示代碼和圖形顯示畫(huà)面一同保存

9、。在用戶編寫(xiě)可以操作圖形對(duì)象的VBA代碼之前，用戶應(yīng)該首先創(chuàng)建圖形顯示畫(huà)面和圖形對(duì)象。關(guān)于創(chuàng)建圖形顯示畫(huà)面的詳細(xì)信息，請(qǐng)參閱第16章，“創(chuàng)建圖形顯示”。步驟2創(chuàng)建用戶的VBA代碼使用Visual Basic編程語(yǔ)言，可以在名為T(mén)hisDisplay模塊的代碼窗口中創(chuàng)建過(guò)程。關(guān)于創(chuàng)建Visual Basic過(guò)程的信息，請(qǐng)參閱VBA幫助文件。關(guān)于訪問(wèn)VBA幫助文件的信息，請(qǐng)參閱第24-13頁(yè)的“使用VBA幫助”。VBA代碼是如何運(yùn)行的用戶所創(chuàng)建的VBA過(guò)程被調(diào)用以響應(yīng)畫(huà)面事件。當(dāng)用戶在運(yùn)行時(shí)打開(kāi)顯示畫(huà)面后，圖形顯示畫(huà)面事件被觸發(fā)。響應(yīng)該事件的過(guò)程會(huì)自動(dòng)執(zhí)行。關(guān)于過(guò)程過(guò)程被稱(chēng)為代碼塊，它以單元為單位

10、運(yùn)行。過(guò)程的實(shí)例如Visual Basic子程序和函數(shù)。名為T(mén)hisDisplay的模塊可包含任何數(shù)量的過(guò)程，以響應(yīng)畫(huà)面事件。用戶在名為T(mén)hisDisplay的模塊中創(chuàng)建的過(guò)程可以的調(diào)用其它窗體或模塊中的任何過(guò)程。使用SE Client對(duì)象模型和顯示代碼 24-5RSView SE Client對(duì)象模型RSView SE Client對(duì)象模型包含能夠代表RSView SE Client特點(diǎn)的對(duì)象。使用這些對(duì)象，用戶可以通過(guò)編寫(xiě)代碼與RSView SE Client進(jìn)行交互，這些代碼在某個(gè)對(duì)象事件發(fā)生時(shí)運(yùn)行。VBA可以與下列RSView SE Client對(duì)象模型中的對(duì)象進(jìn)行交互：ActiveX

11、Extender ActiveXExtender對(duì)象將由RSView圖形實(shí)現(xiàn)的屬性和方法與ActiveX對(duì)象的屬性和方法進(jìn)行合并。AlarmSummary 代表RSView Alarm Summary對(duì)象。Application 代表RSView SE Client的容器程序。使用這個(gè)對(duì)象來(lái)訪問(wèn)RSView圖形顯示集。Arc 代表RSView弧形對(duì)象。Arrow 代表RSView箭頭對(duì)象。BackspaceButton代表RSView退格按鈕對(duì)象。該對(duì)象如同鍵盤(pán)上的退格鍵一樣工作。BarGraph 代表RSView柱狀顯示對(duì)象Button 代表RSView按鈕對(duì)象。ControlListSel

12、ector代表RSView控件列表選擇器對(duì)象。Display 代表圖形顯示畫(huà)面。DisplayListSelector代表RSView圖形顯示畫(huà)面列表選擇器對(duì)象。Displays 包含多個(gè)圖形顯示畫(huà)面對(duì)象的集合。Element 代表圖形顯示畫(huà)面中的任何對(duì)象。該對(duì)象包含了所有RSView對(duì)象的基本屬性和方法。24-6 RSView Supervisory Edition用戶指南（RSView管理版用戶指南）其成員與每個(gè)圖形對(duì)象的特定成員相結(jié)合，并形成可以在VBA中使用的圖形對(duì)象。Elements 代表多個(gè)元素對(duì)象的集合。Ellipse 代表RSView橢圓對(duì)象。EmbeddedOLE Embed

13、dedOLE對(duì)象代表第三方對(duì)象，如Excel圖表。EndButton 代表RSView結(jié)束按鈕對(duì)象。該對(duì)象如同鍵盤(pán)上的結(jié)束鍵一樣工作。EnterButton 代表RSView回車(chē)按鈕對(duì)象。該對(duì)象如同鍵盤(pán)上的回車(chē)鍵一樣工作。Freehand代表RSView徒手畫(huà)對(duì)象。Gauge代表RSView測(cè)量盤(pán)對(duì)象。Group 代表畫(huà)面上的一套已經(jīng)被組合起來(lái)的對(duì)象。要想編寫(xiě)可以響應(yīng)組事件的VBA代碼，用戶必須在打開(kāi)VBA IDE之前在圖形顯示畫(huà)面中創(chuàng)建組。如果用戶沒(méi)有首先在圖形顯示畫(huà)面中創(chuàng)建組，則組對(duì)象將不會(huì)產(chǎn)生事件，且在運(yùn)行時(shí)為該組編寫(xiě)的代碼也不會(huì)響應(yīng)組事件。HomeButton代表RSView起始按鈕對(duì)

14、象。該對(duì)象如同鍵盤(pán)上的起始鍵一樣工作。Image代表RSView圖像對(duì)象。InterlockedPushButton代表RSView互鎖型按鈕對(duì)象。LatchedPushButton代表RSView鎖定型按鈕對(duì)象。Line代表RSView畫(huà)線對(duì)象。ListIndicator代表RSView列表指示器對(duì)象。使用SE Client對(duì)象模型和顯示代碼 24-7LocalMessageDisplay代表RSView本地信息顯示對(duì)象。MaintainedPushButton代表RSView保持型按鈕對(duì)象。MomentaryPushButton代表RSView瞬時(shí)型按鈕對(duì)象。MoveDownButton代

15、表RSView向下移動(dòng)按鈕對(duì)象。該對(duì)象如同鍵盤(pán)上的向下箭頭鍵一樣工作。MoveLeftButton代表RSView向左移動(dòng)按鈕對(duì)象。該對(duì)象如同鍵盤(pán)上的向左箭頭鍵一樣工作。MoveRightButton代表RSView向右移動(dòng)按鈕對(duì)象。該對(duì)象如同鍵盤(pán)上的向右箭頭鍵一樣工作。MoveUpButton代表RSView向上移動(dòng)按鈕對(duì)象。該對(duì)象如同鍵盤(pán)上的向上箭頭鍵一樣工作。MultistateIndicator代表RSView多態(tài)指示器對(duì)象。MultistatePushButton代表RSView多態(tài)按鈕對(duì)象。NumericDisplay代表RSView數(shù)字顯示對(duì)象。NumericInput代表RSV

16、iew數(shù)字輸入對(duì)象。PageDownButton代表RSView向下翻頁(yè)按鈕對(duì)象。該對(duì)象如同鍵盤(pán)上的向下翻頁(yè)鍵一樣工作。PageUpButton代表RSView向上翻頁(yè)按鈕對(duì)象。該對(duì)象如同鍵盤(pán)上的向上翻頁(yè)鍵一樣工作。Panel 代表RSView面板對(duì)象。Picture代表RSView位圖對(duì)象。PilotCtrlListSelector代表RSView導(dǎo)航控制列表選擇器對(duì)象。24-8 RSView Supervisory Edition用戶指南（RSView管理版用戶指南）Polygon代表RSView多邊形對(duì)象。Polyline代表RSView折線對(duì)象。PolyPolygon代表RSView多

17、個(gè)多邊形對(duì)象。RampPushButton代表RSView斜坡增減型按鈕對(duì)象。Recipe代表RSView配方對(duì)象。RoundedRectangle代表RSView圓角矩形對(duì)象。使用多邊形對(duì)象來(lái)表示矩形。Scale代表RSView比例對(duì)象。在柱狀圖中使用該對(duì)象。StringDisplay代表RSView字符串顯示對(duì)象。StringInput 代表RSView字符串輸入對(duì)象。Symbol代表RSView符號(hào)指示器對(duì)象。StringList 代表特殊字符串的集合。Tag 代表FactoryTalk標(biāo)簽對(duì)象。使用標(biāo)簽對(duì)象可以為標(biāo)簽提供運(yùn)行時(shí)的信息，或設(shè)置標(biāo)簽的數(shù)值。TagGroup代表標(biāo)簽對(duì)象的集合

18、。TagLabel代表RSView標(biāo)簽的標(biāo)注對(duì)象。Text 代表RSView文本對(duì)象。TimeDataDisplay代表RSView時(shí)間和日期顯示對(duì)象。Wedge代表RSView楔型對(duì)象。使用SE Client對(duì)象模型和顯示代碼 24-9查看對(duì)象使用Object Browser（對(duì)象瀏覽器）可以查看VBA IDE中的RSView SE Client對(duì)象。要想打開(kāi)Object Browser（對(duì)象瀏覽器），可以執(zhí)行下面任意操作：n 右鍵點(diǎn)擊代碼窗口的任何地方，然后點(diǎn)擊上下文菜單中的Object Browser。n 在View（查看）菜單中，點(diǎn)擊Object Browser。n 按下F2鍵To d

19、isplay only those objects related to the RSView SE Client, click DisplayClient. 要想僅顯示與RSView SE Client相關(guān)的對(duì)象，點(diǎn)擊DisplayClient。To view all RSView SE Client constants, properties, methods, and events, click <globals>. 要想查看所有的RSView SE Client常量、屬性、方法和事件，可以點(diǎn)擊<globals>。Select any object to view

20、 its properties, methods, and events. 選擇任何對(duì)象，以便瀏覽其屬性、方法和事件。要想查看全局對(duì)象變量，點(diǎn)擊第一個(gè)列表中的DisplayClient。獲取RSView SE Client對(duì)象的幫助RSView包含每個(gè)RSView SE Client對(duì)象的幫助，包含括該對(duì)象屬性、方法和事件的詳細(xì)描述。要想打開(kāi)幫助文件，選擇Object Browser（對(duì)象瀏覽器）中的某個(gè)條目，然后按下鍵盤(pán)上的F1鍵，或者點(diǎn)擊工具欄上的“?”按鈕。24-10 RSView Supervisory Edition用戶指南（RSView管理版用戶指南）從Object Browser中打開(kāi)幫助文件1. 打開(kāi)Object Browser（對(duì)象瀏覽器）。2. 在Object Browser窗口頂部的列表中，點(diǎn)擊DisplayClient。3. 在Classes or Members（類(lèi)或成員）下，選擇一個(gè)條目，然后按下鍵盤(pán)上的F1鍵，或者點(diǎn)擊工具欄上的“?”按鈕。從Code Window中打開(kāi)幫助文件要想從Code Window（代碼窗口）中的某行代碼處打開(kāi)幫助文件，選擇RSView對(duì)象名或選擇RSView對(duì)象的屬性或方法，然后按下F1鍵。使用SE Client對(duì)象模型和顯示代碼 24-11從RSView Help Contents窗口打開(kāi)幫助