NET控件使用說明書

14/20.NET控件使用說明書第2版2014/02/24

目錄1． .NET控件概要 32． 推薦動(dòng)作環(huán)境 33． 必要環(huán)境 34． 對(duì)應(yīng)開發(fā)語(yǔ)言 35． 功能概要 36． 使用上的限制 47． 使用步驟 47-1．在應(yīng)用中添加控件 47-2．應(yīng)用的執(zhí)行 78. 附錄 98-1..NET控件的使用方法 98-2.Macro_DirectExecute可以執(zhí)行宏指令一覽 14

.NET控件概要.NET控件是為了可以簡(jiǎn)單得在用Microsoft?VisualStudio?制作的應(yīng)用里顯示FH/FZ5的測(cè)量圖像、測(cè)量結(jié)果而存在的自定義控件。只要在應(yīng)用上配置該自定義控件，即可顯示出FH/FZ5的測(cè)量圖像、測(cè)量結(jié)果。推薦動(dòng)作環(huán)境CPU ：搭載IntelPentiumProcessor(SSE2以上)OS ：Windows7Professional(32bit)Windows7Enterprise(32bit)Windows7Ultimate(32bit).NetFramework ：.NetFramework3.5以上內(nèi)存 ：2GB以上のRAM硬盤空間 ：2GB以上顯示畫面 ：XGA(1024×768),TrueColor(32bit)以上必備環(huán)境Microsoft?VisualStudio?2008,2010或者、2012Professional模擬軟件版本為FH/FZ5ver.5.20以上固件版本為FH/FZ5ver.5.20以上的FH/FZ5視覺控制器開發(fā)語(yǔ)言VisualBasic.NETVisualC#功能概要.NET控件的自定義控件構(gòu)成如下。控件說明CoreRA制作的應(yīng)用與連接的FH/FZ5的模擬軟件或者視覺控制器之間的動(dòng)作來往。使用其他.NET控件時(shí)務(wù)必進(jìn)行追加。ImageWindow在應(yīng)用上顯示指定用戶的測(cè)量圖像。TextWindow顯示指定用戶的測(cè)量結(jié)果。PanDAWindow操作/顯示遠(yuǎn)程操作中的主畫面。Microsoft的各產(chǎn)品是美國(guó)MicrosoftCorporation的注冊(cè)商標(biāo)。Pentium是美國(guó)IntelCorporation的注冊(cè)商標(biāo)。本操作使用說明書里記載的公司名稱以及產(chǎn)品名稱為各個(gè)公司的商標(biāo)或者注冊(cè)商標(biāo)。

使用上的限制.NET控件在使用時(shí)存在以下限制，請(qǐng)注意?！鯢H/FZ5的動(dòng)作模式與FH/FZ5連接時(shí)，請(qǐng)不要采用以下2個(gè)動(dòng)作模式，請(qǐng)采用其他動(dòng)作模式。以下動(dòng)作模式下.NET控制無法正確運(yùn)行。?高速（觸發(fā)間隔優(yōu)先）?Non-stop調(diào)整■宏指令在CoreRA控件的Macro_DirectExecute下，請(qǐng)不要使用“８－２．Macro_DirectExecute可以執(zhí)行的宏指令一覽”以外的指令”“。在一個(gè)Process下連接著多臺(tái)FH/FZ5時(shí)，與Macro_DirectExecute等宏指令相關(guān)的功能無法使用。使用步驟７－１．在應(yīng)用中添加控件以下為在應(yīng)用窗體中添加.NET控件的方法的說明。【操作步驟】打開VisualStudio?窗體應(yīng)用的項(xiàng)目。為了將.NET控件添加到工件箱中，將“FZ-Control.dll”拖放到VisualStudio?的工具箱”全部”的部分（下圖紅框內(nèi)）。配置并安裝添加到應(yīng)用窗體的.NET控件?？梢栽诠ぞ呦溥x擇要添加的控件，并拖放到應(yīng)用窗體。如下圖紅框部分所示，各個(gè)控件被添加到窗體設(shè)計(jì)器?！鯟oreRA控件■ImageWindow控件■TextWindow控件■PanDAWindow控件※各個(gè)控件的使用方法請(qǐng)參照附錄“8-1..NET控件的使用方法”?！稣Z(yǔ)言切換根據(jù)以下代碼(VB.NET)的記載，可以在應(yīng)用上的ImageWindow,TextWindow控件設(shè)定要顯示的語(yǔ)言。不進(jìn)行任何設(shè)定時(shí)默認(rèn)顯示日文。英文顯示日文顯示

