CommonDialog.ShowDialog Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Führt ein Standarddialogfeld aus.

Überlädt

ShowDialog()	Führt ein Standarddialogfeld mit einem Standardbesitzer aus.
ShowDialog(IWin32Window)	Führt ein Standarddialogfeld mit dem angegebenen Besitzer aus.

ShowDialog()

Führt ein Standarddialogfeld mit einem Standardbesitzer aus.

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

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

member this.ShowDialog : unit -> System.Windows.Forms.DialogResult

Public Function ShowDialog () As DialogResult

Gibt zurück

DialogResult

OK, wenn der Benutzer im Dialogfeld auf OK klickt, andernfalls Cancel.

Beispiele

Im folgenden Codebeispiel wird die Implementierung von CommonDialog und veranschaulicht das ColorDialog Erstellen und Anzeigen eines Dialogfelds. In diesem Beispiel ist erforderlich, dass die Methode innerhalb eines vorhandenen Formulars aufgerufen wird, das über eine TextBox Button und auf sie platzierte Methode verfügt.

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      ColorDialog^ MyDialog = gcnew 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() == ::System::Windows::Forms::DialogResult::OK )
      {
         textBox1->ForeColor = MyDialog->Color;
      }
   }

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;
 }

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
    Dim MyDialog As 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() = Windows.Forms.DialogResult.OK) Then
        TextBox1.ForeColor = MyDialog.Color
    End If
End Sub

Hinweise

Diese Methode implementiert RunDialog.

Siehe auch

• RunDialog(IntPtr)
• DialogResult

ShowDialog(IWin32Window)

Führt ein Standarddialogfeld mit dem angegebenen Besitzer aus.

public:
 System::Windows::Forms::DialogResult ShowDialog(System::Windows::Forms::IWin32Window ^ owner);

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

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

member this.ShowDialog : System.Windows.Forms.IWin32Window -> System.Windows.Forms.DialogResult

Public Function ShowDialog (owner As IWin32Window) As DialogResult

Parameter

owner

IWin32Window

Ein beliebiges Objekt, das IWin32Window implementiert, das das Fenster der obersten Ebene und damit den Besitzer des modalen Dialogfelds darstellt.

Gibt zurück

DialogResult

OK, wenn der Benutzer im Dialogfeld auf OK klickt, andernfalls Cancel.

Hinweise

Mit dieser Version der ShowDialog Methode können Sie ein bestimmtes Formular oder Steuerelement angeben, das das angezeigte Dialogfeld besitzt. Wenn Sie die Version dieser Methode verwenden, die keine Parameter enthält, würde das angezeigte Dialogfeld automatisch dem aktuell aktiven Fenster Ihrer Anwendung gehören.