第16章-通用对话框

第16章通用对话框

前面介绍了Windows窗体应用程序常见的一些操作，如自定义菜单、创建工具栏、SDI和MDI应用程序及常见控件的使用。本章将介绍Windows窗体中另一类常用的对话框。在Windows系统中，应用程序如果需要用户选择一个文件或者文件夹，通常会弹出一个对话框用于与用户交互和检索信息。简言之，对话框就是将其FormBorderStyle 枚举属性设置为FixedDialog的窗体。您可以使用Windows窗体设计器构造自己的自定义对话框。可以通过添加控件（例如Label、Textbox和Button）来自定义对话框以满足特定需要。.NET Framework提供了对话框控件来快速创建对话框。常用的控件有“打开文件”对话框和消息框等，也可修改它以适合自己的应用程序。

关键技术点学习表

16.1 消息框

当用户想知道程序运行过程中的相关信息时，可以使用消息框MessageBox来获取信息。MessageBox是一个预定义对话框，在C#中使用时，都是用MessageBox对象的Show方法显示的。

MessageBox对象是命名空间Systeml.Windows.Forms的一部分，Show是一个静态方法，不需要基于MessageBox类的对象创建事例，就可以使用方法，另外，Show方法是可以重载的，具有很多不同参数的形式。

1．其语法格式一般形式如下：

【格式】

DialogResult Dir = MessageBox.Show(text,caption,button,icon,defaultbutton,option);

【功能】弹出一个消息框，显示相关信息。

【说明】

（1）Text：设置消息对话框中的提示文本语句，必须是string类；

（2）Caption：可选参数，设置消息对话框的标题，和Text一样，必须是String类；

（3）Button：可选参数，设置消息对话框中显示哪些按钮。

（4）Icon：可选参数，设置消息对话框中显示哪个图；

（5）Defaultbutton：可选参数，设置消息对话框哪个按钮是默认激活；

（6）Option：可选参数，为消息对话框设置一些特殊的选项，如文本对齐方式，指定阅读顺序，是否向系统日志写信息。

【使用说明】

（1）MessageBox的参数必须按以上顺序输入。

（2）如果使用MessageBox.Show显示消息对话框，不返回任何值，语法为：

MessageBox.Show(text,caption,buttons,icon);

2．Button各枚举常量及意义如表16-1所示。

表16-1 Buttons各枚举常量及意

3．

表16-2 Buttons各枚举常量及意

16.1.1 MessageBox显示信息

【例16-1】MessageBox显示信息示例。

程序代码如下：

using System;

using System.Collections.Generic;

using ponentModel;

using System.Data;

using System.Drawing;

using System.Text;

using System.Windows.Forms;

namespace KeyEvent

{

public partial class Form1 : Form

{

public Form1()

{

InitializeComponent();

}

private void Form1_Load(object sender, EventArgs e)

{

label1.Text = "";

label2.Text = "";

}

private void Form1_MouseDown(object sender, MouseEventArgs e) {

Label1.Text = e.Button.ToString() + "键被按下了";

MessageBox.Show(e.Button.ToString() + "键被按下了", "MessageBox示例", MessageBoxButtons.OKCancel, MessageBoxIcon.Asterisk);

}

private void Form1_MouseUp(object sender, MouseEventArgs e)

{

Label2.Text = e.Button.ToString() + "键被放开了";

}

}

}

【程序说明】

（1）在窗体上按下对应的鼠标键时，同时在标签和MessageBox上显示相关提示说明。

（2）设置了消息框的标题，并采用了button和icon选项设置了消息框外观。

（3）程序的运行结果如图16-1所示。

图16-1 运行效果图

16.1.2 MessageBox接受用户输入

消息框MessageBox还可以接受输入。MessageBox类的Show方法可根据用户选择的不同按钮，返回相应的按钮值，用于确定用户所做选择的值。

可以用整数的形式存储此值；也可使用if语句，比较显示消息框时返回的值。在这种情况下，可以设置Show方法的button参数和icon，以便显示适当的按钮向用户询问信息。

以一个具体的例子来说明这个问题。程序代码如下：

using System;

using System.Collections.Generic;

using ponentModel;

using System.Data;

using System.Drawing;

using System.Text;

using System.Windows.Forms;

namespace KeyEvent