７－２．應(yīng)用運(yùn)行就作成的應(yīng)用的執(zhí)行方法進(jìn)行說明?！谂c應(yīng)用的運(yùn)行文件相同的文件夾內(nèi)運(yùn)行包含以下文件/文件夾的狀態(tài)。文件/文件夾說明FZ-Control.dll使用.NET控件必需的dll。Macro_UI2.dllCreateCoreRAProcess.dllJa文件夾用.NET控件顯示日文所需的文件夾。en文件夾用.NET控件顯示英文所需的文件夾。■切斷與FH/FZ5模擬軟件的連接【連接】啟動(dòng)與應(yīng)用連接的FH/FZ5模擬軟件。啟動(dòng)應(yīng)用。在應(yīng)用上設(shè)定CoreRA控件的屬性。調(diào)用CoreRA控件的ConnectStartmethod，連接應(yīng)用與FH/FZ5模擬軟件。例按下按鈕時(shí)CoreRA控件的屬性的設(shè)定與FH/FZ5模擬軟件的連接（VB.NET）※即使調(diào)換上述步驟（1）與步驟（2）也可連接起來?！B接失敗時(shí)，請(qǐng)?jiān)趫?zhí)行下述【切斷】的步驟后，再次連接?！厩袛唷繑嚅_應(yīng)用軟件。關(guān)閉FH/FZ5模擬軟件。※即使調(diào)換上述步驟（1）與步驟（2）也可連接起來。

■FH/FZ5視覺傳感器的連接與切斷【連接】啟動(dòng)與應(yīng)用連接的FH/FZ5視覺控制器。盡量設(shè)定FH/FZ5視覺控制器可以遠(yuǎn)程操作。（關(guān)于遠(yuǎn)程操作的設(shè)定，請(qǐng)參照【視覺處理系統(tǒng)FH/FZ5系統(tǒng)用戶操作手冊(cè)】的“從遠(yuǎn)處操作視覺控制器（遠(yuǎn)程操作）”的網(wǎng)絡(luò)的設(shè)定。）啟動(dòng)應(yīng)用。設(shè)定應(yīng)用上CoreRA控件的屬性。調(diào)用CoreRA控件的ConnectStartmethod，連接應(yīng)用與FH/FZ5模擬軟件。例按下按鈕時(shí)CoreRA控件的屬性的設(shè)定與FH/FZ5模擬軟件的連接（VB.NET）※即使調(diào)換上述步驟（1）與步驟（2）也可連接起來。※連接失敗時(shí)，請(qǐng)?jiān)趫?zhí)行下述【切斷】的步驟后，再次連接。【切斷】（1）斷開應(yīng)用軟件。（2）關(guān)閉FH/FZ5模擬軟件。※即使調(diào)換上述步驟（1）與步驟（2）也可連接起來。

