Form.ControlBox Propriété
Définition
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 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, setPublic Property ControlBox As BooleanValeur 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 propriétés , , MinimizeBoxFormBorderStyleMaximizeBoxet StartPosition les ControlBoxpropriétés pour créer un formulaire qui n’a pas de bordure ou de zone de 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 lorsque le formulaire est initialisé.
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 ControlBox propriété est définie truesur , 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 de réduction, d’agrandissement et d’aide 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.Sizableou FormBorderStyle.Fixed3DFormBorderStyle.FixedDialog.
Si vous définissez ControlBoxfalse et 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 HandleCreated gestionnaire d’événements.
Note
Lorsqu’elle est définie false, la ControlBox propriété n’a aucun effet sur un formulaire enfant mDI (Multiple-document interface) qui est affiché agrandi au moment de la création.