{

public partial class Form1 : Form

{

public Form1()

{

InitializeComponent();

}

private void Form1_Load(object sender, EventArgs e)

{

label1.Text = "";

label2.Text = "";

}

private void Form1_MouseDown(object sender, MouseEventArgs e) {

label1.Text = e.Button.ToString() + "键被按下了";

if (MessageBox.Show(e.Button.ToString() + "键被按下了", "MessageBox示例", MessageBoxButtons.OKCancel, MessageBoxIcon.Asterisk) == DialogResult.OK)

{

label2.Text = "用户所按键为OK键！";

}

}

private void Form1_MouseUp(object sender, MouseEventArgs e)

{

label2.Text = e.Button.ToString() + "键被放开了";

}

}

}

【程序说明】

（1）MessageBox消息框弹出来以后，用户在MessageBox上按下正确的按钮选项以后，标签上才会有提示信息，否则程序不执行。

（2）程序的运行结果如图16-2所示。

图16-2 运行效果图

16.2 对话框的使用

CommonDialog是对话框的基类，所以所有对话框的使用方式都是类似的。公共实例方法是ShowDialog()。该方法调用受保护的RunDialog()实例方法来显示对话框，并利用用户与对话框交互操作的信息，最终返回一个DialogResult实例。

常用对话框如下：

（1）文件对话框(FileDialog) 它又常用到两个：打开文件对话框(OpenFileDialog)，保存文件对话(SaveFileDialog)。

（2）字体对话框(FontDialog)。

（3）颜色对话框(ＣolorDialog)。

（4）浏览文件夹对话框(FolderBrowserDialog)。

（5）打印预览对话框(PrintPreviewDialog)。

（6）页面设置(PrintDialog)。

（7）打印对话框(PrintDialog)。

如果要使用以上对话框，可以利用相应的对话框控件向窗体添加对象。在程序运行时显示对话框，可以使用ShowDialog方法。它的一般形式为：

【格式】DialogObject.ShowDialog();

【说明】所有的这些对话框都封装了一个Windows通用对话框，使该对话框可用于.NET应用程序。PrintPreviewDialog是一个例外，因为它把自己的元素添加到Windows 窗体上，控制打印预览，所以它并不是一个真正的对话框。

不同对话框所适用的场合：

（1）OpenFileDialog可以让用户选择和浏览要打开的文件。这个对话框可以配置为只允许选择一个文件，也可以选择多个文件。

（2）SaveFileDialog使用户可以为要保存的文件指定一个文件名和路径。

（3）PrintDialog用于选择打印机，并设置打印选项。

（4）PrintPreviewDialog是让用户可以在屏幕上进行打印预览的一种方法，并有一些选项，如缩放等。

（5）FontDialog可以为用户列出所有已安装的Windows字体、字号和样式及各种字体的预览效果。以方便用户选择字体。

（6）ＣolorDialog类用于颜色的选择。

（7）FolderBrowserDialog可以让用户选择和创建目录。

16.3 文件对话框

OpenFileDialog和SaveFileDialog类派生自FileDialog抽象基类，该基类提供了对于打开和关闭文件对话框来说都相同的文件功能。

下面分别对这两个对话框进行介绍。

16.3.1 打开文件对话框(OpenFileDialog)

打开文件对话框(OpenFileDialog)是一个预先定义的对话框类，包括显示样式和方法等。它与Windows中常见的“打开文件”对话框相同。在Windows应用程序中可以将该组件用作简单的文件选择方案，快速创建用户所熟悉的应用程序。

1．OpenFileDialog控件的主要属性如表16-3所示。

表16-3 OpenFileDialog控件的主要属性

2．OpenFileDialog控件常用事件如表16-4所示。

表16-4 OpenFileDialog控件常用事件

3．OpenFileDialog的效果如图16-3所示。

图16-3 “打开文件”对话框

4．相关操作示例代码

private void button1_Click(object sender, System.EventArgs e)

{

Stream myStream;

OpenFileDialog openFileDialog1 = new OpenFileDialog();

openFileDialog1.InitialDirectory = "c:\\" ;

openFileDialog1.Filter = "txt files (*.txt)|*.txt|All files

(*.*)|*.*" ;

openFileDialog1.FilterIndex = 2 ;

openFileDialog1.RestoreDirectory = true ;

if(openFileDialog1.ShowDialog() == DialogResult.OK)

{

if((myStream = openFileDialog1.OpenFile())!= null)

{

// Insert code to read the stream here.

myStream.Close();

}

}

}

