CommonDialog 控件
            CommonDialog 控件提供一组标准的操作对话框,进行诸如打开和保存文件,设置打印选项,以及选择颜色和字体等操作。通过运行 Windows 帮助引擎控件还能显示帮助。语法CommonDialog说明CommonDialog 控件在 Visual Basic 和 Microsoft Windows 动态链接库 ommdlg.dll. 的例程之间提供了一个接口。为了用这个控件创建一个对话框,ommdlg.dll. 必须在 Microsoft Windows 的 SYSTEM 目录下。在应用程序中要使用 CommonDialog 控件,可将其添加到窗体中并设置其属性。控件所显示的对话框由控件的方法确定。在运行时,当相应的方法被调用时,将显示一个对话框或是执行帮助引擎;在设计时,CommonDialog 控件是以图标的形式显示在窗体中。该图标的大小不能改变。使用指定的方法,CommonDialog 控件能够显示下列对话。方法 所显示的对话框 
ShowOpen 显示“打开”对话框 
ShowSave 显示“另存为”对话框 
ShowColor 显示“颜色”对话框 
ShowFont 显示“字体”对话框 
ShowPrinter 显示“打印”或“打印选项”对话框 
ShowHelp 调用 Windows 帮助引擎 
在对话框接口上单击,CommonDialog 控件将自动提供与上下文有关的帮助: 单击标题栏中的“这是什么?”帮助按钮,然后单击想详细信息的项目。
将鼠标放在想进一步详细信息的项目上,单击右键,然后在所显示的上下文菜单中选择这是什么命令。 
操作系统提供在 Windows 95 帮助弹出中显示的文本。也可以通过设置 Flags 属性,在带有 CommonDialog 控件的对话框中显示一个帮助按钮,但是,必须在这个位置提供帮助主题。注意 无法指定对话框显示在什么地方。详细信息 要查看各对话的帮助主题,单击“请参阅”。
CommonDialog错误常数
常数 值 描述 
cdlAlloc &H&H7FF0 & 不能对 FileName 或Filter 属性分配内存 
cdlCancel &H&H7FF3 & 选择了取消 
cdlDialogFailure &H&H8000 & 函数不能加载对话框 
cdlFindResFailure &H&H7FF9 & 函数不能加载指定资源 
cdlHelp &H&H7FEF & 不能调用 Windows 帮助 
cdlInitialization &H&H7FFD & 在初始化期间函数失败 
cdlLoadResFailure &H&H7FF8 & 函数不能加载指定的字符串 
cdlLockResFailure &H&H7FF7 & 函数不能锁定指定的资源 
cdlMemAllocFailure &H&H7FF6 & 函数不能对内部数据结构分配内存 
cdlMemLockFailure &H&H7FF5 & 函数不能锁定与句柄相关联的内存 
cdlNoFonts &H&H5FFE & 不存在字体 
cdlBufferTooSmall &H&H4FFC & 缓冲区,在其内,成员 lpstrFile 点太小 
cdlInvalidFileName &H4&H4FFD & 文件名称无效 
cdlSubclassFailure &H&H4FFE & 不能将列表框分出子类,因为内存不够 
cdlCreateICFailure &H&H6FF5 & 当 PrintDlg 函数要创建信息上下文时,该函数失败 
cdlDndmMismatch &H&H6FF6 & DevMode 与 DevNames 数据结构中的数据描述两种不同的打印机 
cdlGetDevModeFail &H&H6FFA & 打印机设备驱动程序不能初始化 DevMode 数据结构 
cdlInitFailure &H&H6FF9 & 在初始化期间 PrintDlg 函数失败 
cdlLoadDrvFailure &H&H6FFB & PrintDlg 函数不能加载被指定的打印机设备驱动程序 
cdlLoadStrFailure &H7FFA 函数不能加载指定的字符串。 
cdlNoDefaultPrn &H&H6FF7 & A 缺省打印机不存在 
cdlNoDevices &H&H6FF8 & 未找到打印机设备驱动程序 
cdlParseFailure &H&H6FFD & CommonDialog 函数不能分析 Win.ini 的 [设备]一节中的字符串 
cdlPrinterCodes &H&H6FFF & 设置了 PDReturnDefault 标记,但 hDevMode 或 hDevNames 字段都非零 
cdlPrinterNotFound &H&H6FF4 & Win.ini 的 [设备]一节不包含所需打印机的登录项 
cdlRetDefFailure &H&H6FFC & 设置了 PDReturnDefault 标记,但 hDevMode 或 hDevNames 字段都非零 
cdlSetupFailure &H&H6FFE & 不能加载所需资源  
CommonDialog 控件常数
文件打开/保存对话框标记
常数 值 描述 
cdlOFNAllowMultiselect &H200  指定文件名列表框允许多种选择。 
用户在运行时 可按下 SHIFT 键选择多个文件并用 UP ARROW 与 DOWN ARROW 键选择所要。然后,FileName 属性包含所有选定文件的字符串。用空格来为字符串中的名字分界。
 
