如何在Visual Studio C++窗体中动态添加自定义组框控件类

阿华AIGC实验室

2026-5-25

刚从Qt转用Visual Studio做C++窗体开发确实得适应一阵，我来一步步帮你实现这个和Qt里cal_widget对应的自定义控件单元——包含两个EditBox、一个Button并嵌套在GroupBox里，还能动态添加到主窗体里。

实现自定义GroupBox控件单元

下面分两种常用的Visual Studio C++窗体框架来讲解，你可以根据自己的需求选择：

一、MFC框架（原生C++）

这是Visual Studio里最经典的原生C++窗体框架，和Qt的底层逻辑更接近。

1. 创建自定义控件类

打开Visual Studio，新建一个MFC基于对话框的项目（先搭个基础环境）。
右键项目 → 添加 → 类，选择「MFC类」，基类选CGroupBox，类名命名为CalWidget（和你Qt里的cal_widget对应）。

2. 定义子控件与实现初始化

打开CalWidget.h，声明子控件成员和必要的方法：

class CalWidget : public CGroupBox
{
    DECLARE_DYNAMIC(CalWidget)

public:
    CalWidget();
    virtual ~CalWidget();

protected:
    DECLARE_MESSAGE_MAP()
private:
    // 对应Qt的两个EditBox
    CEdit m_edit1;
    CEdit m_edit2;
    // 对应Qt的Button
    CButton m_btn;
public:
    // 重写Create方法，用来初始化所有子控件
    virtual BOOL Create(LPCTSTR lpszCaption, DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID);
    // 按钮点击的响应函数
    afx_msg void OnBtnClicked();
};

然后在CalWidget.cpp里实现具体逻辑：

#include "pch.h"
#include "CalWidget.h"

IMPLEMENT_DYNAMIC(CalWidget, CGroupBox)

CalWidget::CalWidget()
{
}

CalWidget::~CalWidget()
{
}

BEGIN_MESSAGE_MAP(CalWidget, CGroupBox)
    // 绑定按钮点击事件，IDC_CAL_BTN是咱们自定义的按钮ID
    ON_BN_CLICKED(IDC_CAL_BTN, &CalWidget::OnBtnClicked)
END_MESSAGE_MAP()

BOOL CalWidget::Create(LPCTSTR lpszCaption, DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID)
{
    // 先创建GroupBox本身
    if (!CGroupBox::Create(lpszCaption, dwStyle, rect, pParentWnd, nID))
    {
        return FALSE;
    }

    // 统一控件字体（可选，让样式更协调）
    CFont* pFont = GetParent()->GetFont();
    SetFont(pFont);

    // 创建第一个EditBox，位置相对于GroupBox的客户区
    RECT editRect1 = {20, 30, 150, 50};
    m_edit1.Create(WS_CHILD | WS_VISIBLE | WS_BORDER, editRect1, this, IDC_CAL_EDIT1);
    m_edit1.SetFont(pFont);

    // 创建第二个EditBox
    RECT editRect2 = {170, 30, 300, 50};
    m_edit2.Create(WS_CHILD | WS_VISIBLE | WS_BORDER, editRect2, this, IDC_CAL_EDIT2);
    m_edit2.SetFont(pFont);

    // 创建按钮
    RECT btnRect = {120, 70, 200, 95};
    m_btn.Create(_T("校准"), WS_CHILD | WS_VISIBLE | BS_PUSHBUTTON, btnRect, this, IDC_CAL_BTN);
    m_btn.SetFont(pFont);

    return TRUE;
}

void CalWidget::OnBtnClicked()
{
    // 这里写按钮点击后的业务逻辑，比如获取输入内容
    CString text1, text2;
    m_edit1.GetWindowText(text1);
    m_edit2.GetWindowText(text2);
    // 示例：弹出提示框展示输入内容
    AfxMessageBox(_T("校准按钮被点击！输入1：") + text1 + _T("，输入2：") + text2);
}

3. 动态添加到主窗体

