【Windows编程】系列第八篇：通用对话框

上一篇我们学习了菜单的基本编程，本篇来了解一下通用对话框的使用。Windows系统之所以是目前最流行的桌面系统，也是因为Windows有一套标准化，统一友好的交互界面，比如菜单、工具栏、状态栏以及各个控件。当然除了这些单独的控件之外，对于像文件打开、保存对话框，字体对话，颜色对话框等对于Windows本身会用到，在很多第三方的应用程序中也会用到。因此微软公司也早就清楚这种现实情况会存在，所以Windows把这种常见的公共对话就做了统一的接口函数，供Windows自己和第三方开发者使用。

Windows提供的公用对话框在不同的版本有所不一样，但常见的公用对话框有：颜色选择对话框、打开文件对话框、保存文件对话框、字体选择对话框、查找对话框、替换对话框、打印对话框以及打印设置对话框等。

本篇以最常见的文件打开/保存对话框、字体对话框、颜色对话框为例，来学习如何创建这些对话框，其他的对话框使用大同小异，且在MSDN上基本都有使用实例。

要使用公用对话框函数，需要包含commdlg.h头文件，相关的数据结构和函数定义都在该头文件中定义。

• 文件打开对话框

文件打开对话框主要用于选择需要的文件，把选择的文件全路径名传给用户，至于取到文件全路径之后怎么操作完全是开发者自己决定。也就是说它提供了一个在电脑中选择任何文件的公共操作接口。API函数定义如下：

BOOL GetOpenFileName(LPOPENFILENAME lpofn);

参数lpofn的定义如下：

typedef struct tagOFN {
  DWORD         lStructSize;
  HWND          hwndOwner;
  HINSTANCE     hInstance;
  LPCTSTR       lpstrFilter;
  LPTSTR        lpstrCustomFilter;
  DWORD         nMaxCustFilter;
  DWORD         nFilterIndex;
  LPTSTR        lpstrFile;
  DWORD         nMaxFile;
  LPTSTR        lpstrFileTitle;
  DWORD         nMaxFileTitle;
  LPCTSTR       lpstrInitialDir;
  LPCTSTR       lpstrTitle;
  DWORD         Flags;
  WORD          nFileOffset;
  WORD          nFileExtension;
  LPCTSTR       lpstrDefExt;
  LPARAM        lCustData;
  LPOFNHOOKPROC lpfnHook;
  LPCTSTR       lpTemplateName;
#if (_WIN32_WINNT >= 0x0500)
  void *        pvReserved;
  DWORD         dwReserved;
  DWORD         FlagsEx;
#endif // (_WIN32_WINNT >= 0x0500)
} OPENFILENAME, *LPOPENFILENAME;

该接口定义的各个参数成员请参考MSDN的详细解释，这里我们最常用到的几项如下：

lpstrFilter：该参数用于设置打开或保存对话的文件格式过滤，比如下图中的文件过滤情景，相信所有的读者朋友都见过：

lpstrFile：该参数用于保存选择结束后的选择文件。

nMaxFile：该参数指出上面用于保存结果文件的buffer字符长度。

Flags：该参数最常见用于设置是否可以多选，其他请查看MSDN。

• 文件保存对话框

文件保存对话框跟文件打开对话几乎完全一样，参数相同。功能也是为用户保存文件时选择或新建文件名、保存路径进行选择的公共操作接口。API函数定义如下：

BOOL GetSaveFileName(LPOPENFILENAME lpofn);

该函数的参数与上面完全一样，只是有些不能在文件保存对话框函数中使用，保存文件时不能多选名字。

• 颜色选择对话框

该对话框函数提供统一接口用于选择颜色，API函数定义如下：

BOOL ChooseColor(LPCHOOSECOLOR lpcc);

参数lpcc最重要的参数：

lpCustColors，它指向一个包含16个值的数组，该数组包含了对话框中自定义颜色的红、绿、蓝（RGB）值。如果用户修改这些颜色，系统将用新的颜色值更新这个数组。如果要在多个ChooseColor函数中保存这个新的数组，我们应该为该数组分配静态内存空间。

