6.軟件使用手冊(cè)ckvsrunctrl開發(fā)手冊(cè)

1、CkvsRunCtrl 控件開發(fā)手冊(cè)市創(chuàng)科自動(dòng)化控制技術(shù)2015-5-13一、 控件簡(jiǎn)介CkvsRunCtrl 控件是配合 CkvsBuilder使用，可以加載并使用 CkvsBuilder生成的工程文件，控件可以嵌入到客戶自己開發(fā)的程序中，并通過接口函數(shù)獲得檢測(cè)結(jié)果數(shù)據(jù)，以簡(jiǎn)化客戶程序的開發(fā)過程。圖 1-1CkvsRunCtrl 控件使用范例界面二、 函數(shù)說(shuō)明1. BOOL Loroject(LPCTSTR strFileName)功能：從文件中裝載工程文件。參數(shù)：strFileName 工程文件路徑名。返回：成功返回 TRUE，否則返回 FALSE。2.BOOL SaveProject(L

2、PCTSTR strFileName)功能：將當(dāng)前工程保存到文件。參數(shù)：strFileName 工程文件路徑名。返回：成功返回 TRUE，否則返回 FALSE。3.void CloseProject()功能：關(guān)閉當(dāng)前工程文件。4.long GetProc()功能：獲取第一個(gè)流程的指針。返回：成功返回流程指針地址，否則返回 NULL。5.long GetNextProc(long pProc)功能：獲取輸入流程的下一個(gè)流程指針。參數(shù)：pProc輸入流程指針地址。返回：成功返回流程指針地址，否則返回 NULL。6.CStringame(long pProc)功能：獲取指定流程的名稱。參數(shù)：pToo

3、l輸入流程指針地址。返回：成功返回流程名稱，否則返回空字符串。7.long GetProc(LPCTSTR strName)功能：獲取指定流程指針地址。參數(shù)：strName輸入流程名稱。返回：成功返回流程指針地址，否則返回 NULL。8. long GetTool(long pProc)功能：獲取指定流程中的第一個(gè)工具。參數(shù)：pProc輸入流程指針地址，主流程可設(shè)為 NULL。返回：成功返回工具指針地址，否則返回 NULL。9. long GetNextTool(long pTool)功能：獲取輸入工具的下一個(gè)工具指針。參數(shù)：pTool輸入工具指針地址。返回：成功返回工具指針地址，否則返回 N

4、ULL。10. CString GetToolName(long pTool)功能：獲取指定工具的名稱。參數(shù)：pTool輸入工具指針地址。返回：成功返回工具名稱，否則返回空字符串。11. long GetTool(long pProc, LPCTSTR strToolName)功能：根據(jù)名稱獲取指定工具的指針地址。參數(shù)：pProc輸入流程指針地址，主流程可設(shè)為 NULL。strToolName 輸入工具名稱。返回：成功返回指向工具的指針地址，否則返回 NULL。12. BOOL GetToolEnabled(long pTool)功能：獲得指定工具的激活/狀態(tài)。參數(shù)：pTool輸入工具指針。返

5、回：輸入工具有效且為激活狀態(tài)返回 TRUE，否則返回 FALSE。13. BOOL SetToolEnabled(long pTool, BOOL bEnabled)功能：/激活指定工具。參數(shù)：pTool輸入工具指針。bEnabledTRUE 為激活，F(xiàn)ALSE 為。返回：輸入工具有效返回 TRUE，否則返回 FALSE。14. BOOL ShowProperty(long pTool)功能：彈出指定工具的屬性框。參數(shù)：pTool輸入工具指針。返回：確認(rèn)返回 TRUE，否則返回 FALSE。15. BOOL Execute(BOOL bRun)功能：執(zhí)行程序（包含所有流程）。參數(shù)：bRunTR

6、UE 為所有流程連續(xù)運(yùn)行，F(xiàn)ALSE 為每個(gè)流程只執(zhí)行一次。返回：成功返回 TRUE，否則返回 FALSE。16. BOOL StOOL bForce)功能：停止執(zhí)行程序。參數(shù)：bForceTRUE 為強(qiáng)制停止（可退出死循環(huán)，完成當(dāng)前執(zhí)行的工具就立即返回），F(xiàn)ALSE 為一般的停止（必須執(zhí)行完整個(gè)流程才返回）。返回：成功返回 TRUE，否則返回 FALSE。17. BOOL IsRuning()功能：當(dāng)前程序是否正在執(zhí)行或運(yùn)行。返回：正在執(zhí)行或運(yùn)行返回 TRUE，否則返回 FALSE。18. BOOL SendProcMsg(long pProc, longg)功能：發(fā)送一個(gè)消息給指定流程。參

7、數(shù)：pProc輸入流程指針地址。g消息索引標(biāo)識(shí)。返回：成功返回 TRUE，否則返回 FALSE。19. BOOL GetResultSus(long pTool, LPCTSTR strName, long nIndex, long*retVal)功能：獲取指定工具的 BOOL 類型數(shù)據(jù)。參數(shù)：pTool輸入工具指針地址。strName需要獲取的數(shù)據(jù)名稱，數(shù)據(jù)名稱可以在 CkvsBuilder中的“數(shù)據(jù)”框中找到。nIndex數(shù)據(jù)數(shù)組索引，當(dāng)數(shù)據(jù)為數(shù)組時(shí)有用。retVal輸出狀態(tài)數(shù)據(jù)值。返回：成功返回 TRUE，否則返回 FALSE。20. BOOL GetResult32(long pToo

8、l, LPCTSTR strName, long nIndex,long*retVal)功能：獲取指定工具的整型數(shù)據(jù)。參數(shù)：pTool輸入工具指針地址。strName需要獲取的數(shù)據(jù)名稱，數(shù)據(jù)名稱可以在 CkvsBuilder中的“數(shù)據(jù)”框中找到。nIndex數(shù)據(jù)數(shù)組索引，當(dāng)數(shù)據(jù)為數(shù)組時(shí)有用。retVal輸出的整型數(shù)據(jù)值。返回：成功返回 TRUE，否則返回 FALSE。21. BOOL GetResuouble(long pTool, LPCTSTR strName, long nIndex, double*retVal)功能：獲取指定工具的浮點(diǎn)型數(shù)據(jù)。參數(shù)：pTool輸入工具指針地址。strN

