Form.ShowDialog Form.ShowDialog Form.ShowDialog Form.ShowDialog Method

Definition

Zeigt das Formular als modales Dialogfeld an. Shows the form as a modal dialog box.

Overloads

ShowDialog() ShowDialog() ShowDialog() ShowDialog()

Zeigt das Formular als modales Dialogfeld an. Shows the form as a modal dialog box.

ShowDialog(IWin32Window) ShowDialog(IWin32Window) ShowDialog(IWin32Window) ShowDialog(IWin32Window)

Zeigt das Formular als modales Dialogfeld mit dem angegebenen Besitzer an. Shows the form as a modal dialog box with the specified owner.

ShowDialog() ShowDialog() ShowDialog() ShowDialog()

Zeigt das Formular als modales Dialogfeld an. Shows the form as a modal dialog box.

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

Returns

Exceptions

Das anzuzeigende Formular ist bereits sichtbar. The form being shown is already visible. - oder - -or- Das anzuzeigende Formular ist deaktiviert. The form being shown is disabled. - oder - -or- Das anzuzeigende Formular ist kein Fenster der obersten Ebene. The form being shown is not a top-level window. - oder - -or- Das als Dialogfeld anzuzeigende Formular ist bereits ein modales Formular. The form being shown as a dialog box is already a modal form. - oder - -or- Der aktuelle Prozess wird nicht im interaktiven Modus ausgeführt (weitere Informationen finden Sie unter UserInteractive). The current process is not running in user interactive mode (for more information, see UserInteractive).

Examples

Im folgenden Codebeispiel wird ein Formular als modales Dialogfeld angezeigt, und wertet Sie den Rückgabewert des Dialogfelds vor bestimmen, ob der Wert des gelesen eine TextBox Steuerelement im Formular Dialogfelds.The following code example displays a form as a modal dialog box and evaluates the return value of the dialog box before determining whether to read the value of a TextBox control on the dialog box form. In diesem Beispiel erfordert, dass eine Form mit dem Namen testDialog wird erstellt und die darin enthaltenen eine TextBox Steuerelement mit dem Namen TextBox1.This example requires that a Form named testDialog is created and that it contains a TextBox control named TextBox1. Beispiel darüber hinaus ist es erforderlich, dass der Code in diesem Beispiel enthalten und aufgerufen wird, aus einer anderen Form zum Anzeigen testDialog als modales Dialogfeld.Furthermore, the example requires that code in this example is contained and called from a different Form in order to display testDialog as a modal dialog box. Im Beispiel wird die Version des ShowDialog , die einen Besitzer für das Dialogfeld angibt.The example uses the version of ShowDialog that specifies an owner for the dialog box.

void ShowMyDialogBox()
{
   Form2^ testDialog = gcnew Form2;
   
   // Show testDialog as a modal dialog and determine if DialogResult = OK.
   if ( testDialog->ShowDialog( this ) == ::DialogResult::OK )
   {
      
      // Read the contents of testDialog's TextBox.
      this->txtResult->Text = testDialog->TextBox1->Text;
   }
   else
   {
      this->txtResult->Text = "Cancelled";
   }

   delete testDialog;
}
public void ShowMyDialogBox()
{
   Form2 testDialog = new Form2();

   // Show testDialog as a modal dialog and determine if DialogResult = OK.
   if (testDialog.ShowDialog(this) == DialogResult.OK)
   {
      // Read the contents of testDialog's TextBox.
      this.txtResult.Text = testDialog.TextBox1.Text;
   }
   else
   {
      this.txtResult.Text = "Cancelled";
   }
   testDialog.Dispose();
}
Public Sub ShowMyDialogBox()
    Dim testDialog As New Form2()
    
    ' Show testDialog as a modal dialog and determine if DialogResult = OK.
    If testDialog.ShowDialog(Me) = System.Windows.Forms.DialogResult.OK Then
        ' Read the contents of testDialog's TextBox.
        txtResult.Text = testDialog.TextBox1.Text
    Else
        txtResult.Text = "Cancelled"
    End If
    testDialog.Dispose()
End Sub 'ShowMyDialogBox

Remarks

