Windows Dialog对话框

一、MessageBox弹出框

MessageBox.Show（<字符串> Text, <字符串> Title, <整型> nType，MessageBoxIcon）;

第一个参数是 String 类型，表示提示框里面的内容；
第二个参数是String 类型，表示提示框的标题；
第三个参数是整数类型，表示消息框的类型，一般的都使用系统提供的几种类型；
第四个参数是提示框的图标，比如说警告、提示、问题等等。

MessageBoxButtons类型：

AbortRetryIgnore：消息框包含“中止”、“重试”和“忽略”按钮。
OK ：消息框包含“确定”按钮。（默认）
OKCancel ：消息框包含“确定”和“取消”按钮。（上例所示）
RetryCancel ：消息框包含“重试”和“取消”按钮。
YesNo ：消息框包含“是”和“否”按钮。
YesNoCancel ：消息框包含“是”、“否”和“取消”按钮

MessageBoxIcon图标样式：

MessageBoxIcon.Question
MessageBoxIcon.Asterisk
MessageBoxIcon.Information
MessageBoxIcon.Error
MessageBoxIcon.Stop
MessageBoxIcon.Hand
MessageBoxIcon.Exclamation
MessageBoxIcon.Warning

举例

MessageBox.Show("用户名或者密码不能为空");
MessageBox.Show("用户名或者密码不能为空","登录提示");
MessageBox.Show("用户名或者密码不能为空","登录提示",MessageBoxButtons.OKCancel);
MessageBox.Show("用户名或者密码不能为空","登录提示",MessageBoxButtons.OKCancel,MessageBoxIcon.Exclamation);

二、WinForm自带对话框

除PrintPreviewDialog外，所有的对话框都继承于抽象类CommonDialog。

CommonDialog的继承结构

1、文件对话框(FileDialog) 它又常用到两个：
　　打开文件对话框(OpenFileDialog)
　　保存文件对话(SaveFileDialog)
2、字体对话框(FontDialog)
3、颜色对话框(ColorDialog)
4、打印预浏对话框(PrintPreviewDialog)
5、页面设置(PrintDialog)
6、打印对话框(PrintDialog)

CommonDialog的方法

OnHelpRequest(EventArgs)：引发 HelpRequest 事件。
Reset()：在派生类中被重写时，将通用对话框的属性重置为默认值。
ShowDialog()：用默认的所有者运行通用对话框。
ShowDialog(IWin32Window) ：运行具有指定所有者的通用对话框。

1、打开文件对话框(OpenFileDialog)

基本属性

InitialDirectory 对话框的初始目录
Filter 要在对话框中显示的文件筛选器，例如，"文本文件(*.txt)|*.txt|所有文件(*.*)||*.*"
FilterIndex 在对话框中选择的文件筛选器的索引，如果选第一项就设为1
RestoreDirectory 控制对话框在关闭之前是否恢复当前目录
FileName 获取或设置一个包含在文件对话框中选定的文件名的字符串。
Title 将显示在对话框标题栏中的字符
AddExtension 是否自动添加默认扩展名
CheckPathExists 在对话框返回之前，检查指定路径是否存在
DefaultExt 默认扩展名
DereferenceLinks 在从对话框返回前是否取消引用快捷方式
ShowHelp 启用"帮助"按钮
ValiDateNames 控制对话框检查文件名中是否不含有无效的字符或序列

示例

System.Windows.Forms.OpenFileDialog dlg = new System.Windows.Forms.OpenFileDialog();
dlg.Title = "打开文件";
dlg.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.Templates);
dlg.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
dlg.FilterIndex = 2;
dlg.RestoreDirectory = true;
if (dlg.ShowDialog() == DialogResult.OK)
{
    if (dlg.FileName != "") //如果dlg.Multiselect=true;可以是dlg.FileNames
    {
        MessageBox.Show("你选择了" + dlg.FileName);
    }
}

2、保存文件对话框(SaveFileDialog)

属性

Filter 要在对话框中显示的文件筛选器，例如，"文本文件(*.txt)|*.txt|所有文件(*.*)|*.*"
FilterIndex 在对话框中选择的文件筛选器的索引，如果选第一项就设为1
RestoreDirectory 控制对话框在关闭之前是否恢复当前目录
AddExtension 是否自动添加默认扩展名
CheckFileExists 获取或设置一个值，该值指示如果用户指定不存在的文件名，对话框是否显示警告。
CheckPathExists 在对话框返回之前，检查指定路径是否存在
Container 控制在将要创建文件时，是否提示用户。只有在ValidateNames为真值时，才适用。
DefaultExt 缺省扩展名
DereferenceLinks 在从对话框返回前是否取消引用快捷方式
FileName 获取或设置一个包含在文件对话框中选定的文件名的字符串。
InitialDirector 对话框的初始目录
OverwritePrompt 控制在将要在改写现在文件时是否提示用户，只有在ValidateNames为真值时，才适用
ShowHelp 启用"帮助"按钮
Title 将显示在对话框标题栏中的字符
ValidateNames 控制对话框检查文件名中是否不含有无效的字符或序列

