如何在MFC单文档项目CView中通过代码显示ATL ActiveX控件

完全不需要依赖CFormView相关方案，MFC原生提供了ActiveX控件动态承载能力，可以直接在CView中通过代码完成控件创建与展示，具体实现步骤如下：

前置配置 #

• 确认项目已开启ActiveX容器支持：在应用类CxxxApp的InitInstance函数中，确保存在AfxEnableControlContainer()调用，这是MFC承载ActiveX控件的必要基础，新建项目时勾选ActiveX支持选项会自动添加该调用，未勾选的话手动补上即可。
• 为目标ATL控件生成MFC包装类：在VS类视图中右键选择「添加」->「添加类」->「MFC类别下的ActiveX控件类」，在列表中选中你开发完成的ATL控件，IDE会自动生成对应的CWnd派生包装类，后续直接通过该类操作控件即可，无需手动处理COM接口调度。

核心代码实现 #

• 在你的CView派生类头文件中，声明控件包装类的成员变量：

// 自定义控件ID，保证在当前视图内不重复即可
#define IDC_MY_ATL_CTRL 1001

private:
    // CMyAtlCtrl替换为你生成的ATL控件包装类名
    CMyAtlCtrl m_atlCtrl;

• 为CView添加WM_CREATE消息处理函数OnCreate，在视图窗口初始化完成后动态创建控件：

int CYourCustomView::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
    if (CView::OnCreate(lpCreateStruct) == -1)
        return -1;

    // 初始控件位置大小，可按需调整
    CRect initRect(0, 0, 0, 0);
    // 第一个参数传入控件的ProgID或者CLSID字符串，可在生成的包装类头文件注释中找到
    if (!m_atlCtrl.Create(_T("替换为你的ATL控件ProgID"), this, initRect, WS_CHILD | WS_VISIBLE, IDC_MY_ATL_CTRL))
    {
        AfxMessageBox(_T("ATL控件创建失败，请检查控件是否正确注册"));
        return -1;
    }

    return 0;
}

注意：创建控件时必须指定WS_CHILD样式，父窗口指针传入当前CView指针，否则控件无法正确挂载到视图窗口上。

• 为CView添加WM_SIZE消息处理函数OnSize，视图尺寸变化时同步调整控件大小，实现铺满客户区的展示效果：

void CYourCustomView::OnSize(UINT nType, int cx, int cy)
{
    CView::OnSize(nType, cx, cy);

    if (m_atlCtrl.GetSafeHwnd())
    {
        CRect clientRect;
        GetClientRect(&clientRect);
        // 这里如果需要固定控件大小、留边等布局，直接修改传入的矩形参数即可
        m_atlCtrl.MoveWindow(clientRect);
    }
}

• 为CView添加WM_DESTROY消息处理函数OnDestroy，视图销毁时主动释放控件资源：

void CYourCustomView::OnDestroy()
{
    if (m_atlCtrl.GetSafeHwnd())
    {
        m_atlCtrl.DestroyWindow();
    }
    CView::OnDestroy();
}

常见问题说明 #

• 控件创建后不响应键鼠操作：首先检查创建时是否添加了WS_VISIBLE样式，其次确认AfxEnableControlContainer()已正确调用，MFC的控件容器层会自动完成ActiveX控件的消息路由，不需要手动转发消息。
• 需要响应控件抛出的事件：直接通过类向导为包装类添加事件响应函数即可，逻辑和在CDialog中使用ActiveX控件完全一致。
• 不想使用IDE生成的包装类：可以直接调用CWnd::CreateControl方法创建控件，只是后续调用控件接口、响应事件需要手动处理IDispatch调度，开发效率更低，没有特殊需求不推荐。

控件在CView中展示效果参考

内容的提问来源于stack exchange，提问作者Hoang Anh Phan