RTX插件开发--CsDemoClient(VC).docVIP

RTX插件开发（一）CsDemoClient(VC6.0) 前言 我想实现客户端的插件与服务器端的应用进行通讯，采用RTX的通道进行通讯，而不是自已再写一条通道；　　我想在RTX客户端面版上增加一个属于我自己的面版，服务器端发过来的数据在该面版显示出来；　　我在自己的面版本点击某个按钮，可以把数据发送给服务器应用。 　　通过本章的学习，您将能实现以上的功能，实际上在RTX客户端添加一个面版，就是把自己做好的一个ActiveX控件嵌入进插件，插件加截时把Ocx显示出来；因此开发RTX插件需要对ActiveX控件及COM有一定的了解。 技术说明 正如前言介绍，在客户端添加面版，需要把自己做好的一个ActiveX控件嵌入进插件，因此要创建两个工程，一个ActiveX控件工程（本文ActiveX为ocx），实现界面的功能；一个是RTX插件工程(插件简称dll)；实现与RTX内核交互的功能。 即然是两个不同的模块，必须先解决ocx与dll之间数据传输，本文通过ATL事件解决此问题，ATL事件是本文的主要难点。 注意：ocx向应用发送数据时，不需要先把数据发给dll，再由dll发给应用，直接通过ocx在初始化时得到的IRTXCRootPtr指针获取IRTXModulePtr 发送数据；当dll收到从应用发过来消息时，激发ATL事件，ocx通过ATL事件接收器获取事件，并得到事件传过来的数据。 另外把ocx嵌入dll需要在ocx 实现几个插件接口，否则它们无法关联在一起，这一点应该比较好理解。 插件与ActiveX控件主要技术要点和步骤如下： 插件要点 生成RTX插件工程 ATL组件设计 DLL事件激发设计 ActiveX控件要点 1. 创建ocx工程 2. 实现插件接口 3. 事件接收器设计 4. ocx界面设计 5. 收发数据 插件打包 1. 打包准备 2. 打包步骤 安装调试 1. 安装插件 2. 启动应用 3. 插件发数据给应用 2. 应用发数据给插件 操作步骤 插件开发步骤 生成RTX插件工程 先安装RTXCSDK安装包，在其安装目录下有三个文件夹我们必须了解； wizard文件夹： 插件生成向导文件RTXCModuleAW.awx放在该目录下，开发前第一件事就是先把RTXCModuleAW.awx文件拷贝到VC安装目录Microsoft Visual Studio\COMMON\MSDev98\Template\ 文件下。 Include与tlb文件夹： 插件开发时所需要的.h文件及.tlb???件放在该目录下，建议创建插件工程时，工程保存路径设为RTXCSDK安装目录\samples\VC 下，因为向导生成插件工程时，默认把.h及tlb的路径指导上两级的include与tbl文件夹。 第一步：利用RTX Client Module AppWizard生成插件框架，Location选择RTXCSDK安装目录\samples\VC，如图1.1所示。 图1.1 创建RTX Client Module AppWizard 第二步：设置插件的基本信息，如图1.2所示。 图1.2 设置插件信息 第三步：设置插件需要支持的特性，如图1.3所示。 图1.3 设置插件需要支持的特性 第四步：完成向导，点击Finish完成向导，将自动生成我们上面选择特性的类与方法等，如图1.4所示。 图1.4 插件自动生成的类 ATL组件设计 设计ATL组件是为了dll收到数据时激发事件，通过事件把数据传给ocx；应用与插件之间发送数据时序图1.5所示。 图1.5 App与Dll之间数据收发 建议通过VC6.0的向导生成ATL组件代码，这样不易出错，下面是生成的步骤，请按我的步骤操作，以免出错。 第一步：创建ATL对象，右击类视图中的插件工程名称，选择“New ATL Object”，在弹出提示窗口中选择“是”。如图1.6所示： 图1.6 创建ATL对象 第二步：设置ATL对象相关信息，选“Simple Object” - “Next”；在Names页面填写“ShortName”，???他参数将自动生成；在Attribute页面把“Support IsupportErrorInfo”和“Support Connection Points”打上钩，如图1.7、1.8、1.9所示： 图1.7 创建Simple Object 图1.8 填写Name 图1.9 填写Attribute 通过以上的操作，我们的工程自动生一个CRTXEvent类和一个_IRTXEventEvents事件接口。如图２.0所示： 图2.0 CRTXEvent类 第三步：在“_IRTXEventEvents”接口添加一个方法，右击类视图中“_IRTXEventEvents”