16.3.2 保存文件对话框(SaveFileDialog)

保存文件对话框（SaveFileDialog）与Windows的“保存文件”相同。控件的使用有两种情况：一是保存；二是另存为。保存很简单，就是在文件已经打开的情况下的，

再把文件写一遍，在此主要介绍另存为的情况（SaveAs）。在使用SaveFileDialog控件时，程序员必须编写文件保存逻辑。

1．SaveFileDialog控件的属性如表16-5所示。

表16-5 SaveFileDialog控件的属性

2．SaveFileDialog事件如表16-6所示。

表16-6 SaveFileDialog事件

3．SaveFileDialog的效果如图16-4所示。

图16-4 “另存为”对话框

4．相关操作示例代码

private void button2_Click(object sender, EventArgs e)

{

SaveFileDialog saveFileDialog = new SaveFileDialog();

saveFileDialog.Filter = "文本文件|*.*|C#文件|*.cs|所有文件|*.*";

saveFileDialog.FilterIndex = 2;

saveFileDialog.RestoreDirectory = true;

if (saveFileDialog.ShowDialog() == DialogResult.OK)

{

if (saveFileDialog.ShowDialog() == DialogResult.OK)

{

string fName = saveFileDialog.FileName;

}

}

}

16.4 打印

对于打印，需要考虑打印机的选择、页面设置和如何打印多页面等。System.Drawing 命名空间中的类可以帮助完成这些任务，方便地在应用程序中打印文档。Windows窗体PrintDialog控件是预先配置的对话框，用于在Windows应用程序中选择打印机、选择要打印的页以及确定其他与打印相关的设置。可使用户能够打印文档的很多部分：全部打

印、打印选定的页范围或打印选定内容。可在Windows应用程序中使用它作为简单的解决方案，而不用配置自己的对话框。该控件包含打印、放大、显示一页或多页和关闭此对话框的按钮。

利用标准的Windows对话框，可以创建应用程序。PrintDialog从CommonDialog类继承，是标准Windows打印对话框。

1．PrintDialog的常用属性如表16-7所示。

表16-7 FontDialog的常用属性

属性作用

AllowPrintToFile 是否启用“打印到文件”复选框

AllowSelection 是否启用了页码范围选项按钮

AllowSomePages 是否启用“页”选项按钮

Document 用于获取PrinterSettings 的PrintDocument

PrinterSettings 修改的打印机设置

PrintToFile 是否选中“打印到文件”复选框

ShowHelp 是否显示“帮助”按钮

ShowNetwork 是否显示“网络”按钮

2．PrintDialog事件如表16-8所示。

Print Dialog事件

Print Dialog事件作用

HelpRequest当用户单击通用对话框中的“帮助”按钮时发生3．PrintDialog的效果如图16-5所示。

图16-5 “打印”对话框

4．程序代码如下：

using System;

using System.Collections.Generic;

using ponentModel;

using System.Data;

using System.Drawing;

using System.Text;

using System.Windows.Forms;

namespace WindowsPrint

{

public partial class Form1 : Form

{

public Form1()

{

InitializeComponent();

this.printDialog1.Document = this.printDocument1;

}

private void 打印_Click(object sender, EventArgs e)

{

if (this.printDialog1.ShowDialog() == DialogResult.OK)

this.printDocument1.Print();

}

}

}

【程序说明】

（1）窗体上添加了一个将命令按钮，将其Name和Text属性都设置为“打印”。此按钮发生Click事件时显示打印对话框。添加了一个将打印文档类PrintDocumet。

（2）在.net环境中，要实现打印，就必定要用到PrintDocumet这个类，PrintDocument 属于System.Drawing.Printing这个名字空间，PrintDocument这个类是实现打印的核心代码。如果要实现打印，还必需首先构造PrintDocument对象添加打印事件，printDocument.PrintPage+=new PrintPageEventHandler (this.printDocument_PrintPage) （3）本例虽然能显示打印对话框，但是因为没有添加printDocument的PrintPage事件，所以还不能实现打印。

5．实现打印的PrintDocument打印事件

打印其实也是调用Graphics类的方法进行画图,下面这段代码给出了一个打印实现的PrintPage事件源码。相关操作代码如下所示：

private void printDocument1_PrintPage(object sender,

System.Drawing.Printing.PrintPageEventArgs e)

