如何用VS2008开发ActiveX控件？ActiveX开发实战教程

直接开始VS2008 ActiveX开发教程

开发环境准备

• 必备软件： 安装 Visual Studio 2008 (推荐 Professional 或更高版本)，确保安装时选择了 Visual C++ 和 MFC 组件。
• 目标平台识别： 明确你的 ActiveX 控件将在什么环境下运行 (如：特定浏览器 IE、旧版业务系统 XP/Win7)，这决定了项目设置中的运行时库 (如 /MT 或 /MD) 和代码安全要求。
• 项目创建启动： 打开 VS2008 -> 文件 -> 新建 -> 项目，在 Visual C++ -> MFC 下选择 “MFC ActiveX 控件”，输入项目名 (如 MyFirstCtrl)，选择位置，点击 确定，在向导中：
  • 控件设置： 保持默认命名或修改 (影响后续的 CLSID、ProgID)。
  • 功能选择： 勾选 在“插入对象”对话框中可用、运行时不可见 (按需)、关于框 (可选)，其他高级特性如复合控件、异步加载按需勾选。
  • 控件子类化 (可选)： 若需基于标准 Windows 控件 (如按钮、列表框) 构建，在此处选择，否则创建空白控件。
  • 完成向导： 点击 完成，VS 自动生成框架代码和基础文件 (.cpp, .h, .idl, .rgs, .def)。

理解生成的核心文件

• MyFirstCtrlCtrl.h/.cpp： 控件主类 (CMyFirstCtrlCtrl) 的实现，继承自 COleControl，核心逻辑所在。
• MyFirstCtrl.idl： 接口定义语言文件，定义控件暴露的属性、方法和事件接口，后续添加接口在此修改。
• MyFirstCtrl.rgs： 注册表脚本，控件注册/注销时写入/删除的注册表项，包含 CLSID、ProgID、线程模型等关键信息。
• MyFirstCtrl.def： 模块定义文件，导出 DLL 函数 (如 DllRegisterServer, DllGetClassObject)。

实现核心功能：属性与方法

• 添加自定义属性 (Property)：
  1. 在 类视图 中右键控件类 (CMyFirstCtrlCtrl) -> 添加 -> 添加属性。
  2. 输入属性名 (如 TextColor)，选择类型 (如 OLE_COLOR)，通常选择 成员变量 方式实现。
  3. VS 会自动在 .h 文件中添加成员变量 (如 m_textColor) 和在 .cpp 中添加 Get/Set 函数骨架及调度映射 (DISP_PROPERTY)，在 GetTextColor() 和 SetTextColor() 中实现具体逻辑。
• 添加自定义方法 (Method)：
  1. 在 类视图 中右键控件类 -> 添加 -> 添加方法。
  2. 输入方法名 (如 ShowMessage)，设置返回类型 (如 void) 和参数 (如 [in] BSTR bstrMsg)。
  3. VS 生成方法声明和调度映射 (DISP_FUNCTION)，在方法实现 (ShowMessage) 中编写功能代码 (如 :MessageBoxW(NULL, bstrMsg, L"ActiveX Message", MB_OK);)。
• 修改 .idl 文件： 添加属性/方法后，检查 .idl 文件，确保 dispinterface 或 coclass 部分已正确包含新添加的接口描述，编译时会自动调用 MIDL 编译此文件生成类型库 (.tlb)。

实现事件 (Events)
ActiveX 控件通过连接点 (Connection Point) 向容器 (如网页) 触发事件。

1. 添加事件： 在 类视图 中右键控件类 -> 添加 -> 添加事件。
2. 定义事件： 输入事件名 (如 OnTextChanged)，设置参数 (如 [in] BSTR bstrNewText)。
3. 代码生成： VS 自动：
   • 在 .h 文件中声明事件触发函数 FireOnTextChanged(BSTR bstrNewText)。
   • 在 .cpp 中实现该函数 (内部调用 FireEvent)，并添加到事件映射 (EVENT_CUSTOM 或 EVENT_CUSTOM_ID)。
   • 更新 .idl 文件的 _DMyFirstCtrlEvents dispinterface。
4. 触发事件： 在控件逻辑需要的地方 (如属性 Text 的 Set 方法内部)，调用 FireOnTextChanged(m_bstrText);。

设计用户界面 (UI)

• 资源编辑： 打开 资源视图 -> Dialog，找到控件的对话框资源 (通常为 IDD_MYFIRSTCTRL)，使用工具箱拖放标准 Windows 控件 (按钮、编辑框等)。
• 关联控件变量： 右键对话框上的控件 -> 添加变量，选择 控件变量，并关联到控件类中的成员变量 (如 CEdit m_edtDisplay;)。
• 重写绘制： 如需自绘，重写 OnDraw(CDC pdc, const CRect& rcBounds, const CRect& rcInvalid)，使用 pdc 进行 GDI 绘图操作，注意坐标在 rcBounds 内。

持久化 (Persistence)
控件状态 (属性值) 需在容器保存/加载时持久化。

• 实现 DoPropExchange: 在控件类中重写此函数，使用 PX_ 系列函数序列化属性：

  void CMyFirstCtrlCtrl::DoPropExchange(CPropExchange pPX)
  {
      ExchangeVersion(pPX, MAKELONG(_wVerMinor, _wVerMajor));
      COleControl::DoPropExchange(pPX);
      PX_Long(pPX, _T("BackColor"), m_backColor, RGB(0xFF, 0xFF, 0xFF)); // 示例
      PX_String(pPX, _T("Caption"), m_caption, _T("Default Caption")); // 示例
  }