示例

System.IO.Stream stream;
System.Windows.Forms.SaveFileDialog saveFileDialog1 = new System.Windows.Forms.SaveFileDialog();
saveFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
saveFileDialog1.FilterIndex = 2;
saveFileDialog1.RestoreDirectory = true;
if (saveFileDialog1.ShowDialog() == DialogResult.OK)
{
    if ((stream = saveFileDialog1.OpenFile()) != null)
    {
        // Code to write the stream goes here.
        stream.Close();
     }
}

3、打印预览对话框和打印对话框

1、打印预览对话框(PrintPreviewDialog)属性:

AutoScrollMargin 获取或设置自动滚动边距的大小。
AutoScrollMinSize 获取或设置自动滚动的最小尺寸。
DialogResult 获取或设置窗体的对话框结果。
Document 获取或设置要预览的文档。
HelpButton 获取或设置一个值，该值指示是否应在窗体的标题框中显示“帮助”按钮。

2、打印对话框(PrintDialog)属性:

AllowPrintToFile 禁止或使用"打印到文件"复选框
AllowSelection 禁止或使用"选定内容"单选框
AllowSomePages 禁止或使用"页"单选按钮
Document 从中获取打印机设置的PrintDocument

PrintToFile 打印到文件"复选框是否选中
ShowHelp 控制是否显示"帮助"按钮
ShowNetWork 控制是否显示"网络"按钮

3、示例:

private void printPreviewButton_Click(object sender, EventArgs e)
{
    StreamReader streamToPrint = new StreamReader("PrintMe.Txt");
    try
    {
        PrintDocument pd = new PrintDocument(streamToPrint); //假定为默认打印机
        if (storedPageSettings != null)
        {
            pd.DefaultPageSettings = storedPageSettings;
        }
        PrintPreviewDialog dlg = new PrintPreviewDialog();
        dlg.Document = pd;
        dlg.ShowDialog();
    }
    finally
    {
        streamToPrint.Close();
    }

}

private void printButton_Click(object sender, EventArgs e)
{

    StreamReader streamToPrint = new StreamReader("PrintMe.Txt");
    try
    {
        PrintDocument pd = new PrintDocument(streamToPrint);
        PrintDialog dlg = new PrintDialog();
        dlg.Document = pd;
        DialogResult result = dlg.ShowDialog();
        if (result == DialogResult.OK)
            pd.Print();

    }
    finally
    {
        streamToPrint.Close();
    }

}

三、自定义对话框

1 模态窗口: ShowDialog():

打开模态窗口后，只要不关闭该窗口，鼠标焦点或者光标就会一直停留在该窗口上。只有关闭该窗口后，调用窗口才能继续。

模态窗口关闭后，仍可以读取模态窗口中的信息，如窗口的返回状态等,以后还可以使用ShowDialog（）使其可见。

2 非模态窗口: Show():

打开非模态窗口后，仍可以操作调用窗口。后面的代码立即执行。

关闭非模态窗口，该窗口将不复存在，会释放窗口的所有资源，所以无法得到该窗口的任何信息。常用Hide（）方法（等效于Visible=false）然后调用Show()方法使其可见。

3、对话框窗体：Form2

public Form1(string para)//获取参数
{
    InitializeComponent();

    this.StartPosition = FormStartPosition.CenterParent;//启动位置，父窗口中央
    this.MaximizeBox = false;
    this.MinimizeBox = false;
    this.ShowIcon = false;//不显示图标
    this.ControlBox = false;
    this.ShowInTaskbar = false;
    this.FormBorderStyle = FormBorderStyle.FixedDialog;//边框样式为固定对话框
    this.btnOK.DialogResult = DialogResult.OK;//"Enter"为OK按钮
    this.btnCancel.DialogResult = DialogResult.Cancel;//“ESC”为Cancel按钮
    this.textBox1.Text = para;
}

public string ReturnText //定义一个公共属性，供调用窗口Form1使用
{
    get { return this.textBox1.Text + "b"; }
}


private void Form1_Load(object sender, EventArgs e)
{
    if (this.Owner.Name != "Form1")//Owner为调用窗体，即调用改对话框的窗体
        MessageBox.Show("非法调用");
}


private void BtnOK_Click(object sender, EventArgs e)
{
    if (this.textBox1.Text.Trim().Length == 0)
        MessageBox.Show("无输入");
    this.textBox1.Focus();
    this.DialogResult = DialogResult.None;//阻止隐藏对话框，对话框不消失
}

4、主窗体Form1：

Form f2 = new Form2("a");

if (f2.ShowDialog(this) == DialogResult.OK)//对应Form2中的Owner，this为给对话框窗体传值
    this.textBox1.Text = f2.ReturnText;
f2.Close();
f2.Dispose();