{

//当前的打印字体

Font font = new Font("Tahoma", 12, FontStyle.Underline);

//设置刷子

Brush bru = Brushes.Blue;

Pen pen = new Pen(bru);

pen.Width = 5;

//设置各边距

int nLeft = this.pageSetupDialog1.PageSettings.Margins.Left;

int nTop = this.pageSetupDialog1.PageSettings.Margins.Top;

int nRight =

this.pageSetupDialog1.PageSettings.Margins.Right;

int nBottom =

this.pageSetupDialog1.PageSettings.Margins.Bottom;

int nWidth =

this.pageSetupDialog1.PageSettings.PaperSize.Width - nRight - nLeft;

int nHeight =

this.pageSetupDialog1.PageSettings.PaperSize.Height - nTop - nBottom;

//打印各边距

e.Graphics.DrawLine(pen, nLeft, nTop, nLeft, nTop + nHeight);

e.Graphics.DrawLine(pen, nLeft + nWidth, nTop, nLeft + nWidth, nTop + nHeight);

e.Graphics.DrawLine(pen, nLeft, nTop, nLeft + nWidth, nTop);

e.Graphics.DrawLine(pen, nLeft, nTop + nHeight, nLeft + nWidth, nTop + nHeight);

//在离左边距,上边距的位置打印《c#习题集锦》

e.Graphics.DrawString("《c#习题集锦》", font, bru, nLeft + 20, nTop + 20);

}

【程序说明】

（1）窗体上添加了一个PageSetupDialog，主要用来设置页面大小，页边距等。

（2）PrintDocument可用于设置属性来描述有关打印的信息，并且可用于调用方法Print()或通过事件PrintPage来打印文档的组件。本例中使用PrintPage事件来实现页面设置和设置打印内容。PrintPage事件是实现打印的核心部分，必不可少。

16.5 打印预览

使用打印预览可以查看打印结果。Windows窗体中的PrintPreviewDialog控件是.NET 预先配置好的对话框，用于显示PrintDocument打印时的外观。可在Windows应用程序中使用它作为简单的解决方案，而不用配置自己的对话框。控件允许显示预先定义的对

话框，用户可以使用该对话框查看文档在打印时的样式，控件包含打印、放大、显示一页或多页和关闭此对话框的按钮。

该控件的主要属性是Document，用于设置要预览的文档。文档必须是PrintDocument 对象。若要显示此对话框，必须调用它的ShowDialog方法。

1．PrintPreviewDialog主要性如表16-9所示。

表16-9 PrintPreviewDialog常用事件

2．PrintPreviewDialog常用事件如表16-10所示。

表16-10 PrintPreviewDialog常用事件

3．PrintPreviewDialog的运行效果如图16-6所示。

图16-6 “打印预览”对话框

4．程序代码如下：

using System;

using System.Collections.Generic;

using ponentModel;

using System.Data;

using System.Drawing;

using System.Text;

using System.Windows.Forms;

namespace WindowsPrint

{

public partial class Form1 : Form

{

public Form1()

{

InitializeComponent();

this.printPreviewDialog1.Document = this.printDocument1; }

private void 打印预览_Click(object sender, EventArgs e)

{

this.printPreviewDialog1.ShowDialog();

}

}

}

16.6 FontDialog和ColorDialog对话框

16.6.1 字体对话框(FontDialog)

在文字处理中，我们常用到字体对话框对文字进行格式设置。Windows窗体FontDialog组件是一个预配置的对话框，该对话框是标准的Windows“字体”对话框，用于公开系统上当前安装的字体。在Windows应用程序中将其用作简单的字体选择方案，而不是配置对话框。

默认情况下，该对话框显示字体、字体样式和字体大小的列表框；删除线和下划线等效果的复选框；脚本的下拉列表以及字体外观的示例。

1．字体对话框(FontDialog)的常用属性如表16-11所示。

表16-11 FontDialog的常用属性

2．字体对话框(FontDialog)的事件如表16-12所示。

表16-12 FontDialog的常用事件

3．字体对话框(FontDialog)的效果如图16-7所示。

图16-7 “字体”对话框

4．相关操作示例代码

private void fontDialogBTN_Click(o b j e c t sender,System.EventArgs e)

{

fontDialog fontDialog=new FontDialog();

fontDialog.Color = richTextBox1.ForeColor;

fontDialog.AllowScriptChange = true;

fontDialog.ShowColor = true;

if(fontDialog.ShowDialog() != DialogResult.Cancel)

richTextBox1.SelectionFont = fontDialog.Font;//将当前选定的文字改变字体

}