9、ame需要獲取的數(shù)據(jù)名稱，數(shù)據(jù)名稱可以在 CkvsBuilder中的“數(shù)據(jù)”框中找到。nIndex數(shù)據(jù)數(shù)組索引，當(dāng)數(shù)據(jù)為數(shù)組時(shí)有用。retVal輸出的浮點(diǎn)型數(shù)據(jù)值。返回：成功返回 TRUE，否則返回 FALSE。22. void ZoomIn(void)功能：放大顯示圖像。23. void ZoomOut(void)功能：縮小顯示圖像。24. void Zoom1x1(void)功能：還原 1 倍顯示圖像。25. void ZoomFit(void)功能：自動(dòng)適應(yīng)顯示圖像。26.BOOL SetCrossOffset(long lIndex, double dOffsetX, double d

10、OffsetY);功能：設(shè)置圖像畫面中心線偏移。參數(shù)：lIndex輸入圖像畫面索引。dOffsetXX 軸偏移量。dOffsetYY 軸偏移量。返回：成功返回 TRUE，否則返回 FALSE。27.BOOL GetCrossOffset(long lIndex, double*dOffsetX, double* dOffsetY);功能：獲取圖像畫面中心線偏移。參數(shù)：lIndex輸入圖像畫面索引。dOffsetX返回 X 軸偏移量。dOffsetY返回 Y 軸偏移量。返回：成功返回 TRUE，否則返回 FALSE。三、 事件說(shuō)明1. void OnNotifyTool(long pProc,

11、long nIndex)功能：接收 “通知控件”工具向控件發(fā)送的消息，可以在接收到消息后執(zhí)行自己的代碼，相當(dāng)于把這部分代碼嵌入到流程當(dāng)中。參數(shù)：pProc“通知控件”工具所在的流程。nIndex“通知控件”工具消息標(biāo)識(shí)，可以根據(jù)該標(biāo)識(shí)執(zhí)行不同的代碼。圖 3-1“通知控件”工具的使用四、 使用說(shuō)明1.控件：運(yùn)行 CkvsBuilder目錄下的 Reg.bat 文件，稍等一會(huì)彈出如下對(duì)話框，點(diǎn)擊“確認(rèn)”完成。圖 4-1成功2.添加控件：將控件拖動(dòng)到畫面上，并定義好關(guān)聯(lián)變量后就可以開始使用控件。3.當(dāng)前流程：使用函數(shù) Loroject 函數(shù)裝載工程后當(dāng)前流程默認(rèn)為“主流程”，使用 GetProc 函

12、數(shù)獲取流程時(shí)需要傳入流程名稱，流程名稱可以在 CkvsBuilder流程列表中找到，見下圖。圖 4-2 流程列表4.獲取工具：使用 GetTool 函數(shù)獲取工具時(shí)需要傳入工具的名稱，工具名稱可以在CkvsBuilder工具列表中找到，見下圖。圖 4-3 工具列表5.獲取數(shù)據(jù)：使用 GetResultSus、GetResult32 或 GetResuouble 函數(shù)獲取數(shù)據(jù)時(shí)需要傳入數(shù)據(jù)名稱，數(shù)據(jù)名稱可以在 CkvsBuilder數(shù)據(jù)列表中找到（名稱不包含后面的“”符號(hào)），見下圖。圖 4-4 數(shù)據(jù)6. 獲取數(shù)據(jù)方法：新版本中獲取數(shù)據(jù)的方法需要通過 NotifyTool 事件來(lái)完成，不能直接在 E

13、xecute 函數(shù)后面獲取數(shù)據(jù)，首選要在流程中添加一個(gè)“通知控件”工具（參見圖 3-1），然后在控件程序中增加 NotifyTool 事件，再在事件中獲取數(shù)據(jù)結(jié)果（參見示例代碼）。五、 示例代碼1. 獲取定位工具的數(shù)據(jù)/ 獲取工具指針地址，“M”為工具名稱。long pTool = m_ckvsrun1.GetTool(NULL,”M”);/ 獲取匹配目標(biāo)數(shù)量。long lValue=0;m_ckvsrun1.GetResult32(pTool,”Count”,0,&lValue );/ 獲取匹配分?jǐn)?shù)和坐標(biāo)位置。double dScore=0.0,dX=0.0,dY=0.0;ckvsrun1.

14、GetResuouble(pTool,”Score”,0,&dScore);ckvsrun1. GetResuouble(pTool,”itionX”,0,&dX);ckvsrun1. GetResuouble(pTool,”itionY”,0,&dY);2. 接收消息工具例子void CCkvsRunDemoDlg:OnNotifyToolCkvsrunctrlctrl1(longpProc, longnIndex)long lValue=0;double dScore=0.0,dX=0.0,dY=0.0;switch(nIndex)case 0: / 獲取數(shù)據(jù)結(jié)果long pTool = m_ckvsrun1.GetTool(pProc,”