rgbResult：该参数保存了选择的颜色值。

• 字体选择对话框：

该对话框函数用于浏览并选择字体，包括颜色。API函数定义如下：

BOOL ChooseFont(LPCHOOSEFONT lpcf);

对话框函数运行结束后的字体在rgbColors参数中，我们可以用它来创建选择的字体。

以上各个结构的其他成员请参考MSDN。

下面我们以一个demo程序演示以上几种公共对话框的基本用法。

#include <windows.h>
#include <tchar.h>

#pragma comment(linker,"\"/manifestdependency:type='win32' "\
			"name='Microsoft.Windows.Common-Controls' "\
			"version='6.0.0.0' processorArchitecture='*' "\
			"publicKeyToken='6595b64144ccf1df' language='*'\"")

#define IDC_FILE_DIALOG  1001
#define IDC_COLOR_DIALOG 1002
#define IDC_FONT_DIALOG  1003

static TCHAR szAppName[] = TEXT("CommonDialog");
static LRESULT CALLBACK WndProc (HWND, UINT, WPARAM, LPARAM);

int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, PSTR szCmdLine, int iCmdShow)
{
     HWND     hWnd;
     MSG      msg;
     WNDCLASS wndclass;

     wndclass.style         = CS_HREDRAW | CS_VREDRAW;
     wndclass.lpfnWndProc   = WndProc;
     wndclass.cbClsExtra    = 0;
     wndclass.cbWndExtra    = 0;
     wndclass.hInstance     = hInstance;
     wndclass.hIcon         = LoadIcon(NULL, IDI_APPLICATION);
     wndclass.hCursor       = LoadCursor(NULL, IDC_ARROW);
     wndclass.hbrBackground = (HBRUSH) GetStockObject(WHITE_BRUSH);
     wndclass.lpszMenuName  = NULL;
     wndclass.lpszClassName = szAppName;

     if (!RegisterClass(&wndclass))
     {
          MessageBox (NULL, TEXT("This program requires Windows NT!"), szAppName, MB_ICONERROR);
          return 0;
     }

     hWnd = CreateWindow(szAppName,             // window class name
                          szAppName,            // window caption
                          WS_OVERLAPPEDWINDOW,  // window style
                          CW_USEDEFAULT,        // initial x position
                          CW_USEDEFAULT,        // initial y position
                          400,              // initial x size
                          300,              // initial y size
                          NULL,             // parent window handle
                          NULL,             // window menu handle
                          hInstance,        // program instance handle
                          NULL);            // creation parameters

     ShowWindow(hWnd, iCmdShow);
     UpdateWindow(hWnd);

     while (GetMessage(&msg, NULL, 0, 0))
     {
          TranslateMessage(&msg);
          DispatchMessage(&msg);
     }

     return msg.wParam;
}

static LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
{
	HDC hDC;

	switch (message)
	{
	case WM_CREATE:
		CreateWindow(TEXT("BUTTON"), TEXT("file dialog"), WS_CHILD|WS_VISIBLE, 20, 40, 160, 40, hWnd, (HMENU)IDC_FILE_DIALOG, NULL, NULL);
		CreateWindow(TEXT("BUTTON"), TEXT("color dialog"),WS_CHILD|WS_VISIBLE, 20, 100, 160, 40, hWnd, (HMENU)IDC_COLOR_DIALOG, NULL, NULL);
		CreateWindow(TEXT("BUTTON"), TEXT("font dialog"), WS_CHILD|WS_VISIBLE, 20, 160, 160, 40, hWnd, (HMENU)IDC_FONT_DIALOG, NULL, NULL);
		return 0;

	case WM_COMMAND:
		{
			int wmId = LOWORD(wParam);
			switch (wmId)
			{
			case IDC_FILE_DIALOG:
				{
					OPENFILENAME ofn;
					TCHAR ext[] = TEXT(".dat");
					TCHAR szFile[MAX_PATH] = TEXT("default");
					TCHAR szFilter[] = TEXT("文本文件 (*.txt)\0*.txt\0")
						           TEXT("数据文件 (*.dat)\0*.dat\0")
							   TEXT("All Files (*.*)\0*.*\0\0");

					ZeroMemory(&ofn, sizeof(ofn));
					ofn.lStructSize  = sizeof(ofn);
					ofn.hwndOwner	 = hWnd;
					ofn.lpstrFilter  = szFilter;
					ofn.nFilterIndex = 1;		  // 1 to default show *.txt type file; 2 to default show *.dat type file.
					ofn.lpstrFile	 = szFile;
					ofn.nMaxFile	 = MAX_PATH;
					ofn.lpstrDefExt  = ext;
					ofn.Flags	 = OFN_PATHMUSTEXIST|OFN_OVERWRITEPROMPT;
					if (GetOpenFileName(&ofn))//GetOpenFileName, GetSaveFileName
					{
                                                //将选择的文件输出到窗口
						LPTSTR file = ofn.lpstrFile; //file就是保存或者打开的文件名
						hDC = GetDC(hWnd);
						TextOut(hDC, 200, 50, ofn.lpstrFile, _tcslen(ofn.lpstrFile));
						ReleaseDC(hWnd, hDC);
					}
				}
				break;

			case IDC_COLOR_DIALOG:
				{
					CHOOSECOLOR cc;
					static COLORREF acrCustClr[16];

					ZeroMemory(&cc, sizeof(cc));
					cc.lStructSize  = sizeof(cc);
					cc.hwndOwner	= hWnd;
					cc.lpCustColors = (LPDWORD)acrCustClr;
					if (ChooseColor(&cc))
					{
                                                //用选择的颜色画一个实心矩形
						RECT rect = {240, 100, 340, 140};
						hDC = GetDC(hWnd);
						HBRUSH hBrush = CreateSolidBrush(cc.rgbResult);
						SelectObject(hDC, hBrush);
						FillRect(hDC, &rect, hBrush);
						DeleteObject(hBrush);
						ReleaseDC(hWnd, hDC);
					}
				}
				break;

			case IDC_FONT_DIALOG:
				{
					CHOOSEFONT cf;
					LOGFONT lf;
					ZeroMemory(&cf, sizeof(cf));
					cf.lStructSize = sizeof(cf);
					cf.hwndOwner   = hWnd;
					cf.lpLogFont   = &lf;
					cf.Flags       = CF_SCREENFONTS | CF_EFFECTS;
					if (ChooseFont(&cf))
					{
                                                //用选择的字体输出一行测试文本
						TCHAR str[] = TEXT("Font 测试！");
						HFONT hFont = CreateFontIndirect(cf.lpLogFont);
						DWORD rgbCurrent = cf.rgbColors;
						hDC = GetDC(hWnd);
						SelectObject(hDC, hFont);
						SetTextColor(hDC, cf.rgbColors);
						TextOut(hDC, 200, 170, str, _tcslen(str));
						DeleteObject(hFont);
						ReleaseDC(hWnd, hDC);
					}
				}
				break;

			default:
				break;
			}
		}
		return 0;

	case WM_DESTROY:
		PostQuitMessage(0);
		return 0 ;
	}

	return DefWindowProc (hWnd, message, wParam, lParam);
}

以上demo运行后的文件选择对话框如下：

选择颜色对话框如下：

选择字体对话框如下：

在demo中选择三个对话框后，选择的文件、颜色和字体均画在窗口上：

以上只是演示了文件打开/保存、颜色选择和字体选择对话框，虽然只演示了最简单的功能，但也是最基本、最常用的功能，能满足不少应用需求，更多的函数及用法请参考MSDN，学会查MSDN是Windows平台上开发的必备基础。

更多经验交流可以加入Windows编程讨论QQ群：454398517。

关注微信公众平台:程序员互动联盟(coder_online)，你可以第一时间获取原创技术文章，和（java/C/C++/Android/Windows/Linux）技术大牛做朋友，在线交流编程经验，获取编程基础知识，解决编程问题。程序员互动联盟，开发人员自己的家。

转载请注明出处http://www.coderonline.net/，谢谢合作！