安全性与 IObjectSafety
现代浏览器 (尤其是保护模式下的 IE) 对 ActiveX 有严格安全要求，实现 IObjectSafety 接口告知容器控件是安全的。

1. 添加接口： 在 类视图 中右键控件类 -> 添加 -> 添加接口，选择 IObjectSafety。
2. 实现方法： 在生成的 IObjectSafety 实现类中 (如 CMyFirstCtrlCtrl::XObjectSafety)，实现 GetInterfaceSafetyOptions 和 SetInterfaceSafetyOptions，通常返回控件支持的安全选项 (如 INTERFACESAFE_FOR_UNTRUSTED_CALLER | INTERFACESAFE_FOR_UNTRUSTED_DATA) 并处理设置请求。
3. 更新注册表 (.rgs)： 在控件的注册项下添加 Implemented Categories 键及其子键，注册控件实现的组件类别 (CATID)：

   NoRemove Implemented Categories
   {
       {7DD95801-9882-11CF-9FA9-00AA006C42C4} // CATID_SafeForScripting
       {7DD95802-9882-11CF-9FA9-00AA006C42C4} // CATID_SafeForInitializing
   }

编译、注册与调试

• 编译： 选择 Release 配置 (确保 /O2 优化开启)，按 F7 编译生成 .ocx 文件。
• 注册：
  • 开发机： 以管理员身份运行 VS2008。生成 -> 注册 MyFirstCtrl.ocx (或手动执行 regsvr32.exe pathtoMyFirstCtrl.ocx)。
  • 部署： 创建安装包 (如使用 InstallShield Limited Edition for VS2008) 处理注册。
• 调试：
  1. 设置项目属性：调试 -> 命令 填入容器路径 (如 C:Program FilesInternet Exploreriexplore.exe)。
  2. 命令参数 填入包含控件的测试 HTML 文件路径 (如 "C:Testtest.html")。
  3. 在控件代码中设置断点,按 F5 启动调试，IE 将启动并加载测试页，命中断点后即可调试。

在网页中使用 (HTML/JS)
创建测试 HTML 文件：

<!DOCTYPE html>
<html>
<head>MyFirstCtrl Test</title>
    <script>
        function InitializeControl() {
            var ctrl = document.getElementById("MyCtrl");
            ctrl.TextColor = 0xFF0000; // 红色 (OLE_COLOR)
            ctrl.Caption = "Hello ActiveX!";
        }
        function CallShowMessage() {
            var ctrl = document.getElementById("MyCtrl");
            ctrl.ShowMessage("This is from JavaScript!");
        }
    </script>
</head>
<body onload="InitializeControl()">
    <object id="MyCtrl" classid="clsid:YOUR-CONTROL-CLSID-HERE" width="300" height="200">
        <param name="BackColor" value="16777215"> <!-- 白色 -->
    </object>
    <br>
    <button onclick="CallShowMessage()">Show Message</button>
</body>
</html>

• 将 YOUR-CONTROL-CLSID-HERE 替换为控件实际的 CLSID (在 .idl 文件或生成的 i.h 文件中查找)。
• <param> 标签用于设置设计时属性。

关键注意事项与高级技巧

• 线程模型： 默认项目生成的注册表脚本 (rgs) 通常指定 Apartment (STA)，确保控件代码线程安全，或根据实际使用环境调整 (如标记为 Free 或 Both)，错误模型会导致崩溃。
• 浏览器兼容性： ActiveX 主要限于旧版 IE (Trident)，明确告知用户运行环境要求，对于新 Edge (Chromium)，ActiveX 默认不支持。
• 内存管理： 严格遵守 COM 内存规则，使用 BSTR 时注意 SysAllocString/SysFreeString；传递接口指针时正确使用 AddRef/Release，智能指针 (CComBSTR, CComPtr, CComQIPtr) 是防止泄漏的利器。
• 错误处理： 在方法和属性访问器中，使用 COleControl::ThrowError 或设置 SetNotSupported/SetNotPermitted 向容器返回丰富的错误信息 (HRESULT, 描述)。
• 许可证 (Licensing)： 如需分发限制，实现许可支持 (IClassFactory2)，VS向导可添加基础支持。
• 性能优化： 避免在频繁调用的方法 (如 OnDraw) 中进行耗时操作，缓存 GDI 对象，考虑异步操作。
• 数字签名： 强烈建议 对最终发布的 .ocx 进行 Authenticode 代码签名，否则用户会遇到严重安全警告甚至阻止运行，获取商业代码签名证书是关键部署步骤。

安全实践：超越基础

• 输入验证： 对所有从容器 (JS) 传入的参数进行严格验证 (类型、范围、长度)，防止缓冲区溢出或注入攻击。
• 最小特权： 控件不应要求管理员权限执行常规功能，避免操作注册表敏感区域或系统文件，除非绝对必要且有明确用户授权。
• 沙箱考虑： 理解 IE 保护模式 (低完整性级别)，控件如需访问用户文件，应通过安全文件对话框 (IFileDialog) 或处理 PersistStreamInit 让容器处理持久化。
• 废弃 API 规避： 避免使用已知不安全的旧 API (如 strcpy, sprintf)，改用安全版本 (strcpy_s, sprintf_s) 或 ATL/MFC 包装类 (CString)。

互动：您在实际项目中遇到过哪些ActiveX开发的独特挑战？或者对于将遗留ActiveX功能迁移到现代Web技术有什么具体想法？欢迎分享您的经验或提问！