打开主对话框类（比如CMainDlg），先在头文件里声明一个指针变量（方便后续管理）：

private:
    CalWidget* m_pCalWidget;

然后在主对话框的初始化函数（OnInitDialog）或者某个按钮响应函数里，动态创建并添加控件：

BOOL CMainDlg::OnInitDialog()
{
    CDialogEx::OnInitDialog();

    // 设置对话框图标（默认生成的代码，保留即可）
    SetIcon(m_hIcon, TRUE);
    SetIcon(m_hIcon, FALSE);

    // 定义自定义控件的位置和大小
    RECT calRect = {50, 50, 350, 150};
    m_pCalWidget = new CalWidget();
    // 创建控件，参数分别是标题、样式、位置、父窗口、控件ID
    m_pCalWidget->Create(_T("校准单元"), WS_CHILD | WS_VISIBLE | BS_GROUPBOX, calRect, this, IDC_CAL_WIDGET);

    return TRUE;
}

// 记得在对话框销毁时释放内存，避免泄漏
void CMainDlg::OnDestroy()
{
    CDialogEx::OnDestroy();
    if (m_pCalWidget)
    {
        delete m_pCalWidget;
        m_pCalWidget = nullptr;
    }
}

4. 关键注意事项

所有自定义控件ID需要在Resource.h里提前定义，比如：

#define IDC_CAL_EDIT1  1001
#define IDC_CAL_EDIT2  1002
#define IDC_CAL_BTN    1003
#define IDC_CAL_WIDGET 1004

MFC没有Qt那样的自动布局，需要手动计算控件位置；如果需要自适应窗口大小，得重写WM_SIZE消息的响应函数来调整控件位置。

二、C++/CLI Windows Forms（托管C++）

如果你更习惯Qt的快速开发风格，托管C++的Windows Forms会更上手，语法和C# WinForms接近。

1. 创建自定义GroupBox类

新建一个**Windows Forms应用程序（C++/CLI）**项目，然后添加一个自定义控件类：

ref class CalWidget : public System::Windows::Forms::GroupBox
{
public:
    System::Windows::Forms::TextBox^ edit1;
    System::Windows::Forms::TextBox^ edit2;
    System::Windows::Forms::Button^ btn;

    CalWidget()
    {
        // 初始化GroupBox本身
        this->Text = "校准单元";
        this->Size = System::Drawing::Size(300, 120);

        // 创建第一个TextBox（对应Qt的EditBox）
        edit1 = gcnew System::Windows::Forms::TextBox();
        edit1->Location = System::Drawing::Point(20, 30);
        edit1->Size = System::Drawing::Size(120, 20);
        this->Controls->Add(edit1);

        // 创建第二个TextBox
        edit2 = gcnew System::Windows::Forms::TextBox();
        edit2->Location = System::Drawing::Point(150, 30);
        edit2->Size = System::Drawing::Size(120, 20);
        this->Controls->Add(edit2);

        // 创建按钮并绑定点击事件
        btn = gcnew System::Windows::Forms::Button();
        btn->Text = "校准";
        btn->Location = System::Drawing::Point(100, 70);
        btn->Click += gcnew System::EventHandler(this, &CalWidget::OnBtnClicked);
        this->Controls->Add(btn);
    }

    // 按钮点击响应函数
    void OnBtnClicked(System::Object^ sender, System::EventArgs^ e)
    {
        System::Windows::Forms::MessageBox::Show("输入1：" + edit1->Text + "\n输入2：" + edit2->Text);
    }
};

2. 动态添加到主窗体

在主窗体的构造函数或者某个按钮点击事件里，直接创建并添加：

// 比如在主窗体的构造函数里
Form1(void)
{
    InitializeComponent();

    // 动态创建自定义控件
    CalWidget^ calWidget = gcnew CalWidget();
    calWidget->Location = System::Drawing::Point(50, 50);
    this->Controls->Add(calWidget);
}

这种方式不需要手动管理内存，CLR会自动回收，布局也可以用Visual Studio的可视化设计器调整，更接近Qt的体验。

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