当前位置：首页 > 开发 > C and C++ > 正文内容

DialogBox和DialogBoxParam

C and C++8个月前 (04-02)

DialogBox和DialogBoxParam函数介绍

DialogBox和DialogBoxParam是Windows API中用于创建模态对话框的两个重要函数，属于User32库，通常通过包含<windows.h>头文件并链接User32.lib使用。

模态对话框特点：会阻塞父窗口的消息循环，直到对话框关闭。

DialogBox函数

INT_PTR DialogBox( HINSTANCE hInstance, LPCTSTR lpTemplate, HWND hWndParent, DLGPROC lpDialogFunc );

参数说明

参数	类型	描述
hInstance	HINSTANCE	应用程序实例句柄（通常为GetModuleHandle(NULL)）
lpTemplate	LPCTSTR	对话框模板资源标识（字符串或MAKEINTRESOURCE宏转换的整型ID）
hWndParent	HWND	父窗口句柄（可为NULL）
lpDialogFunc	DLGPROC	对话框过程回调函数

返回值

成功时返回EndDialog函数调用时指定的值（通常用于传递对话框结果，如IDOK或IDCANCEL）
失败时返回0或-1，可通过GetLastError获取错误信息

示例代码

// 对话框过程
BOOL CALLBACK DlgProc(HWND hDlg, UINT msg, WPARAM wParam, LPARAM lParam) {
    switch (msg) {
        case WM_INITDIALOG:
            // 初始化代码
            return TRUE;
        case WM_COMMAND:
            if (LOWORD(wParam) == IDOK) {
                EndDialog(hDlg, IDOK);
                return TRUE;
            }
            break;
    }
    return FALSE;
}

// 创建对话框
void ShowSimpleDialog(HWND hParent) {
    DialogBox(
        GetModuleHandle(NULL),
        MAKEINTRESOURCE(IDD_SIMPLE_DIALOG),
        hParent,
        DlgProc
    );
}

DialogBoxParam函数

INT_PTR DialogBoxParam( HINSTANCE hInstance, LPCTSTR lpTemplate, HWND hWndParent, DLGPROC lpDialogFunc, LPARAM dwInitParam );

新增参数

参数	类型	描述
dwInitParam	LPARAM	用户定义的参数，通过WM_INITDIALOG消息的lParam传递给对话框过程

优势：允许传递初始化数据（如结构体指针），避免使用全局变量，增强代码封装性。

示例代码

// 自定义初始化数据结构
struct InitData {
    const char* title;
    int defaultValue;
};

// 对话框过程（带参数处理）
BOOL CALLBACK ParamDlgProc(HWND hDlg, UINT msg, WPARAM wParam, LPARAM lParam) {
    switch (msg) {
        case WM_INITDIALOG: {
            InitData* data = (InitData*)lParam;
            SetWindowText(hDlg, data->title);
            SetDlgItemInt(hDlg, IDC_EDIT1, data->defaultValue, TRUE);
            return TRUE;
        }
        case WM_COMMAND:
            if (LOWORD(wParam) == IDOK) {
                EndDialog(hDlg, IDOK);
                return TRUE;
            }
            break;
    }
    return FALSE;
}

// 创建带参数的对话框
void ShowParamDialog(HWND hParent) {
    InitData data = {"参数设置", 100};
    DialogBoxParam(
        GetModuleHandle(NULL),
        MAKEINTRESOURCE(IDD_PARAM_DIALOG),
        hParent,
        ParamDlgProc,
        (LPARAM)&data
    );
}

关键区别

特性	DialogBox	DialogBoxParam
参数传递	不支持	支持通过dwInitParam传递初始化数据
使用场景	简单对话框，无需额外初始化	需要初始化数据的复杂对话框
代码结构	可能需要全局变量	更好的封装性