【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/，谢谢合作！
