CommonDialog.ShowDialog 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

运行通用对话框。

重载

ShowDialog()	用默认的所有者运行通用对话框。
ShowDialog(IWin32Window)	运行具有指定所有者的通用对话框。

ShowDialog()

Source:

CommonDialog.cs

用默认的所有者运行通用对话框。

C#

public System.Windows.Forms.DialogResult ShowDialog();

返回

DialogResult

如果用户在对话框中单击“确定”，则为 OK；否则为 Cancel。

示例

下面的代码示例使用 的ColorDialogCommonDialog实现，并说明了如何创建和显示对话框。 此示例要求从现有窗体中调用 方法，该窗体具有 TextBox 并 Button 放置在该窗体上。

C#

private void button1_Click(object sender, System.EventArgs e)
 {
    ColorDialog MyDialog = new ColorDialog();
    // Keeps the user from selecting a custom color.
    MyDialog.AllowFullOpen = false ;
    // Allows the user to get help. (The default is false.)
    MyDialog.ShowHelp = true ;
    // Sets the initial color select to the current text color.
    MyDialog.Color = textBox1.ForeColor ;
    
    // Update the text box color if the user clicks OK 
    if (MyDialog.ShowDialog() == DialogResult.OK)
        textBox1.ForeColor =  MyDialog.Color;
 }

注解

此方法实现 RunDialog。

另请参阅

• RunDialog(IntPtr)
• DialogResult

ShowDialog(IWin32Window)

Source:

CommonDialog.cs

运行具有指定所有者的通用对话框。

C#

public System.Windows.Forms.DialogResult ShowDialog(System.Windows.Forms.IWin32Window? owner);

参数

owner

IWin32Window

任何实现 IWin32Window（表示将拥有模式对话框的顶级窗口）的对象。

返回

DialogResult

如果用户在对话框中单击“确定”，则为 OK；否则为 Cancel。

注解

此版本的 ShowDialog 方法允许您指定将拥有所显示对话框的特定窗体或控件。 如果使用没有参数的此方法版本，则应用程序的当前活动窗口将自动拥有显示的对话框。