DialogBox() -- 从模板资源创建对话框

beyes

DialogBox() 函数原型如下：

[C++] 纯文本查看 复制代码

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

该函数从模板资源创建一个对话框。函数在指定的回调函数(第 4 个参数)调用 EndDialog()  函数将对话框终结后才会返回。

第 1 个参数 hInstance 是程序实例句柄，一般就是 WinMain() 里的第 1 个参数。

第 2 个参数 lpTemplate 是个对话框模板指针，它既可以是一个指向以 null 结尾的字符串指针，也可以是对话框模板的资源标识(一个整数)。如果是后者，那么需要用 MAKEINTRESOURCE 宏对其进行转换，该宏强制转换一个整数类型为一个指针类型，它定义如下：

#define MAKEINTRESOURCE(i)  (LPTSTR) ((DWORD) ((WORD) (i)))

第 3 个参数 hWndParent 是该对话框的父窗口句柄。

第 4 个参数 lpDialogFunc 是对话框处理函数指针，它所指向的函数是个程序定义(application-defined)回调函数( DialogProc() ，所谓程序定义就是说用户在程序中自定义)，它处理发送到一个模态的或无模式对话框的消息定义形式为：

[C++] 纯文本查看 复制代码

BOOL CALLBACK DialogProc(  HWND hwndDlg,   
UINT uMsg,  
 WPARAM wParam, 
  LPARAM lParam);

比如下面一个窗口如下，它本身就是一个对话框：

当点击上图中的左下角的小问号时会弹出下面的对话框：


这个过程的实现描述如下：

在主对话框的消息处理函数里可用下面代码：

[C++] 纯文本查看 复制代码

    case WM_COMMAND: 
        switch (LOWORD (wParam))
        {
    
        case IDC_ABOUT :
        case IDM_HELP_ABOUT :
            DialogBox (hInst, MAKEINTRESOURCE (IDD_ABOUT), hDlg, AboutDlgProc) ;
            break;

在上面的 DialogBox() 函数里的 AboutDlgProc() 就是按下小问号按钮时弹出的对话框的处理函数，它的实现如下：

[C++] 纯文本查看 复制代码

/*-------------------------------------------------------------*/
/* AboutDlgProc － 关于窗口                                    */
/*-------------------------------------------------------------*/

BOOL CALLBACK AboutDlgProc (HWND hDlg, UINT message, 
                            WPARAM wParam, LPARAM lParam)
{
    switch (message)
    {
        
    case WM_COMMAND :
        switch (LOWORD (wParam))                      
        {
        case IDOK :
        case IDCANCEL :
            EndDialog (hDlg, 0) ;
            return TRUE ;
         }
          break ;
     }
     return FALSE ;
}

注意，上面函数中使用了 EndDialog() 函数，当按下弹出的对话框的 OK 按钮时，执行这个函数并终结掉该对话框。