Sie können diese Methode verwenden, um ein modales Dialogfeld in der Anwendung anzuzeigen.You can use this method to display a modal dialog box in your application. Wenn diese Methode aufgerufen wird, wird der folgende Code wird erst nach dem Schließen des Dialogfelds nicht ausgeführt.When this method is called, the code following it is not executed until after the dialog box is closed. Das Dialogfeld kann zugewiesen werden, einen der Werte von der DialogResult Enumeration um die Zuweisung zu der DialogResult Eigenschaft eine Button für das Formular oder durch Festlegen der DialogResult -Eigenschaft des Formulars im Code.The dialog box can be assigned one of the values of the DialogResult enumeration by assigning it to the DialogResult property of a Button on the form or by setting the DialogResult property of the form in code. Dieser Wert wird von dieser Methode zurückgegeben.This value is then returned by this method. Sie können diesen Rückgabewert verwenden, um zu bestimmen, wie zum Verarbeiten der Aktionen, die Sie im Dialogfeld aufgetreten sind.You can use this return value to determine how to process the actions that occurred in the dialog box. Angenommen, Sie das Dialogfeld geschlossen und zurückgegeben wurde der DialogResult.Cancel Wert mit dieser Methode, Sie könnte verhindern, dass Code nach dem Aufruf an ShowDialog ausgeführt.For example, if the dialog box was closed and returned the DialogResult.Cancel value through this method, you could prevent code following the call to ShowDialog from executing.

Wenn ein Formular als modales Dialogfeld angezeigt wird, durch Klicken auf die schließen (die Schaltfläche mit einem X in der oberen rechten Ecke des Formulars), wird das Formular ausgeblendet werden und die DialogResult Eigenschaft festgelegt werden, um DialogResult.Cancel.When a form is displayed as a modal dialog box, clicking the Close button (the button with an X at the upper-right corner of the form) causes the form to be hidden and the DialogResult property to be set to DialogResult.Cancel. Im Gegensatz zu nicht modale Formulare die Close Methode wird nicht von .NET Framework aufgerufen, wenn der Benutzer klickt auf die Schaltfläche Schließen das Dialogfeld, oder den Wert für legt die DialogResult Eigenschaft.Unlike non-modal forms, the Close method is not called by the .NET Framework when the user clicks the close form button of a dialog box or sets the value of the DialogResult property. Stattdessen wird das Formular ausgeblendet, und kann erneut ohne Erstellen einer neuen Instanz des Dialogfelds angezeigt werden.Instead the form is hidden and can be shown again without creating a new instance of the dialog box. Da ein Formular angezeigt, wie ein Dialogfeld und geschlossen ausgeblendet, die Sie aufrufen müssen die Dispose -Methode des Formulars bei Verwendung der Form von Ihrer Anwendung nicht mehr benötigt wird.Because a form displayed as a dialog box is hidden instead of closed, you must call the Dispose method of the form when the form is no longer needed by your application.

Diese Version von der ShowDialog Methode gibt keines Formulars oder Steuerelements als Besitzer.This version of the ShowDialog method does not specify a form or control as its owner. Wenn diese Version aufgerufen wird, erfolgt das momentan aktive Fenster, den Besitzer des Dialogfelds.When this version is called, the currently active window is made the owner of the dialog box. Wenn Sie einen bestimmten Besitzer angeben möchten, verwenden Sie die andere Version dieser Methode.If you want to specify a specific owner, use the other version of this method.

See Also

ShowDialog(IWin32Window) ShowDialog(IWin32Window) ShowDialog(IWin32Window) ShowDialog(IWin32Window)

Zeigt das Formular als modales Dialogfeld mit dem angegebenen Besitzer an. Shows the form as a modal dialog box with the specified 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 IWin32Window IWin32Window IWin32Window

Ein beliebiges Objekt, das IWin32Window implementiert, das das Fenster der obersten Ebene und damit den Besitzer des modalen Dialogfelds darstellt. Any object that implements IWin32Window that represents the top-level window that will own the modal dialog box.

Returns

Exceptions

Das im owner-Parameter angegebene Formular ist mit dem angezeigten Formular identisch. The form specified in the owner parameter is the same as the form being shown.

Das anzuzeigende Formular ist bereits sichtbar. The form being shown is already visible. - oder - -or- Das anzuzeigende Formular ist deaktiviert. The form being shown is disabled. - oder - -or- Das anzuzeigende Formular ist kein Fenster der obersten Ebene. The form being shown is not a top-level window. - oder - -or- Das als Dialogfeld anzuzeigende Formular ist bereits ein modales Formular. The form being shown as a dialog box is already a modal form. - oder - -or- Der aktuelle Prozess wird nicht im interaktiven Modus ausgeführt (weitere Informationen finden Sie unter UserInteractive). The current process is not running in user interactive mode (for more information, see UserInteractive).

Examples

Im folgenden Codebeispiel wird ein Formular als modales Dialogfeld angezeigt, und wertet Sie den Rückgabewert des Dialogfelds vor bestimmen, ob der Wert des gelesen eine TextBox Steuerelement im Formular Dialogfelds.The following code example displays a form as a modal dialog box and evaluates the return value of the dialog box before determining whether to read the value of a TextBox control on the dialog box form. In diesem Beispiel erfordert, dass eine Form mit dem Namen Form2 wird erstellt und die darin enthaltenen eine TextBox Steuerelement mit dem Namen TextBox1.This example requires that a Form named Form2 is created and that it contains a TextBox control named TextBox1. Im Beispiel wird die Version des ShowDialog , die einen Besitzer für das Dialogfeld angibt.The example uses the version of ShowDialog that specifies an owner for the dialog box.

