comdlg32.dll

定义

comdlg32.dll是Windows系统中实现通用对话框库的动态链接库文件，文件内部描述为CommonDialogsDLL，其功能类别被归入Windows API的用户界面部分^[1][2]。该库存在的意义在于为各类应用程序提供统一的标准对话框，使不同软件的界面行为保持一致，从而减少用户重新熟悉界面的负担^[3]。

开发者调用其中的函数时需要包含commdlg.h头文件，并链接Comdlg32.lib导入库，实际运行时由Comdlg32.dll提供函数实现^[4]。同一套接口在ANSI与Unicode两种编码下分别提供A版本和W版本函数，头文件中的通用名会依编译时是否定义UNICODE宏自动指向其中之一^[4]。

原理

通用对话框库为每一类对话框配有一个创建函数和一套结构体。应用程序先填写结构体中的初始值、所有权窗口句柄和标志位，再调用对应的创建函数；函数返回后，同一结构体会带回用户的选择结果^[5]。以文件对话框为例，GetOpenFileName接收一个指向OPENFILENAME结构的指针，用户在对话框中确认后返回非零值，结构体的lpstrFile成员所指缓冲区存放完整路径与文件名；若用户取消或出错则返回零，此时可调用CommDlgExtendedError取得具体错误码^[4]。

对话框本身是系统提供的窗口。开发者若要改变对话框行为，可在标志位中打开钩子选项，并在结构体里给出钩子回调函数的地址，由系统在对话框处理消息的过程中回调该函数；也可以启用自定义对话框模板替换默认布局^[4]。Explore风格的文件对话框还支持在框架内嵌入额外控件，而旧式风格对话框则保留Windows 3.1时期的界面外观，供需要维持旧观感的程序选用^[4]。

发展历程

通用对话框库在16位Windows时期以commdlg.dll的文件名存在，并见于Windows 3.1的软件开发工具包文档中，该文档单列一章介绍颜色、字体、打开与另存为、打印与打印设置、查找与替换等各类对话框的使用方法^[6]。早期版本的该库并非随所有系统一同提供，部分开发工具会自行分发commdlg.dll，并曾出现某些本地化版本只能在Windows 3.1及以上运行、无法用于Windows 3.0的情况^[7]。

进入32位Windows后，该库对应的实现文件改称comdlg32.dll，与16位的commdlg.dll并存于不同体系之中^[8]。开源兼容实现项目ReactOS与Wine均按此结构分别维护16位与32位两个模块，Wine的提交记录显示其后又将32位与16位代码拆分，使commdlg.dll成为独立的16位组件^[9]。从Windows Vista起，系统的打开与另存为对话框改由通用项对话框(Common Item Dialog)承担，微软建议新程序改用新的API^[4]。

应用

文件类对话框是该库最常见的用途。GetOpenFileName用于让用户指定要打开的驱动器、目录以及一个或多个文件名，GetSaveFileName则对应另存为操作，两者都支持在结构体中设定筛选条件与默认扩展名^[10]。选色与选字由ChooseColor与ChooseFont两个函数完成，前者配合CHOOSECOLOR结构，后者配合CHOOSEFONT结构，可取得字体族、字号、字重、下划线、删除线与文字颜色等属性^[3]。

打印相关界面同样由该库提供：PrintDlg显示打印对话框，让用户设定页范围、份数等打印作业属性，并可返回所选打印机的设备上下文句柄；PrintDlgEx改为显示打印属性表，除常规页外还能附加应用程序与驱动程序的专用页；PageSetupDlg则负责纸张大小、来源、纵横方向与页边距等页面设置^[3][11]。自Windows Vista开始，PageSetupDlg不再包含切换打印机的按钮，改选打印机需通过PrintDlg或PrintDlgEx完成^[11]。

在语言与框架层面，该库的导出函数被多种开发工具封装调用。Visual Basic可直接在声明语句中指定comdlg32.dll并调用GetOpenFileName与GetSaveFileName。MFC提供CColorDialog、CFontDialog、CPrintDialog等类封装这些对话框，并说明其资源与代码来自Windows 3.1及以后的通用对话框库^[12]。

局限

该库的适用范围限于桌面应用的传统界面。微软文档标注其函数最低支持客户端为Windows 2000专业版的桌面程序，并明确排除Windows CE等平台^[4][13]。在编码限制上，ANSI版本的GetOpenFileName在多选文件时对文件名总长度约有32K字符的上限，Unicode版本则无此限制，混用中性别名与非中性代码可能引发编译期或运行期错误^[4]。

在功能定位上，该库自Windows Vista起已不是文件对话框的首选方案，打开与另存为对话框被通用项对话框取代，旧接口主要保留给需要维持既有界面的程序^[3]。它也不是可自行注册的COM组件：该文件不含DllRegisterServer入口点，用regsvr32注册会失败，需要该组件的是另外的comdlg32.ocx控件；此外它是系统组件，用旧版本文件覆盖可能破坏系统其他部分^[14]。