Form.TopLevel-Eigenschaft

Ruft einen Wert ab, der angibt, ob das Formular als Fenster der obersten Ebene angezeigt wird, oder legt diesen fest.

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

Syntax

'Declaration
Public Property TopLevel As Boolean
'Usage
Dim instance As Form
Dim value As Boolean

value = instance.TopLevel

instance.TopLevel = value

public bool TopLevel { get; set; }

public:
property bool TopLevel {
    bool get ();
    void set (bool value);
}

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

/** @property */
public void set_TopLevel (boolean value)

public function get TopLevel () : boolean

public function set TopLevel (value : boolean)

Eigenschaftenwert

true, um das Formular als Fenster der obersten Ebene anzuzeigen, andernfalls false. Der Standardwert ist true.

Ausnahmen

Ausnahmetyp	Bedingung
Exception	Ein übergeordnetes MDI (Multiple Document Interface)-Formular muss ein Fenster der obersten Ebene sein.

Hinweise

Ein Fenster der obersten Ebene ist ein Fenster ohne übergeordnetes Formular oder ein Fenster, dessen übergeordnetes Formular das Desktopfenster ist. Fenster der obersten Ebene werden i. d. R. als Hauptformular einer Anwendung verwendet.

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
TopMost