附錄８－１．.NET控件的使用方法■CoreRA控件運(yùn)行作成的應(yīng)用與連接的FH/FZ5模擬軟件或者視覺控制器的。?屬性屬性說明ConnectMode指定連接的對(duì)象。Local：連接FH/FZ5模擬軟件Remote：連接FH/FZ5視覺控制器FzPath指定用于連接的模擬軟件的文件夾。例“C:\ProgramFiles\OMRON\FZ_FH”※連接視覺控制器時(shí)也需要設(shè)定PC的模擬軟件的文件夾。IpAddress指定連接對(duì)象FH/FZ5視覺控制器的IP地址。連接FH/FZ5模擬軟件時(shí)不需要。LineNo指定連接對(duì)象的線程編號(hào)?？梢赃B接的線程編號(hào)，根據(jù)動(dòng)作模式劃分如下。?多線程隨機(jī)觸發(fā)模式：0～7?高速記錄模式：0IsConnected返回連接狀態(tài)。（讀取專用）一旦連接成功，即使斷開也一直處于連接狀態(tài)。True：連接中False：未連接?方法方法說明ConnectStart根據(jù)屬性設(shè)定的內(nèi)容，嘗試連接FH/FZ5模擬軟件或者視覺控制器。連接成功后，ImageWindow、TextWindow控件將顯示FH/FZ5的測(cè)量?jī)?nèi)容。如果連接對(duì)象FH/FZ5的應(yīng)用沒有啟動(dòng)，就啟動(dòng)不帶主窗體的應(yīng)用?！龇祷刂颠M(jìn)行連接：Success=0指定路徑不存在：DirectoryNotFoundError=1連接失敗：InvalidArgumentError=3Macro_DirectExecute在FH/FZ5上運(yùn)行用自變量commandline記述的宏。用一個(gè)進(jìn)程連接多線程時(shí)，無法使用?！鲎宰兞縞ommandline：要運(yùn)行宏的說明（輸入自變量）Macro_GetVariable自變量variableName指定的宏變量的數(shù)值獲取為文字列。在取得在Macro_DirectExecute運(yùn)行的宏變量的值時(shí)使用?！鲎宰兞縱ariableName：數(shù)據(jù)采集對(duì)象的宏變量名（輸入自變量）data：獲取結(jié)果文字列（輸出自變量）maxLength：獲取結(jié)果取得用文字列配列的要素?cái)?shù)（輸出自變量）Macro_SetVariable設(shè)定對(duì)應(yīng)自變量variableName指定的宏變量的值的值?！鲎宰兞縱ariableName：數(shù)據(jù)獲取對(duì)象的宏變量名（輸入自變量）data：設(shè)定對(duì)象數(shù)據(jù)文字列(輸入自變量) ※ConnectStart以外的Method只有在CoreRA控件與FH/FZ5連接狀態(tài)下才運(yùn)行。?Eventevent說明FzPathChangedFzPath屬性變更時(shí)產(chǎn)生。ProcessStarted伴隨ConnectStartMethod，在與FH/FZ5連接成功時(shí)產(chǎn)生。ErrorProcFH/FZ5上發(fā)生以下錯(cuò)誤時(shí)產(chǎn)生。?系統(tǒng)異常?Fan/電壓異常?相機(jī)連接異常?圖像記錄硬盤寫入異常?數(shù)據(jù)輸出超時(shí)MeasureDispFH/FZ5上運(yùn)行測(cè)量結(jié)果的顯示處理時(shí)產(chǎn)生。MeasureInitFH/FZ5上運(yùn)行測(cè)量初始化處理時(shí)產(chǎn)生。測(cè)量初始化處理，設(shè)定畫面的開閉和指令的運(yùn)行等時(shí)，主要在BUSY信號(hào)從ON變成OFF時(shí)產(chǎn)生。但是，測(cè)量指令等在測(cè)量執(zhí)行時(shí)不產(chǎn)生。MeasureOut在FH/FZ5上執(zhí)行測(cè)量結(jié)果的輸出處理時(shí)產(chǎn)生。OptionEvent連接對(duì)象FH/FZ5上發(fā)生自選項(xiàng)目時(shí)產(chǎn)生。SceneChange在FH/FZ5上執(zhí)行切換處理時(shí)產(chǎn)生。 ※上述事件只在CoreRA控件與FH/FZ5連接的狀態(tài)下產(chǎn)生?！鯥mageWindow控件可以在應(yīng)用上顯示指定用戶的測(cè)量結(jié)果的圖像。通過WindowNo屬性指定谷歌固有的編號(hào)，窗體上最大可以使用64個(gè)。?屬性屬性說明ConnectCoreRAComponent指定連接使用的CoreRA控件。ImageOrigin對(duì)于窗口左上坐標(biāo)指定顯示圖像的左上坐標(biāo)。ImageVisible指定圖像顯示窗口是否顯示。０：窗口不顯示１：窗口顯示Magnification指定圖像顯示時(shí)的倍率。指定用實(shí)際數(shù)量顯示的倍率。例如縮小一半顯示時(shí)指定為【0.5】，擴(kuò)大一倍顯示時(shí)指定為【2.0】。指定為-1時(shí)，結(jié)合窗口尺寸選擇自動(dòng)倍率。SubNo指定顯示單元的副編號(hào)。指定-１時(shí)，為位置一覽顯示模式，從指定的處理單元到下一個(gè)圖像輸入相關(guān)的前一個(gè)的處理單元的顯示對(duì)象。UnitNo顯示對(duì)象的處理單元編號(hào)指定-１時(shí)，在連接對(duì)象的FH/FZ5上現(xiàn)在選擇中的處理單元為顯示對(duì)象。UpdateImage指定顯示圖像的更新時(shí)間。表示畫像の更新タイミングを指定します。動(dòng)態(tài)顯示指定時(shí)，F(xiàn)H/FZ5視覺控制器的動(dòng)作也為動(dòng)態(tài)顯示時(shí)的狀態(tài)。FREEZE：測(cè)量時(shí)每次（凍結(jié)顯示）NG_IMAGE：只限測(cè)量時(shí)綜合判定結(jié)果為NG的情況THROUGH：常時(shí)更新（動(dòng)態(tài)顯示）常時(shí)更新（スルー表示）WindowNo指定0～63的窗口編號(hào)。需要在窗體內(nèi)設(shè)定固有編號(hào)。■TextWindow控件可以在應(yīng)用上顯示指定單元的測(cè)量結(jié)果。本控件附著在一個(gè)CoreRA控件上，只可以進(jìn)行一種動(dòng)作。?屬性屬性說明ConnectCoreRAComponent指定連接所用的CoreRA(元件)。UnitNo指定顯示對(duì)象的處理單元編號(hào)。指定-１則連接對(duì)象的FH/FZ5上現(xiàn)在選中的處理單元為顯示對(duì)象。FontSize現(xiàn)在這個(gè)屬性的設(shè)定未進(jìn)行。■PanDAWindow控件遠(yuǎn)程操作中的主畫面在設(shè)計(jì)師配置的控件的范圍內(nèi)顯示?！究丶豢梢耘c實(shí)機(jī)進(jìn)行遠(yuǎn)程連接。※無法從控件上的菜單結(jié)束運(yùn)行。?屬性屬性說明FzPath指定連接時(shí)所用模擬軟件的文件夾。例“C:\ProgramFiles\OMRON\FZ_FH”IpAddress指定連接對(duì)象FH/FZ5視覺控制器的IP地址。LineNo指定連接對(duì)象的線程編號(hào)。可以連接的線程編號(hào)根據(jù)動(dòng)作模式有以下幾種。?多線程隨機(jī)觸發(fā)模式複數(shù)：0～7?高速記錄模式：0IsConnected返回連接狀態(tài)。（讀取專用）True：連接中False：未連接Title返回連接中的主窗口的標(biāo)題字符串。（讀取專用）

