《C#入门到精通》学习笔记 -- CommonDialog类

P84：CommonDialog类

所属的命名空间：using System.Windows.Forms

类成员：

1．OpenFileDialog. 要让用户选择和浏览要打开的文件，应使用OpenFileDialog。这个对话框可以配置为只允许选择一个文件，或可以选择多个文件。
       2 SaveFileDialog，用户可以为要保存的文件指定一个文件名和浏览的路径。
       3．PrintDialog用户选择一个打印机，并设置打印选项。
       4．PageSetupDialog: 配置页面的边距。

5．PrintViewDialog是在屏幕上进行打印预览的一种方法，并有一些选项如缩放。

6．FontDialog列出了所有已安装的Windows字体、样式和字号，以及各字体的预览效果，以便选择字体。

7．ColorDialog用于选择颜色。

1、 OpenFileDialog控件有以下基本属性

• InitialDirectory。可以通过设置InitialDirectory属性来使打开文件对话框打开时在一个设置好的默认路径上。为了获取特定的系统文件夹，可以使用System.Environment类的静态方法GetFolderPath()。如：

  OpenFileDialog ofd = new OpenFileDialog();
  ofd.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.Templates);

  
  
• Filter要在对话框中显示的文件筛选器，例如，"文本文件(*.txt)|*.txt|所有文件(*.*)|*.*"

  ofd.Filter = "Text Document(*.txt)|*.txt|All Files|*.*|我要显示的文件类型(*.exe)|*.exe";

• FilterIndex在对话框中选择的文件筛选器的索引，如果选第一项就设为1RestoreDirectory控制对话框在关闭之前是否恢复当前目录FileName第一个在对话框中显示的文件或最后一个选取的文件Title将显示在对话框标题栏中的字符
• AddExtension是否自动添加默认扩展名CheckPathExists

在对话框返回之前，检查指定路径是否存在DefaultExt默认扩展名DereferenceLinks在从对话框返回前是否取消引用快捷方式ShowHelp
启用"帮助"按钮ValiDateNames控制对话框检查文件名中是否不含有无效的字符或序列

自定义帮助信息：

设置对象的ShowHelp属性可以出现一个帮助按钮，自定义帮助信息。

通过HelpRequest事件添加一个处理程序。

ofd.ShowHelp = true;
            ofd.HelpRequest += new EventHandler(ofd_HelpRequest);

        private void ofd_HelpRequest(object sender, EventArgs e)
        {
            MessageBox.Show("我自己定义的帮助信息：）");
        }

      OpenFileDialog控件有以下常用事件

FileOk当用户点击"打开"或"保存"按钮时要处理的事件
HelpRequest当用户点击"帮助"按钮时要处理的事件

2、SaveFileDialog 

AddExtension    是否把扩展名自动添加到用户输入的文件名 ​​上。默认为 True ，如果用户已经输入了一个文件扩展名，就不会添加其它扩展名了。

CheckFileExist    验证文件有效性，默认为 False

CheckPathExists 验证路径有效性，默认为 True

CreatePrompt   询问用记是否分创建一个新文件

OverwritePrompt  是否覆盖已有文件。

　

3、 颜色对话框(ColorDialog)的常见属性

• AllowFullOpen禁止和启用"自定义颜色"按钮
• FullOpen是否最先显示对话框的"自定义颜色"部份
• ShowHelp是否显示"帮助"按钮
• Color在对话框中显示的颜色
• AnyColor显示可选择任何颜色
• CustomColors是否显示自定义颜色
• SolidColorOnly是否只能选择纯色

 4、 字体对话框(FontDialog)常用属性

• ShowColor控制是否显示颜色选项
• AllowScriptChange是否显示字体的字符集
• Font在对话框显示的字体
• AllowVerticalFonts是否可选择垂直字体
• Color在对话框中选择的颜色
• FontMustExist当字体不存在时是否显示错误
• MaxSize可选择的最大字号 MinSize可选择的最小字号
• ScriptsOnly显示排除 OEM和Symbol字体
• ShowApply是否显示"应用"按钮
• ShowEffects是否显示下划线、删除线、字体颜色选项
• ShowHelp是否显示"帮助"按钮

 字体对话框(FontDialog)的事件

Apply当点击"应用"按钮时要处理的事件HelpRequest当点击"帮助"按钮时要处理的事件

 

5、PrintDialog PrintPreviewDialog 控件

属性说明 

• AllowCurrentPage   表明是否启用Current Page单选按钮
• AllowPrintToFile  表明是否启用Print to file复选框
• AllowSelection    表明是否启用Selection单选按钮
• AllowSomePages 表明是否启用Pages单选按钮
• Document  表明用于获取打印机设置的打印文档
• PrinterSettings 表明对话框要修改的打印机设置
• PrintToFile   表明是否启用Print to file复选框
• ShowHelp    表明是否显示Help按钮
• ShowNetwork   表明是否显示Network按钮