文档介绍:CkvsRunCtrl控件开发手册
控件简介
CkvsRunCtrl控件是配合CkvsBuilder软件使用,可以加载并使用CkvsBuilder软件生成的工程文件,控件可以嵌入到客户自己开发的程序中,并通过接口函数获得检测结果数据,以简化客户程序的开发过程。
图1-1 CkvsRunCtrl控件使用范例界面
函数说明
BOOL LoadProject(LPCTSTR strFileName)
功能:从文件中装载工程文件。
参数:
strFileName 工程文件路径名。
返回:成功返回TRUE,否则返回FALSE。
BOOL SaveProject(LPCTSTR strFileName)
功能:将当前工程保存到文件。
参数:
strFileName 工程文件路径名。
返回:成功返回TRUE,否则返回FALSE。
void CloseProject()
功能:关闭当前工程文件。
long GetFirstProc()
功能:获取第一个流程的指针。
返回:成功返回流程指针地址,否则返回NULL。
long GetNextProc(long pProc)
功能:获取输入流程的下一个流程指针。
参数:
pProc 输入流程指针地址。
返回:成功返回流程指针地址,否则返回NULL。
CString ame(long pProc)
功能:获取指定流程的名称。
参数:
pTool 输入流程指针地址。
返回:成功返回流程名称,否则返回空字符串。
long GetProc(LPCTSTR strName)
功能:获取指定流程指针地址。
参数:
strName 输入流程名称。
返回:成功返回流程指针地址,否则返回NULL。
long GetFirstTool(long pProc)
功能:获取指定流程中的第一个工具。
参数:
pProc 输入流程指针地址,主流程可设为NULL。
返回:成功返回工具指针地址,否则返回NULL。
long GetNextTool(long pTool)
功能:获取输入工具的下一个工具指针。
参数:
pTool 输入工具指针地址。
返回:成功返回工具指针地址,否则返回NULL。
CString GetToolName(long pTool)
功能:获取指定工具的名称。
参数:
pTool 输入工具指针地址。
返回:成功返回工具名称,否则返回空字符串。
long GetTool(long pProc, LPCTSTR strToolName)
功能:根据名称获取指定工具的指针地址。
参数:
pProc 输入流程指针地址,主流程可设为NULL。
strToolName 输入工具名称。
返回:成功返回指向工具的指针地址,否则返回NULL。
BOOL GetToolEnabled(long pTool)
功能:获得指定工具的激活/屏蔽状态。
参数:
pTool 输入工具指针。
返回:输入工具有效且为激活状态返回TRUE,否则返回FALSE。
BOOL SetToolEnabled(long pTool, BOOL bEnabled)
功能:屏蔽/激活指定工具。
参数:
pTool 输入工具指针。
bEnabled TRUE为激活,FALSE为屏蔽。
返回:输入工具有效返回TRUE,否则返回FALSE。
BOOL ShowProperty(long pTool)
功能:弹出指定工具的属性对话框。
参数:
pTool 输入工具指针。
返回:确认返回TRUE,否则返回FALSE。
BOOL Execute(BOOL bRun)
功能:执行程序(包含所有流程)。
参数:
bRun TRUE为所有流程连续运行,FALSE为每个流程只执行一次。
返回:成功返回TRUE,否则返回FALSE。
BOOL Stop(BOOL bForce)
功能:停止执行程序。
参数:
bForce TRUE为强制停止(可退出死循环,完成当前执行的工具就立即返回),FALSE为一般的停止(必须执行完整个流程才返回)。
返回:成功返回TRUE,否则返回FALSE。
BOOL IsRuning()
功能:当前程序是否正在执行或运行。
返回:正在执行或运行返回TRUE,否则返回FALSE。
BOOL SendProcMsg(long pProc, long lMsg)
功能:发送一个消息给指定流程。
参数:
pProc 输入流程指针地址。
lMsg 消息索引标识。
返回:成功返回TRUE,否则返回FALSE。
BOOL GetResultStatus