基于Ribbon的MFC MDI应用中可停靠对话框创建失败问题

问题背景 #

开发基于Ribbon的MFC MDI应用，实现可停靠对话框功能：

• 已创建继承自CDialogEx的对话框类DockColorDlg
• 已创建继承自CDockablePane的ColorDockable类，其中包含DockColorDlg实例m_wndDialog
• 初期运行正常，但多次编译/操作后，对话框无法创建，ColorDockable::OnCreate中输出TRACE信息Failed to create dialog

相关代码 #

Mainfrm.cpp中创建可停靠窗格的代码 #

if (!m_wndMyDockablePane.Create(_T("Weaves & Color"), this, CRect(0, 0, 200, 200), TRUE, ID_VIEW_MYDOCKABLEPANE, WS_CHILD | WS_VISIBLE | CBRS_TOP))
{
    TRACE0("Failed to create dockable pane\n");
    return -1; // fail to create
}   

m_wndMyDockablePane.EnableDocking(CBRS_ALIGN_RIGHT | CBRS_ALIGN_LEFT);

DockPane(&m_wndMyDockablePane);

ColorDockable.cpp中的OnCreate函数 #

int ColorDockable::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
    TRACE("ColorDockable::OnCreate called\n");

    if (CDockablePane::OnCreate(lpCreateStruct) == -1)
        return -1;

    if(!m_wndDialog.Create(IDD_DOC_COLOR_DLG, this));
    {
        TRACE("Failed to create dialog\n");
        return 0; // Fail to create
    }
    bool check = m_wndDialog.ShowWindow(SW_SHOWNORMAL);
    m_wndDialog.SetWindowPos(NULL, 0, 0, lpCreateStruct->cx, lpCreateStruct->cy, SWP_NOZORDER | SWP_SHOWWINDOW);
    //ShowDockableDialog();
    return 0;
}

问题分析与解决步骤 #

1. 修复语法错误（核心问题） #

代码中if(!m_wndDialog.Create(...));末尾多了一个分号，导致条件判断后的代码块无论Create是否成功都会执行，并且直接return 0中断后续逻辑，这是对话框创建失败的直接原因。

修改后的代码：

int ColorDockable::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
    TRACE("ColorDockable::OnCreate called\n");

    if (CDockablePane::OnCreate(lpCreateStruct) == -1)
        return -1;

    // 去掉末尾的分号，让代码块正确关联条件判断
    if(!m_wndDialog.Create(IDD_DOC_COLOR_DLG, this))
    {
        TRACE("Failed to create dialog\n");
        return -1; // 返回-1表示窗口创建失败，而非0
    }
    m_wndDialog.ShowWindow(SW_SHOWNORMAL);
    m_wndDialog.SetWindowPos(NULL, 0, 0, lpCreateStruct->cx, lpCreateStruct->cy, SWP_NOZORDER | SWP_SHOWWINDOW);
    return 0;
}

注意：OnCreate返回非0值才会终止窗口创建流程，原代码返回0会导致可停靠窗格继续创建，但对话框未成功初始化。

2. 检查对话框资源配置 #

• 确认IDD_DOC_COLOR_DLG对应的对话框资源存在，且资源ID未被修改或重复占用
• 对话框样式需设置为Child（而非Popup），因为作为子窗口嵌入到可停靠窗格中，Popup样式无法作为子窗口创建

3. 清理编译缓存 #

多次编译后可能存在资源缓存问题，执行以下操作：

• 点击VS菜单的项目 -> 清理
• 再执行生成 -> 重新生成解决方案

4. 验证成员变量声明 #

确保ColorDockable类中m_wndDialog的声明正确：

// ColorDockable.h中
private:
    DockColorDlg m_wndDialog; // 声明为实例而非指针，无需额外初始化

5. 确认父窗口状态 #

在调用m_wndDialog.Create前，可添加判断确保父窗口已创建：

if (!IsWindow(m_hWnd))
{
    TRACE("Parent window not ready\n");
    return -1;
}

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