void ShowMyDialogBox()
{
   Form2^ testDialog = gcnew Form2;
   
   // Show testDialog as a modal dialog and determine if DialogResult = OK.
   if ( testDialog->ShowDialog( this ) == ::DialogResult::OK )
   {
      
      // Read the contents of testDialog's TextBox.
      this->txtResult->Text = testDialog->TextBox1->Text;
   }
   else
   {
      this->txtResult->Text = "Cancelled";
   }

   delete testDialog;
}
public void ShowMyDialogBox()
{
   Form2 testDialog = new Form2();

   // Show testDialog as a modal dialog and determine if DialogResult = OK.
   if (testDialog.ShowDialog(this) == DialogResult.OK)
   {
      // Read the contents of testDialog's TextBox.
      this.txtResult.Text = testDialog.TextBox1.Text;
   }
   else
   {
      this.txtResult.Text = "Cancelled";
   }
   testDialog.Dispose();
}
Public Sub ShowMyDialogBox()
    Dim testDialog As New Form2()
    
    ' Show testDialog as a modal dialog and determine if DialogResult = OK.
    If testDialog.ShowDialog(Me) = System.Windows.Forms.DialogResult.OK Then
        ' Read the contents of testDialog's TextBox.
        txtResult.Text = testDialog.TextBox1.Text
    Else
        txtResult.Text = "Cancelled"
    End If
    testDialog.Dispose()
End Sub 'ShowMyDialogBox

Remarks

Sie können diese Methode verwenden, um ein modales Dialogfeld in der Anwendung anzuzeigen.You can use this method to display a modal dialog box in your application. Wenn diese Methode aufgerufen wird, wird der folgende Code wird erst nach dem Schließen des Dialogfelds nicht ausgeführt.When this method is called, the code following it is not executed until after the dialog box is closed. Das Dialogfeld kann zugewiesen werden, einen der Werte von DialogResult durch Zuweisung zu den DialogResult Eigenschaft eine Button für das Formular oder durch Festlegen der DialogResult -Eigenschaft des Formulars im Code.The dialog box can be assigned one of the values of DialogResult by assigning it to the DialogResult property of a Button on the form or by setting the DialogResult property of the form in code. Dieser Wert wird von dieser Methode zurückgegeben.This value is then returned by this method. Sie können diesen Rückgabewert verwenden, um zu bestimmen, wie zum Verarbeiten der Aktionen, die Sie im Dialogfeld aufgetreten sind.You can use this return value to determine how to process the actions that occurred in the dialog box. Angenommen, Sie das Dialogfeld geschlossen und zurückgegeben wurde der DialogResult.Cancel Wert mit dieser Methode, Sie könnte verhindern, dass Code nach dem Aufruf an ShowDialog ausgeführt.For example, if the dialog box was closed and returned the DialogResult.Cancel value through this method, you could prevent code following the call to ShowDialog from executing.

Wenn ein Formular als modales Dialogfeld angezeigt wird, durch Klicken auf die schließen (die Schaltfläche mit einem X in der oberen rechten Ecke des Formulars), wird das Formular ausgeblendet werden und die DialogResult Eigenschaft festgelegt werden, um DialogResult.Cancel.When a form is displayed as a modal dialog box, clicking the Close button (the button with an X at the upper-right corner of the form) causes the form to be hidden and the DialogResult property to be set to DialogResult.Cancel. Im Gegensatz zu nicht modale Formulare die Close Methode wird nicht von .NET Framework aufgerufen, wenn der Benutzer klickt auf die Schaltfläche Schließen das Dialogfeld, oder den Wert für legt die DialogResult Eigenschaft.Unlike modeless forms, the Close method is not called by the .NET Framework when the user clicks the close form button of a dialog box or sets the value of the DialogResult property. Stattdessen wird das Formular ausgeblendet, und kann erneut ohne Erstellen einer neuen Instanz des Dialogfelds angezeigt werden.Instead the form is hidden and can be shown again without creating a new instance of the dialog box. Da ein Formular angezeigt, wie ein Dialogfeld und geschlossen ausgeblendet, die Sie aufrufen müssen die Dispose -Methode des Formulars bei Verwendung der Form von Ihrer Anwendung nicht mehr benötigt wird.Because a form displayed as a dialog box is hidden instead of closed, you must call the Dispose method of the form when the form is no longer needed by your application.

Diese Version von der ShowDialog Methode können Sie eine bestimmte Form an, das das Dialogfeld besitzen soll, die angezeigt wird.This version of the ShowDialog method allows you to specify a specific form that will own the dialog box that is shown.

See Also

Applies to