Form.TopLevel 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 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.

Gilt für

Siehe auch

TopMost