NET控件使用說明書

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

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

.NET控件概要.NET控件是為了可以簡單得在用Microsoft?VisualStudio?制作的應用里顯示FH/FZ5的測量圖像、測量結果而存在的自定義控件。只要在應用上配置該自定義控件，即可顯示出FH/FZ5的測量圖像、測量結果。推薦動作環(huán)境CPU ：搭載IntelPentiumProcessor(SSE2以上)OS ：Windows7Professional(32bit)Windows7Enterprise(32bit)Windows7Ultimate(32bit).NetFramework ：.NetFramework3.5以上內存 ：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ā)語言VisualBasic.NETVisualC#功能概要.NET控件的自定義控件構成如下。控件說明CoreRA制作的應用與連接的FH/FZ5的模擬軟件或者視覺控制器之間的動作來往。使用其他.NET控件時務必進行追加。ImageWindow在應用上顯示指定用戶的測量圖像。TextWindow顯示指定用戶的測量結果。PanDAWindow操作/顯示遠程操作中的主畫面。Microsoft的各產品是美國MicrosoftCorporation的注冊商標。Pentium是美國IntelCorporation的注冊商標。本操作使用說明書里記載的公司名稱以及產品名稱為各個公司的商標或者注冊商標。

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

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

■FH/FZ5視覺傳感器的連接與切斷【連接】啟動與應用連接的FH/FZ5視覺控制器。盡量設定FH/FZ5視覺控制器可以遠程操作。（關于遠程操作的設定，請參照【視覺處理系統(tǒng)FH/FZ5系統(tǒng)用戶操作手冊】的“從遠處操作視覺控制器（遠程操作）”的網(wǎng)絡的設定。）啟動應用。設定應用上CoreRA控件的屬性。調用CoreRA控件的ConnectStartmethod，連接應用與FH/FZ5模擬軟件。例按下按鈕時CoreRA控件的屬性的設定與FH/FZ5模擬軟件的連接（VB.NET）※即使調換上述步驟（1）與步驟（2）也可連接起來。※連接失敗時，請在執(zhí)行下述【切斷】的步驟后，再次連接。【切斷】（1）斷開應用軟件。（2）關閉FH/FZ5模擬軟件?！词拐{換上述步驟（1）與步驟（2）也可連接起來。

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

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

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

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