Form.Modal Eigenschaft

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

truewenn das Formular modal angezeigt wird; andernfalls . false

Attribute

BrowsableAttribute

Beispiele

Im folgenden Beispiel wird die Modal Eigenschaft verwendet, um zu bestimmen, ob ein Formular als modales Formular angezeigt wird. Wenn es sich nicht um die FormBorderStyle Eigenschaften handelt, TopLevel um das Formular zu einem Formular auf nicht oberster Ebene mit einem Toolfensterrahmen zu machen.

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 )
      {
         // 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)
    {
        // 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 es keine Eingabe (Tastatur oder Mausklick) geben, mit Ausnahme von Objekten im modalen Formular. Das Programm muss ein modales Formular ausblenden oder schließen (in der Regel als Reaktion auf eine Benutzeraktion), 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 Methode, um ein Formular modal ShowDialog anzuzeigen.

Weitere Informationen

• ShowDialog()