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

Post date: 2012/3/27 上午 07:18:59

分类: Direct3D2007-07-27 08:41 4743人阅读 评论(7) 收藏 举报

对话框是比较常用的窗口,比如当你想让用户输入一些参数时就可以使用对话框。或者提示一些警告的信息,都是可以使用对话框的。比如当你拷贝文件时,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

LTEXT "Copyright (C) 2007",IDC_STATIC,49,20,119,8

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

END

IDD_ABOUTBOX是对话框模板的名称。

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

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

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

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

FONT是定义对话的字体。

ICON是定义一个图标显示。

LTEXT是定义显示静态文本。

DEFPUSHBUTTON是定义一个按钮。