Form.Modal Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab, der angibt, ob dieses Formular modal angezeigt wird.

public:
 property bool Modal { bool get(); };

[System.ComponentModel.Browsable(false)]
public bool Modal { get; }

[<System.ComponentModel.Browsable(false)>]
member this.Modal : bool

Public ReadOnly Property Modal As Boolean

Eigenschaftswert

Boolean

true, wenn das Formular modal angezeigt wird, andernfalls false.

Attribute: BrowsableAttribute

Beispiele

Im folgenden Beispiel wird die Modal Eigenschaft verwendet, um festzustellen, ob ein Formular als modales Formular angezeigt wird. Wenn dies nicht der FormBorderStyle Grund ist und TopLevel die Eigenschaften geändert werden, um das Formular als Formular auf nicht oberster Ebene mit einem Toolfensterrahmen zu erstellen.

private:
   void ShowMyNonModalForm()
   {
      Form^ myForm = gcnew Form;
      myForm->Text = "My Form";
      myForm->SetBounds( 10, 10, 200, 200 );
      myForm->Show();

      // Determine if the form is modal.
      if ( myForm->Modal == false )
      {
         // Change borderstyle and make it not a top level window.
         myForm->FormBorderStyle = ::FormBorderStyle::FixedToolWindow;
         myForm->TopLevel = false;
      }
   }

private void ShowMyNonModalForm()
{
    Form myForm = new Form();
    myForm.Text = "My Form";
    myForm.SetBounds(10,10,200,200);

    myForm.Show();
    // Determine if the form is modal.
    if(myForm.Modal == false)
    {
        // Change borderstyle and make it not a top level window.
        myForm.FormBorderStyle = FormBorderStyle.FixedToolWindow;
        myForm.TopLevel = false;
    }
}

Private Sub ShowMyNonModalForm()
    Dim myForm As New Form()
    myForm.Text = "My Form"
    myForm.SetBounds(10, 10, 200, 200)

    myForm.Show()
    ' Determine if the form is modal.
    If myForm.Modal = False Then
        ' Change borderstyle and make it not a top level window.
        myForm.FormBorderStyle = FormBorderStyle.FixedToolWindow
        myForm.TopLevel = False
    End If
End Sub

Hinweise

Wenn ein Formular modal angezeigt wird, kann keine Eingabe (Tastatur oder Mausklick) auftreten, außer für Objekte im modalen Formular. Das Programm muss ein modales Formular ausblenden oder schließen (in der Regel als Reaktion auf einige Benutzeraktionen), bevor eingaben an ein anderes Formular auftreten können. Formulare, die modal angezeigt werden, werden in der Regel als Dialogfelder in einer Anwendung verwendet.

Mit dieser Eigenschaft können Sie ermitteln, ob ein Formular, das Sie aus einer Methode oder Eigenschaft abgerufen haben, modal angezeigt wurde.

Verwenden Sie die ShowDialog Methode, um ein Formular modal anzuzeigen.

Gilt für

Siehe auch

ShowDialog()