Form.TopLevel Propriété

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit une valeur indiquant si le formulaire doit s'afficher comme une fenêtre de niveau supérieur.

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

Valeur de propriété

Boolean

true pour afficher le formulaire comme une fenêtre de niveau supérieur ; sinon, false. La valeur par défaut est true.

Attributs: BrowsableAttribute

Exceptions

Exception

Un formulaire parent MDI doit être une fenêtre de niveau supérieur.

Exemples

L’exemple suivant utilise la Modal propriété pour déterminer si un formulaire est affiché en tant que formulaire modal. Si ce n’est pas le cas et TopLevel que les FormBorderStyle propriétés sont modifiées pour que le formulaire ne soit pas de niveau supérieur avec une bordure de fenêtre outil.

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

Remarques

Un formulaire de niveau supérieur est une fenêtre qui n’a pas de formulaire parent ou dont le formulaire parent est la fenêtre de bureau. Les fenêtres de niveau supérieur sont généralement utilisées comme formulaire principal dans une application.

S’applique à

Voir aussi

TopMost