非全项目启用CLR的MFC项目嵌入WinForms控件不显示问题

控件无法显示的首要bug是你将CWinFormsControl<MainuserControlLib::UserControl2>实例声明为CreateFullListeUc函数内的局部栈变量：函数执行完成后局部变量立刻析构，托管控件的关联窗口句柄会被同步销毁，根本无法持久附着在对话框窗口上。除此之外局部启用CLR嵌入WinForms还有几个必踩的配置坑，按以下步骤修复即可正常显示，不需要全局开启CLR。

• 修正控件实例生命周期问题
  绝对不能把承载WinForms控件的CWinFormsControl实例放在函数局部作用域。你可以将其声明为托管对接类的静态成员，或者通过Pimpl模式将其绑定到MFC对话框的生命周期，保证实例在对话框存活期间不会被析构。
  注意：不要在非CLR编译的MFC头文件中直接暴露托管类型，否则会触发编译错误。可以用不透明指针、静态成员的方式隔离托管类型定义，保证非/clr编译的代码看不到托管类型声明。
• 修正占位控件ID
  你代码中传入的IDC_STATIC1如果是默认拖入的静态文本控件，默认ID为IDC_STATIC（值为-1），DDX逻辑无法匹配到正确的占位窗口。需要在资源编辑器中手动将占位静态控件的ID改为唯一非默认值（例如IDC_WINFORM_HOST），再传入该ID。
• 校验单文件CLR编译配置
  仅给包含托管代码、引用<afxwinforms.h>的源文件开启CLR支持即可，不需要全局开：
  1. 右键托管代码源文件 -> 属性 -> C/C++ -> 常规 -> 公共语言运行时支持 -> 选择公共语言运行时支持(/clr)
  2. 确认该文件的MFC链接配置、运行时库配置和全局项目完全一致，避免运行时不匹配崩溃
  3. 所有非/clr编译的源文件，不要包含任何托管头、不要引用任何托管类型，否则会报编译错误
• 提前初始化WinForms宿主环境
  在MFC应用InitInstance函数中、创建主对话框之前，调用WinForms初始化逻辑，该逻辑必须放在开启/clr编译的源文件中：

  System::Windows::Forms::Application::EnableVisualStyles();
  AfxWinFormsInit();
  

托管对接头文件（仅被CLR编译的源文件引用）：

// Managedfile.h
#pragma once
class CWinformsUtil
{
public:
    static void InitWinFormEnv();
    static void CreateFullListeUc(CDataExchange* pDX, int Idc);
private:
    static CWinFormsControl<MainuserControlLib::UserControl2> m_ctrl1;
};

托管对接实现文件（开启/clr编译）：

// Managedfile.cpp
#include <afxwin.h> 
#include <afxwinforms.h>
#include "Managedfile.h"

CWinFormsControl<MainuserControlLib::UserControl2> CWinformsUtil::m_ctrl1;

void CWinformsUtil::InitWinFormEnv()
{
    System::Windows::Forms::Application::EnableVisualStyles();
    AfxWinFormsInit();
}

void CWinformsUtil::CreateFullListeUc(CDataExchange* pDX, int Idc)
{
    DDX_ManagedControl(pDX, Idc, m_ctrl1);
}

MFC应用初始化入口调用：

BOOL CMFCApplication1App::InitInstance()
{
    // 原有初始化逻辑...
    CWinformsUtil::InitWinFormEnv(); // 加在创建对话框之前
    CMFCApplication1Dlg dlg;
    m_pMainWnd = &dlg;
    INT_PTR nResponse = dlg.DoModal();
    // 后续逻辑...
}

对话框DoDataExchange逻辑保持原有调用即可。

如果需要在多个对话框实例中嵌入该控件，不要用静态成员，改为给每个对话框类添加Pimpl指针，将CWinFormsControl实例存在Pimpl结构体中，绑定对话框的构造/析构生命周期即可，避免多实例共享同一个控件对象的问题。

内容的提问来源于stack exchange，提问作者med