Windows API一日一练(17)DialogBox和DialogBoxParam函数

对话框是比较常用的窗口，比如当你想让用户输入一些参数时就可以使用对话框。或者提示一些警告的信息，都是可以使用对话框的。比如当你拷贝文件时， Windows 就会提示一个拷贝文件的进度对话框。对话框的使用范围比较广，并且它在设计时就可以看到运行的结果模样，这样方便设计。但对话框又分为两类，一种对话框运行后，一定要用户关闭那个对话框后才能返回到父窗口；一种对话框是不需要关闭后就可以直接返回父窗口。因此，软件开发人员就要考虑这个对话框的结果是否会影响后面的操作，如果这个对话框的结果跟后面的操作没有因果关系的，可以设置为第二种对话框。像拷贝文件的对话框就是第二种的对话框，称作无模式的对话框。如果设置为第一类，非要等那里拷贝文件才可以去操作其它东西，那么 Windows 就不方便使用了，这样会浪费大量的时间。让人等待，就是一个不好用的软件，所以软件开发人员设计软件时，要站在用户的立场思考问题，在保持软件正确的情况下，不要让人等待，任何让人等待超过 20 秒以上的软件，会让用户烦躁不安。如果非要等待的话，也要加入进度条对话框提示，这样可以有效地缓解用户烦躁不安的心情。这就跟你去银行排队时，可以坐在那里看着电视，感觉不到时间长的道理一样的。

函数 DialogBox 函数和 DialogBoxParam 函数声明如下：

#define DialogBoxA(hInstance, lpTemplate, hWndParent, lpDialogFunc) /

DialogBoxParamA(hInstance, lpTemplate, hWndParent, lpDialogFunc, 0L)

#define DialogBoxW(hInstance, lpTemplate, hWndParent, lpDialogFunc) /

DialogBoxParamW(hInstance, lpTemplate, hWndParent, lpDialogFunc, 0L)

#ifdef UNICODE

#define DialogBox DialogBoxW

#else

#define DialogBox DialogBoxA

#endif // !UNICODE

WINUSERAPI

INT_PTR

WINAPI

DialogBoxParamA(

__in_opt HINSTANCE hInstance,

__in LPCSTR lpTemplateName,

__in_opt HWND hWndParent,

__in_opt DLGPROC lpDialogFunc,

__in LPARAM dwInitParam);

WINUSERAPI

INT_PTR

WINAPI

DialogBoxParamW(

__in_opt HINSTANCE hInstance,

__in LPCWSTR lpTemplateName,

__in_opt HWND hWndParent,

__in_opt DLGPROC lpDialogFunc,

__in LPARAM dwInitParam);

#ifdef UNICODE

#define DialogBoxParam DialogBoxParamW

#else

#define DialogBoxParam DialogBoxParamA

#endif // !UNICODE

hInstance 是当前应用程序的实例句柄。

lpTemplateName 是对话框的资源模板。

hWndParent 是父窗口的句柄。

lpDialogFunc 是对话框的消息处理函数。

dwInitParam 是初始化参数，这里缺省设置为 0 。

调用这个函数的例子如下：

#001 //

#002 // 目的 : 处理主窗口的消息 .

#003 //

#004 // 蔡军生 2007/07/12 QQ:9073204

#005 //

#006 LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)

#007 {

#008 int wmId, wmEvent;

#009 PAINTSTRUCT ps;

#010 HDC hdc;

#011

#012 switch (message)

#013 {

#014 case WM_COMMAND:

#015 wmId = LOWORD(wParam);

#016 wmEvent = HIWORD(wParam);

#017 // 菜单选项命令响应 :

#018 switch (wmId)

#019 {

#020 case IDM_ABOUT:

#021 DialogBox(hInst, MAKEINTRESOURCE(IDD_ABOUTBOX), hWnd, About);

#022 break;

#023 case IDM_EXIT:

#024 DestroyWindow(hWnd);

#025 break;

#026 default:

#027 return DefWindowProc(hWnd, message, wParam, lParam);

#028 }

#029 break;

#030 case WM_PAINT:

#031 hdc = BeginPaint(hWnd, &ps);

#032 //

#033 EndPaint(hWnd, &ps);

#034 break;

#035 case WM_DESTROY:

#036 PostQuitMessage(0);

#037 break;

#038 default:

#039 return DefWindowProc(hWnd, message, wParam, lParam);

#040 }

#041 return 0;

#042 }

第 21 行就是调用函数 DialogBox 来显示对话框窗口。

对话框的模板如下：

/////////////////////////////////////////////////////////////////////////////

// Dialog

IDD_ABOUTBOX DIALOGEX 22, 17, 230, 75

STYLE DS_SETFONT | DS_MODALFRAME | WS_CAPTION | WS_SYSMENU

CAPTION " 关于 "

FONT 9, " 新宋体 ", 400, 0, 0x86

BEGIN

ICON IDI_TESTWIN,IDC_MYICON,14,9,21,21

LTEXT "TestWin Version 1.0",IDC_STATIC,49,10,119,8,SS_NOPREFIX

DEFPUSHBUTTON " 确定 ",IDOK,185,51,38,16,WS_GROUP

END

IDD_ABOUTBOX 是对话框模板的名称。

DIALOGEX 是对话框定义的关键字。

22, 17, 230, 75 是对话框的坐标和大小。

STYLE 是设置对话框的显示类型。

CAPTION 是定义标题名称。这里是 " 关于 " 。

FONT 是定义对话的字体。

ICON 是定义一个图标显示。

LTEXT 是定义显示静态文本。

DEFPUSHBUTTON 是定义一个按钮。

秒客网

Windows API一日一练(17)DialogBox和DialogBoxParam函数

相关文章