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 显示当前帮助文件中的
解决方案 »
免费领取超大流量手机卡,每月29元包185G流量+100分钟通话, 中国电信官方发货