cdlOFNCreatePrompt &H2000  指定对话框提示用户创建当前不存在的文件。该标记自动设置 cdlOFNPathMustExist 与 cdlOFNFileMustExist 标记。 
cdlOFNExplorer &H80000  使用“Explorer-like Open A File”对话框模板。在 Windows 下使用 Windows 95 外壳时,使用该标记的公共对话框不工作。 
CdlOFNExtensionDifferent &H400  指出被返回的文件名的扩展名不同于 DefaultExt 属性指定的扩展名。如果 DefaultExt 属性是Null,如果扩展名匹配,或者如果文件无扩展名,则都不设置该标记。关闭了对话框后就可检查该标记值。 
cdlOFNFileMustExist &H1000  指定用户可只在文件名文本框中输入现有文件名。如果设置了该标记,而且用户输入一个无效文件名,则将出现一个警告。该标记自动设置 cdlOFNPathMustExist 标记。 
cdlOFNHelpButton &H10  使对话框显示帮助按钮。 
cdlOFNHideReadOnly &H4  隐藏只读复选框。 
cdlOFNLongNames &H200000  使用长文件名。 
cdlOFNNoChangeDir &H8  强制对话框将当前目录设置成在打开对话框时的目录。 
CdlOFNNoDereferenceLinks &H100000  不间接引用外壳链接(所谓快捷方式)。根据缺省,选择外壳链接回使外壳间接引用它。 
cdlOFNNoLongNames &H40000 不使用长文件名。 
CdlOFNNoReadOnlyReturn &H8000  指定被返回的文件将不会有只读属性设置,也不会在写保护目录中。 
cdlOFNNoValidate &H100  指定公共对话框在被返回的文件名中允许无效字符。 
cdlOFNOverwritePrompt &H2  如果被选择的文件已经存在,则使“另存为”对话框生成消息框。用户必须确认是否覆盖文件。 
cdlOFNPathMustExist &H800  指定用户可只输入有效的路径。如果设置该标记且用户输入无效路径,则出现一个警告消息。 
cdlOFNReadOnly &H1  使在创建对话框时,开始检查只读复选框。在关闭对话框时,该标记也指出只读复选框的状态。 
CdlOFNShareAware &H4000  指定将忽略共享冲突错误。 
“颜色”对话框标记
常数 值 描述 
cdlCCFullOpen &H2  显示整个对话框,包括定义自定义颜色区 
cdlCCShowHelp &H8  使对话框显示帮助按钮 
cdlCCPreventFullOpen &H4  使定义自定义颜色按钮无效,并防止用户定义自定义颜色 
cdlCCRGBInit &H1  设置对话框的初始颜色值 
“字体”对话框标记
常数 值 描述 
cdlCFANSIOnly &H400  指定对话框只允许选择使用 Windows 字符设置的字体。如果设置该标记,则用户将不能选择只包含符号的字体。 
cdlCFApply &H200  启动对话框上的应用按钮。 
cdlCFBoth &H3  使对话框列举可用的打印机与屏幕字体。hDC 属性识别与打印机相关联的设备描述体。 
cdlCFEffects &H100  指定对话框使划线、下划线与颜色生效。  
cdlCFFixedPitchOnly &H4000  指定对话框只选择固定间距的字体。 
cdlCFForceFontExist &H10000  指定如果用户要选择不存在的字体或式样,则显示错误消息框。 
cdlCFHelpButton &H4  使对话框显示帮助按钮。 
cdlCFLimitSize &H2000  指定对话框只在 Min 与 Max 属性指定的范围内选择字体大小。 
cdlCFNoFaceSel &H80000  未选择字体名称。 
cdlCFNoSimulations &H1000  指定对话框不允许图形设备接口 (GDI) 字体模拟。 
cdlCFNoSizeSel &H200000  未选择字体大小。 
cdlCFNoStyleSel &H100000   
cdlCFNoVectorFonts &H800  指定对话框不允许选择矢量字体。 
cdlCFPrinterFonts &H2  使对话框只列举 hDC 属性指定的打印机所支持的字体。 
cdlCFScalableOnly &H20000  指定对话框只允许选择可缩放的字体。 
cdlCFScreenFonts &H1  使对话框只列举系统支持的屏幕字体。 
cdlCFTTOnly &H40000  指定对话框只允许选择 TrueType 字体。 
cdlCFWYSIWYG &H8000  指定对话框只允许选择既可在打印机上又可在屏幕上使用的字体。如果设置该标记设置,则也应设置 cdlCFBoth 与 cdlCFScalableOnly 标记。 
“打印”对话框标记
常数 值 描述 
cdlPDAllPages &H0  返回或设置所有页选项按钮的状态。 
cdlPDCollate &H10  返回或设置分页复选框的状态。 
cdlPDDisablePrintToFile &H80000  使打印到复选框无效。 
cdlPDHelpButton &H800  使对话框显示帮助按钮。 
cdlPDHidePrintToFile &H100000  隐藏打印到文件复选框。 
cdlPDNoPageNums &H8  使页选项按钮与相关联的编辑控件无效。 
cdlPDNoSelection &H4  使选择选项按钮无效。 
cdlPDNoWarning &H80  防止在没有缺省打印机时显示警告消息。 
cdlPDPageNums &H2  返回或设置页选项按钮的状态。 
cdlPDPrintSetup &H40  使系统显示“打印设置”对话框而不是“打印”对话框。 
cdlPDPrintToFile &H20  返回或设置打印到文件复选框的状态。 
cdlPDReturnDC &H100  返回设备描述体 以在对话框中选择打印机。在对话框的 hDC 属性中返回设备描述体。 
cdlPDReturnDefault &H400  返回缺省打印机名称。 
cdlPDReturnIC &H200  返回信息上下文以在对话框中选择打印机。 信息上下文提供快速方法获得有关设备的信息,而不必创建设备描述体。在对话框 hDC 属性中返回信息上下文。 
cdlPDSelection &H1  返回或设置选择选项按钮的状态。如果既没有指定 cdlPDPageNums 也没有指定 cdlPDSelection,则所有选项按钮处在选择状态中。 
cdlPDUseDevModeCopies &H40000  如果打印机驱动程序不支持多个复本,则设置该标记使复本编辑控件无效。如果驱动程序支持多个复本,则设置该标记指出对话框在复本属性中存储所需数量的复本。 
Help 常数
常数 值 描述 
cdlHelpCommandHelp &H102  对具体命令显示帮助 
cdlHelpContents &H3  显示当前帮助文件中的