Form.ControlBox Propriété

Définition

Obtient ou définit une valeur indiquant si une zone de contrôle est affichée dans la barre de légende du formulaire.

public:
 property bool ControlBox { bool get(); void set(bool value); };
public bool ControlBox { get; set; }
member this.ControlBox : bool with get, set
Public Property ControlBox As Boolean

Valeur de propriété

true si le formulaire affiche une zone de contrôle dans le coin supérieur droit du formulaire ; sinon, false. La valeur par défaut est true.

Exemples

L’exemple suivant utilise les ControlBoxpropriétés , FormBorderStyle, MaximizeBox, MinimizeBoxet StartPosition pour créer un formulaire qui n’a pas de bordure ou de zone légende. Le formulaire créé dans cet exemple peut être utilisé pour créer un écran de démarrage pour une application. L’exemple nécessite que la méthode de l’exemple soit définie dans une classe de formulaire et appelée lors de l’initialisation du formulaire.

public:
   void CreateMyBorderlessWindow()
   {
      this->FormBorderStyle = ::FormBorderStyle::None;
      this->MaximizeBox = false;
      this->MinimizeBox = false;
      this->StartPosition = FormStartPosition::CenterScreen;
      // Remove the control box so the form will only display client area.
      this->ControlBox = false;
   }
public void CreateMyBorderlessWindow()
 {
    this.FormBorderStyle = FormBorderStyle.None;
    this.MaximizeBox = false;
    this.MinimizeBox = false;
    this.StartPosition = FormStartPosition.CenterScreen;
    // Remove the control box so the form will only display client area.
    this.ControlBox = false;
 }
Public Sub CreateMyBorderlesWindow()
    FormBorderStyle = FormBorderStyle.None
    MaximizeBox = False
    MinimizeBox = False
    StartPosition = FormStartPosition.CenterScreen
    ' Remove the control box so the form will only display client area.
    ControlBox = False
End Sub

Remarques

Si la propriété a la ControlBox valeur true, la zone de contrôle s’affiche dans le coin supérieur droit de la barre de légende. La zone de contrôle peut inclure des boutons réduire, agrandir et aider en plus d’un bouton Fermer. Pour que la ControlBox propriété ait un effet, vous devez également définir la propriété du FormBorderStyle formulaire sur FormBorderStyle.FixedSingle, FormBorderStyle.Sizable, FormBorderStyle.Fixed3Dou FormBorderStyle.FixedDialog.

Si vous définissez falseControlBox sur et que vous définissez également la Location propriété, la Size propriété du formulaire n’est pas mise à jour pour refléter que la zone non cliente du formulaire a été masquée. Pour résoudre ce problème, placez le code qui modifie la Location propriété dans le gestionnaire d’événements HandleCreated .

Notes

Lorsqu’elle falseest définie sur , la ControlBox propriété n’a aucun effet sur un formulaire enfant MDI (Multi-Document Interface) qui est affiché agrandi au moment de la création.

S’applique à

Voir aussi