Form.TopLevel Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

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

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

[<System.ComponentModel.Browsable(false)>]
member this.TopLevel : bool with get, set

Public Property TopLevel As Boolean

Eigenschaftswert

Boolean

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

Attribute

BrowsableAttribute

Ausnahmen

Exception

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

Beispiele

Im folgenden Beispiel wird mithilfe der Modal Eigenschaft ermittelt, 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 nicht auf 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

Ein Formular auf oberster Ebene ist ein Fenster ohne übergeordnetes Formular oder dessen übergeordnetes Formular das Desktopfenster ist. Fenster auf oberster Ebene werden in der Regel als Hauptformular in einer Anwendung verwendet.

Siehe auch

• TopMost