Form.Modal-Eigenschaft

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public ReadOnly Property Modal As Boolean
'Usage
Dim instance As Form
Dim value As Boolean

value = instance.Modal

public bool Modal { get; }

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

/** @property */
public boolean get_Modal ()

public function get Modal () : boolean

Eigenschaftenwert

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

Hinweise

Wenn ein Formular modal angezeigt wird, können Eingaben (über die Tastatur oder per Mausklick) ausschließlich für die im Formular enthaltenen Objekte erfolgen. Das Programm muss ein modales Formular ausblenden oder schließen (üblicherweise als Reaktion auf eine Benutzeraktion), bevor eine Eingabe in ein anderes Formular vorgenommen werden kann. Modal angezeigte Formulare werden in einer Anwendung i. d. R. als Dialogfelder verwendet.

Mit dieser Eigenschaft können Sie bestimmen, ob ein von einer Methode oder Eigenschaft abgerufenes Formular modal angezeigt wurde.

Zum modalen Anzeigen eines Formulars verwenden Sie die ShowDialog-Methode.

Beispiel

Im folgenden Codebeispiel wird mithilfe der Modal-Eigenschaft ermittelt, ob ein Formular modal angezeigt wird. Ist dies nicht der Fall, werden die FormBorderStyle-Eigenschaft und die TopLevel-Eigenschaft geändert, damit das Formular zu einem Formular mit Toolfensterrahmen wird, das sich nicht auf der obersten Ebene befindet.

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

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:
   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.set_Text("My Form");
    myForm.SetBounds(10, 10, 200, 200);
    myForm.Show();

    // Determine if the form is modal.
    if (myForm.get_Modal() == false) {
        // Change borderstyle and make it not a top level window.
        myForm.set_FormBorderStyle(get_FormBorderStyle().FixedToolWindow);
        myForm.set_TopLevel(false);
    }
} //ShowMyNonModalForm

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Form-Klasse
Form-Member
System.Windows.Forms-Namespace
ShowDialog