通用对话框-功能简介
颜色对话框 | 显示可用颜色,并选择性地允许用户创建自定义颜色。用户可以选择基本或自定义颜色。 |
查找对话框 | 显示查找字符串的对话框,用户还可以指定搜索选项,例如搜索方向以及搜索是否区分大小写。 |
字体对话框 | 显示一个对话框,用户可在其中选择字体系列和关联的字体样式、磅号和其他字体属性,如字体颜色、下划线或删除线。 |
打开对话框 | 显示一个对话框,用户可在其中键入或选择要打开的文件或 shell 名称空间对象的名称。 |
页面设置框 | 显示当前页配置。 用户可以选择页面配置选项,例如纸张方向、大小、源和页边距。 |
打印对话框 | 显示有关已安装打印机及其配置的信息。可以选择打印作业选项,例如要打印的页面范围和份数,然后开始打印过程。 |
替换对话框 | 显示查找和替换字符串的对话框,用户可以指定搜索选项(例如搜索是否区分大小写)和替换选项(例如替换范围)。 |
保存对话框 | 显示一个对话框,用户可在其中键入或选择要保存文件或 shell 名称空间对象的名称。 |
中文名称 | 英文名称 | 示例 | 作用 |
颜色选框 | ChooseColorA | 颜色选框(颜色框类) | 创建一个“常用颜色”对话框,使用户可以选择颜色 |
字体选框 | ChooseFontA | 字体选框(字体框类) | 创建一个字体公共对话框,使对话框能够为用户选择逻辑字体的属性。 |
对话错误 | CommDlgExtendedError | 错误=对话错误 | 返回在执行对话框函数时最后出现的错误代码 |
搜索选框 | FindTextA | 搜索选框(查找替换类) | 创建一个系统定义的无模式对话框,允许用户指定要搜索的字符串以及在文档中搜索文本时使用的选项 |
文件选框 | GetOpenFileNameA | 文件选框(文件框类) | 创建一个文件框,允许用户指定要打开的文件或文件集的驱动器,目录和名称。 |
保存选框 | GetSaveFileNameA | 保存选框(文件框类) | 创建一个文件框,允许用户指定要保存的文件的驱动器,目录和名称。 |
页面设置 | PageSetupDlgA | 页面设置(页面框类) | 创建一个页面设置对话框,允许用户可以编辑设置打印页面的属性。 |
打印选项 | PrintDlgA | 打印选项(打印框类) | 创建显示“打印”对话框或“打印设置”对话框。使用户能够指定特定打印作业的属性。 |
打印选框 | PrintDlgExA | 打印选框(打印框类) | 创建显示“打印”对话框或“打印设置”对话框。使用户能够指定特定打印作业的属性。 |
替换选框 | ReplaceTextA | 替换选框(查找替换类) | 创建一个系统定义的无模式对话框,允许用户指定要搜索的字符串以及在文档中搜索文本时使用的选项 |
通用对话框——通知消息 | |||
---|---|---|---|
中文名字 | 常量 | 英文名称 | 释义 |
对话完成排列 | -601 | CDN_INITDONE | 系统已完成在打开另存为通用对话框中排列控件 |
对话选择改变 | -602 | CDN_SELCHANGE | 用户在对话框文件列表里选择了一个新文件或文件夹 |
对话新文件夹 | -603 | CDN_FOLDERCHANGE | 向钩子函数发送一个新文件夹被打开的消息 |
对话共享冲突 | -604 | CDN_SHAREVIOLATION | 用户选择的文件名发生网络共享冲突 |
对话点击帮助 | -605 | CDN_HELP | 通用对话框中的帮助按钮被按下 |
对话点击确定 | -606 | CDN_FILEOK | 向钩子函数发送确定按钮被按下的消息 |
对话类型改变 | -607 | CDN_TYPECHANGE | 从文件类型列表中选择一个新文件类型 |
对话包含项目 | -608 | CDN_INCLUDEITEM | 对话框会针对文件夹中的每一项发送包含项通知。 |
对话颜色返回 | "commdlg_ColorOK" | COLOROKSTRING | 用户选择颜色并单击“确定”按钮时,“颜色”对话框会将注册的消息发送到挂钩过程 。③参数:0;④数据:颜色框类 |
对话文件返回 | "commdlg_FileNameOK" | FILEOKSTRING | 当用户指定文件名并单击“确定”按钮时,对话框会将注册的消息发送到挂钩过程 。③参数:0;④数据:文件框类 |
对话查找返回 | "commdlg_FindReplace" | FINDMSGSTRING | 当用户点击查找替换对话框按钮时,对话框会将注册的消息发送到挂钩过程 。③参数:0;④数据:查找替换类 |
对话文件返回 | "commdlg_help" | HELPMSGSTRING | 当用户点击“帮助”按钮时,对话框会将注册的消息发送到挂钩过程 。③参数:对话框;④数据:对话结构 |
对话选项返回 | "commdlg_LBSelChangedNotify" | FINDMSGSTRING | 当对话框的任何列表框或组合框中的选择发生更改时,对话框会将注册的消息发送到挂钩过程 。 ③参数:标识;④数据:项号/高位:0单选项,1非多选框选项,2多选框选项,-1多选框无项目 |
对话共享冲突 | "commdlg_ShareViolation" | SHAREVISTRING | 如果用户单击“确定”按钮时所选文件发生共享冲突,对话框会将注册的消息发送到挂钩过程 。③参数:0;④数据:文件框类 |
页面绘图回调消息——常数表 | |||
对话绘制页面 | 0x400 | WM_PSD_PAGESETUPDLG | 对话框将绘制示例页面的内容。③参数:纸张大小/方向;④数据:页面框类 |
对话页面坐标 | 0x401 | WM_PSD_FULLPAGERECT | 页面矩形在对话框中的坐标。③参数:设备;④数据:矩形 |
对话边距坐标 | 0x402 | WM_PSD_MINMARGINRECT | 边距矩形在对话框中的坐标。③参数:设备;④数据:矩形 |
对话边距矩形 | 0x403 | WM_PSD_MARGINRECT | 对话框将绘制示例页的边距矩形。③参数:设备;④数据:矩形 |
对话绘希腊文 | 0x404 | WM_PSD_GREEKTEXTRECT | 边距矩形在对话框中的坐标。③参数:设备;④数据:矩形 |
对话绘制信封 | 0x405 | WM_PSD_ENVSTAMPRECT | 对话框将绘制示例页的信封戳矩形。③参数:设备;④数据:矩形 |
对话绘制地址 | 0x406 | WM_PSD_YAFULLPAGERECT | 对话框将绘制信封示例页的寄信人地址部分。③参数:设备;④数据:矩形 |
发送消息——文件对话框常数表 | |||
对话文件名称 | 0x464 | CDM_GETSPEC | 资源管理器样式的文件对话框中检索文件名。③参数:大小;④数据:缓冲区 |
对话文件路径 | 0x465 | CDM_GETFILEPATH | 在资源管理器样式的文件对话框中检索所选文件的路径和文件名。③参数:大小;④数据:缓冲区 |
对话目录路径 | 0x466 | CDM_GETFOLDERPATH | 检索资源管理器样式的文件对话框当前已打开的文件夹或目录的路径。③参数:大小;④数据:缓冲区 |
对话目录列表 | 0x467 | CDM_GETFOLDERIDLIST | 检索资源管理器样式的文件对话框当前已打开的文件夹对应的项目标识符列表的地址。③参数:大小;④数据:缓冲区 |
对话控件文本 | 0x468 | CDM_SETCONTROLTEXT | 在资源管理器样式的文件对话框中设置指定控件的文本。③参数:标识;④数据:新内容 |
对话隐藏控件 | 0x469 | CDM_HIDECONTROL | 隐藏资源管理器样式的文件对话框中的指定控件。③参数:标识;④数据:0 |
对话改扩展名 | 0x46A | CDM_SETDEFEXT | 设置“资源管理器”样式的文件对话框的默认文件扩展名不含点(.) 。③参数:0;④数据:扩展名 |
发送消息——字体对话框常数表 | |||
对话获取字体 | 0x401 | WM_CHOOSEFONT_GETLOGFONT | 检索有关用户当前字体选择的信息。③参数:0;④数据:逻辑字体类 |
对话设置字体 | 0x465 | WM_CHOOSEFONT_SETLOGFONT | 设置当前逻辑字体信息。③参数:0;④数据:逻辑字体类 |
对话字体选项 | 0x466 | WM_CHOOSEFONT_SETFLAGS | 设置对话框的显示选项。③参数:0;④数据:字体框类 |
对话修改颜色 | "commdlg_SetRGBColor" | SETRGBSTRING | 挂钩过程将注册的消息发送到对话框,以设置当前颜色选择。③参数:0;④数据:颜色 |
通用对话框-回调函数
中文名称 | 英文名称 | 示例 | 作用 |
颜色回调 | Lpcchookproc | 颜色回调(窗口,消息,参数,数据) | 接收用于 “颜色 ”对话框的默认对话框过程的消息或通知。 |
字体回调 | Lpcfhookproc | 字体回调(窗口,消息,参数,数据) | 接收用于 “字体 ”对话框的默认对话框过程的消息或通知。 |
查找回调 | Lpfrhookproc | 查找回调(窗口,消息,参数,数据) | 接收用于 “查找 ”或“ 替换 ”对话框的默认对话框过程的消息或通知。 |
打开另存 | Lpofnhookproc | 打开另存(窗口,消息,参数,数据) | 接收用于 “打开 ”和“ 另存为 ”对话框的默认对话框过程的消息或通知。 |
英文名称 | 数值 | 作用解释 |
CDERR_DIALOGFAILURE | 0xFFFF | 无法创建对话框。 |
CDERR_FINDRESFAILURE | 0x0006 | 通用对话框函数未能找到指定的资源。 |
CDERR_INITIALIZATION | 0x0002 | 常见对话框函数在初始化期间失败。当内存不足时,通常会发生此错误。 |
CDERR_LOADRESFAILURE | 0x0007 | 通用对话框函数未能加载指定的资源。 |
CDERR_LOADSTRFAILURE | 0x0005 | 通用对话框函数未能加载指定的字符串。 |
CDERR_LOCKRESFAILURE | 0x0008 | 通用对话框函数未能锁定指定的资源。 |
CDERR_MEMALLOCFAILURE | 0x0009 | 通用对话框函数无法为内部结构分配内存。 |
CDERR_MEMLOCKFAILURE | 0x000A | 通用对话框函数无法锁定与句柄关联的内存。 |
CDERR_NOHINSTANCE | 0x0004 | 但未能提供相应的实例句柄。 |
CDERR_NOHOOK | 0x000B | 但未能提供指向相应挂钩过程的指针。 |
CDERR_NOTEMPLATE | 0x0003 | 但未能提供相应的模板。 |
CDERR_REGISTERMSGFAIL | 0x000C | 对话错误函数在由通用对话框函数调用时返回错误代码。 |
CDERR_STRUCTSIZE | 0x0001 | 相应公共对话框的初始化结构的大小无效。 |
打印选项函数返回以下错误代码。 | ||
---|---|---|
PDERR_CREATEICFAILURE | 0x100A | PrintDlg 函数在尝试创建信息上下文时失败。 |
PDERR_DEFAULTDIFFERENT | 0x100C | 其他结构成员描述的打印机与当前默认打印机不匹配。 |
PDERR_DNDMMISMATCH | 0x1009 | DEVMODE和DEVNAMES结构中的数据描述了两个不同的打印机。 |
PDERR_GETDEVMODEFAIL | 0x1005 | 打印机驱动程序无法初始化DEVMODE 结构。 |
PDERR_INITFAILURE | 0x1006 | 打印选项 函数在初始化期间失败,没有更具体的扩展错误代码来描述失败。 这是函数的通用默认错误代码。 |
PDERR_LOADDRVFAILURE | 0x1004 | 打印选项 函数无法加载指定打印机的设备驱动程序。 |
PDERR_NODEFAULTPRN | 0x1008 | 默认打印机不存在。 |
PDERR_NODEVICES | 0x1007 | 找不到打印机驱动程序。 |
PDERR_PARSEFAILURE | 0x1002 | 打印选项 函数无法分析WIN.INI文件的 [devices] 节中的字符串。 |
PDERR_PRINTERNOTFOUND | 0x100B | WIN.INI文件的 [devices] 部分不包含所请求打印机的条目。 |
PDERR_RETDEFFAILURE | 0x1003 | 打印框类 结构指定了PD_RETURNDEFAULT标志,但 环境 或 名称 成员不是0。 |
PDERR_SETUPFAILURE | 0x1001 | 打印选项 函数无法加载所需的资源。 |
字体选框函数返回以下错误代码。 | ||
CFERR_MAXLESSTHANMIN | 0x2002 | 字体框类 结构的最小尺寸小于最大尺寸。 |
CFERR_NOFONTS | 0x2001 | 不存在字体。 |
文件/保存选框函数返回以下错误代码。 | ||
FNERR_BUFFERTOOSMALL | 0x3003 | 文件框类 结构的 路径 成员指向的缓冲区太小。 |
FNERR_INVALIDFILENAME | 0x3002 | 文件名无效。 |
FNERR_SUBCLASSFAILURE | 0x3001 | 尝试将列表框子类化失败,因为没有足够的内存可用。 |
查找/替换选框函数返回以下错误代码。 | ||
FRERR_BUFFERLENGTHZERO | 0x4001 | 查找替换类 结构的成员指向无效的缓冲区。 |