16..6.2 颜色对话框(ColorDialog)

Windows窗体ColorDialog组件是一个预先配置的对话框，它允许用户从调色板选择颜色以及将自定义颜色添加到该调色板。此对话框与在其他Windows应用程序中看到的用于选择颜色的对话框相同。

1．颜色对话框(ColorDialog)的常见属性如表16-13所示。

表16-13 ColorDialog的常见属性

属性作用

AllowFullOpen 禁止和启用“自定义颜色”按钮

FullOpen 是否最先显示对话框的“自定义颜色”部份

ShowHelp 是否显示“帮助”按钮

Color 在对话框中显示的颜色

AnyColor 显示可选择任何颜色

CustomColors 是否显示自定义颜色

SolidColorOnly 是否只能选择纯色

2．颜色对话框(ColorDialog)的效果如图16-8所示。

图16-8 “颜色”对话框

3．相关操作示例代码

private void colorDialogBTN_Click(object sender,System.EventArgs e) {

ColorDialog colorDialog = new ColorDialog();

colorDialog.AllowFullOpen=true;

colorDialog.FullOpen=true;

colorDialog.ShowHelp=true;

colorDialog.Color=Color.Black;

colorDialog.ShowDialog();

richTextBox1.SelectionColor=colorDialog.Color;

16.7 浏览文件夹对话框

1．浏览文件夹对话框(FolderBrowserDialog)的常见属性如表16-14所示。

表16-14 FolderBrowserDialog的常见属性

属性作用

SelectPath 设置选择路径

Description 决定目录树上要显示的提示信息

ShowNewFolderButton 是否显示“新建文件夹”按钮

2．浏览文件夹对话框(FolderBrowserDialog)的效果如图16-9所示。

图16-9 “浏览文件夹”对话框

3．相关操作示例代码

private void button1_Click(object sender, EventArgs e)

{

folderBrowserDialog1.SelectedPath = "c:\\";

folderBrowserDialog1.ShowNewFolderButton = true;

folderBrowserDialog1.Description = "请选择目录：";

folderBrowserDialog1.ShowDialog();

Text = folderBrowserDialog1.SelectedPath;

}

16.8 小结

本章介绍了如何在应用程序中使用对话框类：如何打开和保存文件，如何给应用程序添加打印功能等。

本章使用的对话框有：

（1）文件对话框(FileDialog)。

（2）打印对话框(PrintDialog)。

（3）打印预览对话框(PrintPreviewDialog)。

（4）字体对话框(ColorDialog)和颜色对话框(FontDialog)。

（5）浏览文件夹对话框(FolderBrowserDialog)。

课外阅读─Windows窗体中的对话框

对话框用于与用户交互和检索信息，.NET Framework包括一些常用的预定义对话框。本章中列举的Windows窗体控件和组件就提供了标准的常用对话框，对于具体的应用程序来说，可以修改这些预定义的对话框以适合自己的应用程序。

简单地说，对话框就是FormBorderStyle枚举属性设置为FixedDialog的窗体。在Visual Studio中，完全可以通过使用Windows窗体设计器来构造自己的自定义对话框。即可以根据自己的具体需要，向自定义对话框中添加诸如Label、Textbox和Button之类的控件。

16.9 练习16

一、选择题

1．下列属性中，不是字体对话框(FontDialog)的属性。

A．ShowColor B．Font

C．AllowFullOpen D．FontMustExist

2．下列属性中，不是对话框都具有的属性。

A．Container B．Site C．Tag D．Color 3．设置当前文件名筛选器字符串，该字符串决定对话框的“另存为文件类型”或“文件类型”框中出现的选择内容。应该使用的属性是。

A．Filter B．FilterIndex C．Multiselect D．Title 4．要获取对话框中所有选定文件的文件名，应该使用的属性是。

A．DefaultExt B．FilterIndex C．FileNames D．Title 5．要在颜色对话框(ColorDialog)上启用“添加到自定义颜色”按钮，应该对属性进行设置。

A．AllowFullOpen B．FullOpen

C．AnyColor D．CustomColors

6．颜色对话框(ColorDialog)要显示“自定义颜色”，应该对属性进行设置。

A．AllowFullOpen B．FullOpen

C．AnyColor D．CustomColors