?方法方法說明ConnectStart根據(jù)屬性的設(shè)定內(nèi)容，嘗試連接連接對(duì)象的FH/FZ5視覺控制器。連接對(duì)象FH/FZ5的應(yīng)用未啟動(dòng)完成時(shí)，啟動(dòng)應(yīng)用■返回值實(shí)施連接：Success=0指定母線不存在：DirectoryNotFoundError=1連接處理執(zhí)行失?。篒nvalidArgumentError=3

８－２．Macro_DirectExecute可執(zhí)行宏指令一覽CoreRA控件的Macro_DirectExecute可執(zhí)行宏指令一覽如下。詳細(xì)動(dòng)作請(qǐng)參照FH/FZ5用戶操作手冊(cè)?！啊北硎局噶顖?zhí)行前需要發(fā)出MeasureStop指令，指令執(zhí)行后需要發(fā)出MeasureStart指令?！褚话忝罟δ芎瘮?shù)/指令名定義數(shù)組變量。DimDo到Loop之間滿足條件的文的重復(fù)執(zhí)行。Do～LoopWhile解放用Dim指令定義的數(shù)組變量的內(nèi)存區(qū)域。Erase重復(fù)執(zhí)行For文與Next文之間的命令。For...To...Step～Next向指定的子程序轉(zhuǎn)移處理。Gosub向指定的標(biāo)簽行轉(zhuǎn)移處理。Goto控制進(jìn)行理論式的條件判定的處理流程。If...Then～Elseif～Else～Endif根據(jù)指定的條件控制處理的流程。If...Then～Else根據(jù)式的結(jié)果控制處理分支。Select...Case～CaseElse～EndSelect進(jìn)行例外處理。Try～Catch～EndTry恢復(fù)保存的變量。Varpop臨時(shí)保存變量的值。Varpush●算數(shù)演算相關(guān)功能函數(shù)/指令名求出指定算式的絕對(duì)值。Abs（函數(shù)）求出指定的2個(gè)算式的理論積。And（函數(shù)）求出指定算式的反正切（Arctangent）。Atn（函數(shù)）求出指定算式的余弦（cos）。Cos（函數(shù)）求出2條直線的交點(diǎn)。Crspoint求出指定直線到點(diǎn)的最短距離。Dposline（函數(shù)）求出以自然對(duì)數(shù)底e為底的指數(shù)函數(shù)的值。Exp（函數(shù)）求出去除小數(shù)點(diǎn)保留整數(shù)的值。Fix（函數(shù)）將給出的數(shù)值轉(zhuǎn)換成整數(shù)。Int（函數(shù)）求出自然對(duì)數(shù)值。Log（函數(shù)）使用最小二乘法從多點(diǎn)坐標(biāo)求出近似直線。Lsqumeth求余。Mod（函數(shù)）得出算式的否定結(jié)果。Not（函數(shù)）求出2算式的理論和。Or（函數(shù)）求出指定數(shù)式的正弦（sin）。Sin（函數(shù)）求出平方根。Sqr（函數(shù)）求出指定算式的指定した數(shù)式の正切（tan）。Tan（函數(shù)）求出2算式的排除的理論和。Xor（函數(shù)）●字符串操作相關(guān)功能函數(shù)/指令名求出指定字符的字符代碼值。Asc（函數(shù)）求出字符代碼對(duì)應(yīng)的字符串。Chr$（函數(shù)）將數(shù)式的值轉(zhuǎn)換成用16進(jìn)制表示的字符串。Hex$（函數(shù)）從大字符轉(zhuǎn)換成小字符。LCase$（函數(shù)）從字符串的左側(cè)開始取出指定長(zhǎng)度的字符串。Left$（函數(shù)）求出指定字符串的長(zhǎng)度。Len（函數(shù)）取出字符串的一部分。Mid$（函數(shù)）從字符串取出用指定區(qū)分字符區(qū)分的部分。Piece$（函數(shù)）從字符串的右側(cè)開始取出指定長(zhǎng)度的字符串。Right$（函數(shù)）將數(shù)值轉(zhuǎn)換成數(shù)字字符串。Str$（函數(shù)）指定數(shù)值的格式，轉(zhuǎn)換成數(shù)字字符串。Str2$（函數(shù)）將小文字轉(zhuǎn)換成大文字。UCase$（函數(shù)）將字符串標(biāo)記的數(shù)字轉(zhuǎn)換成數(shù)值。Val（函數(shù)）

