【VM服务管家】VM4.2平台SDK_6.1 环境配置类

2.1.1 环境配置：基于Csharp二次开发环境配置方法

描述
环境：VM4.2 + VS2013及以上，注意，只要VS2013有.NET Framework4.6.1，就可以使用VS2013进行VM SDK开发。
现象：基于C#如何进行VM二次开发环境配置？
解答
WinForm、WPF开发平台，两者二次开发环境配置步骤基本一致。
第一步：新建项目。使用VS新建一个窗体应用程序，以WinForm为例，框架选择.NET Framework4.6.1，接着打开项目属性页面，取消勾选【首选32位】，然后重新编译项目。最后，关闭项目。

第二步：添加引用。使用导入工具来添加引用，工具路径VisionMaster4.2.0\Development\V4.x\ComControls\Tool\ImportRef.exe。操作步骤：选择项目所在的路径，勾选需要引用的模块，也可以全部引用。点击确定按钮，待进度条100%后，打开项目，可以发现项目的引用中出现VM二次开发相关的dll。

第三步：添加控件。在WinForm窗体程序中，打开工具箱，鼠标右击【所有Windows窗体】，点击【选择项】，弹出.NET Framework组件窗口，浏览VM4.2的安装路径文件夹：VisionMaster4.2.0\Development\V4.x\ComControls\Assembly，选择VMControls.Winform.Release.dll，添加后工具箱出现VM二次开发控件。

控件分别为：
VmFrontend 前端运行界面控件
VmGlobalTool 全局模块控件
VmMainView 主界面控件
VmParams 参数配置控件
VmParamsConfigWithRender 参数配置带渲染控件
VmProcedure 流程配置控件
VmRenderControl 渲染控件
VmSingleModuleSet 独立Group控件
用户可将控件拖拽到窗体中使用。
如上所述为WinForm窗体应用程序添加控件的方法，下面介绍WPF添加控件的方法。
在WPF窗体应用程序->工具箱中点击【选择项】，弹出WPF组件窗口，接着浏览VM4.2的安装路径文件夹：VisionMaster4.2.0\Development\V4.x\ComControls\Assembly，选择VMControls.WPF.Release.dll。拖拉控件至窗口中，xaml中代码自动生成。

添加完依赖库引用和控件后，启动程序，效果如下图所示。
用户可在流程配置控件中新建流程，搭建和调试视觉方案。同时，用户可在程序中引用平台库（using VM.Core和using VM.PlatformSDKCS）和模块库（查阅VisionMaster4.2.0\Development\V4.x\Documentations中的开发手册查看模块库名称）来实现业务代码开发。

问题根因
不熟悉基于C#的VM二次开发环境配置步骤

2.1.2 环境配置：基于MFC二次开发环境配置方法

描述
环境：VM4.2 + VS2013及以上
现象：基于MFC如何进行VM二次开发环境配置？
解答
第一步：新建项目。以MFC+ VS2013为例。应用程序类型选择：基于对话框。

第二步：配置VC++目录。打开项目属性页，平台选择x64。依次配置头文件目录、库文件目录和附加依赖项。
其中，头文件目录需要配置模块头文件。库目录选择win64\C。附加依赖项选择iMVS-6000PlatformSDK.lib。

第三步：添加控件头文件和源文件。将控件头文件、源文件拷贝到工程目录下(本例为VS2013创建的程序，控件文件路径VisionMaster4.2.0\Development\V4.x\ComControls\Includes\VS2013，VS2017创建的程序则选择VS2017文件夹)，拷贝之后再添加头文件和源文件。

第四步：添加VM 封装的ActiveX控件，这些控件在VM安装时已经注册，可以直接选择。

第五步：在程序中包含头文件，并进行控件的绑定与初始化。

定义控件变量：

private:
	CVmMainViewControlInterface m_MainViewctr;

控件变量绑定界面：

void CVMMFCApplication1Dlg::DoDataExchange(CDataExchange* pDX)
{
	CDialogEx::DoDataExchange(pDX);
	DDX_Control(pDX, IDC_VMUSERCONTROL1, m_MainViewctr);
}

通过控件变量给控件初始化：

BOOL CVMMFCApplication1Dlg::OnInitDialog()
{
	CDialogEx::OnInitDialog();
	// 将“关于...”菜单项添加到系统菜单中。
             …
	// TODO: 在此添加额外的初始化代码
	try
	{
		m_MainViewctr.GetObjectPointer();
	}
	catch (CVmException e)
	{}
	return TRUE;  // 除非将焦点设置到控件，否则返回 TRUE
}

至此，完成环境配置。启动程序，效果如下图所示。
用户可在主界面控件中新建流程，搭建和调试视觉方案。用户可在程序中引用平台库和模块库（查阅VisionMaster4.2.0\Development\V4.x\Documentations中的开发手册查看模块库名称）来实现业务代码开发。

问题根因
不熟悉基于MFC的VM二次开发环境配置步骤

2.1.3 环境配置：基于Qt二次开发环境配置方法

描述
环境：VM4.2 + Qt5.14
现象：基于Qt如何进行VM二次开发环境配置？
解答
第一步：新建项目。打开QTCreate，编译器推荐选择MSVC2017 64bit。

第二步：配置外部库。打开后缀为.pro的文件，在代码区域鼠标右击，选择【添加库】，选择【外部库】，选择VM安装路径下的相关库文件和包含路径， 效果如下图所示。

为了控件能正常显示，在此代码区域头部添加一句QT +=axcontainer。
第三步：添加控件头文件和源文件。将控件头文件、源文件拷贝到工程目录下(本例为VS2013创建的程序，控件文件路径VisionMaster4.2.0\Development\V4.x\ComControls\Includes\QT)，拷贝之后再添加头文件和源文件。

第四步：添加VM 封装的ActiveX控件，这些控件在VM安装时已经注册，可以直接选择。

第五步：在程序中包含头文件，并进行控件的初始化。

至此，完成环境配置。启动程序，效果如下图所示。 注意加载方案时，在控件上显示方案，则需要在控件初始化前，调用CreateSolutionInstance();