●測(cè)量控制相關(guān)功能函數(shù)/指令名清除處理單元的測(cè)量結(jié)果?！鵆learMeasureData獲得測(cè)量結(jié)果的輸出有無。GetMeasureOut更新圖像數(shù)據(jù)。ImageUpdate允許測(cè)量觸發(fā)輸入。MeasureStart不允許測(cè)量觸發(fā)輸入。MeasureStop執(zhí)行測(cè)量處理。Measure執(zhí)行再測(cè)量處理。Remeasure保存圖像數(shù)據(jù)?！鵖aveImage設(shè)定測(cè)量結(jié)果的輸出有無?！鵖etMeasureOut取得處理單元的判定結(jié)果。UnitJudge●IO模塊控制相關(guān)功能函數(shù)/指令名執(zhí)行輸入端子的全點(diǎn)輸入。GetAll（函數(shù)）取得PLC的讀取數(shù)據(jù)。GetPlcData執(zhí)行輸入端子的1點(diǎn)輸入。GetPort（函數(shù)）輸出端子1點(diǎn)輸出。PutPort輸出端子全點(diǎn)輸出。PutAll輸出RUN的狀態(tài)。RunOut●顯示控制相關(guān)功能函數(shù)/指令名取得圖像/文本顯示的既定處理單元編號(hào)。DisplayUnitNo（函數(shù)）取得圖像顯示窗口的設(shè)定。GetImageWindow取得文本顯示窗口的設(shè)定。GetTextWindow更新圖像顯示窗口的顯示。RefreshImageWindow更新文本顯示窗口的顯示。RefreshTextWindow更新判定結(jié)果顯示窗口的顯示。RefreshJudgeWindow更新測(cè)量處理時(shí)間顯示窗口。RefreshTimeWindow設(shè)定圖像/文本顯示規(guī)定處理單元編號(hào)。SetDisplayUnitNo設(shè)定圖像顯示窗口?！鵖etImageWindow設(shè)定文本顯示窗口?！鵖etTextWindow●數(shù)據(jù)保存/上傳相關(guān)功能函數(shù)/指令名讀取系統(tǒng)+場(chǎng)景組數(shù)據(jù)。※LoadBackupData讀取場(chǎng)景數(shù)據(jù)?！鵏oadScene讀取場(chǎng)景組數(shù)據(jù)?！鵏oadSceneGroup讀取處理單元數(shù)據(jù)?！鵏oadUnitData讀取系統(tǒng)數(shù)據(jù)?！鵏oadSystemData保存系統(tǒng)+場(chǎng)景組數(shù)據(jù)。SaveBackupData保存數(shù)據(jù)至本體。SaveData保存場(chǎng)景組數(shù)據(jù)。SaveSceneGroup保存場(chǎng)景數(shù)據(jù)。SaveScene保存系統(tǒng)數(shù)據(jù)。SaveSystemData保存圖像數(shù)據(jù)。。SaveImage保存處理單元數(shù)據(jù)。SaveUnitData●全局?jǐn)?shù)據(jù)相關(guān)功能函數(shù)/指令名追加全局?jǐn)?shù)據(jù)。※AddGlobalData取得全局?jǐn)?shù)據(jù)。GetGlobalData設(shè)定全局?jǐn)?shù)據(jù)?！鵖etGlobalData●系統(tǒng)數(shù)據(jù)相關(guān)功能函數(shù)/指令名追加系統(tǒng)數(shù)據(jù)?！鵄ddSystemData取得系統(tǒng)數(shù)據(jù)。GetSystemData設(shè)定系統(tǒng)數(shù)據(jù)?！鵖etSystemData●場(chǎng)景控制相關(guān)功能函數(shù)/指令名切換到指定場(chǎng)景?！鵆hangeScene清除指定場(chǎng)景※ClearScene復(fù)制場(chǎng)景數(shù)據(jù)。※CopyScene取得可以使用的場(chǎng)景數(shù)。SceneCount（函數(shù)）取得場(chǎng)景的說明。SceneDescription$（函數(shù)）取得場(chǎng)景作成者名。SceneMaker$（函數(shù)）取得現(xiàn)在的場(chǎng)景編號(hào)。SceneNo（函數(shù)）取得場(chǎng)景標(biāo)題名。SceneTitle$（函數(shù)）設(shè)定場(chǎng)景的說明?！鵖etSceneDescription設(shè)定場(chǎng)景作成者名?！鵖etSceneMaker設(shè)定場(chǎng)景標(biāo)題名?！鵖etSceneTitle●場(chǎng)景組控制相關(guān)功能函數(shù)/指令名切換到指定場(chǎng)景組?！鵆hangeSceneGroup清除指定場(chǎng)景組?！鵆learSceneGroup復(fù)制場(chǎng)景組數(shù)據(jù)?！鵆opySceneGroup設(shè)定場(chǎng)景組標(biāo)題名?！鵖etSceneGroupTitle獲得內(nèi)存卡內(nèi)的有效場(chǎng)景組個(gè)數(shù)。SceneGroupCount獲得現(xiàn)在的場(chǎng)景組編號(hào)。SceneGroupNo獲得場(chǎng)景組標(biāo)題名。SceneGroupT