Styles des boutons
Cette rubrique décrit les types et les styles de bouton.
Types de bouton
Les types de listes de tableau suivant.Vous pouvez éventuellement choisir l'une des opérations suivantes.Si vous ne spécifiez pas de type de bouton, la valeur par défaut estBS_PUSHBUTTON.
Type |
Description |
|---|---|
BS_3STATE |
Crée un bouton de case à cocher avec trois états : BST_CHECKED, BST_INDETERMINATE, etBST_UNCHECKED.Si vous cliquez sur le bouton envoie une notification d' BN_CLICKED à la fenêtre propriétaire mais ne modifie pas l'état du bouton.Par défaut, le texte associé s'affiche à droite de la case à cocher.Pour afficher du texte à gauche de la case à cocher, utilisez le style d' BS_LEFTTEXT ou d' BS_RIGHTBUTTON . |
BS_AUTO3STATE |
Crée un bouton de case à cocher avec trois états : BST_CHECKED, BST_INDETERMINATE, etBST_UNCHECKED.Si vous cliquez sur le bouton envoie une notification d' BN_CLICKED à la fenêtre propriétaire et remplace l'état du bouton.Les rapports de bouton défilent dans l'ordre d' BST_CHECKED, d' BST_INDETERMINATE, et d' BST_UNCHECKED.Par défaut, le texte associé s'affiche à droite de la case à cocher.Pour afficher du texte à gauche de la case à cocher, utilisez le style d' BS_LEFTTEXT ou d' BS_RIGHTBUTTON . |
BS_AUTOCHECKBOX |
Crée un bouton de case à cocher avec deux états : BST_CHECKED et BST_UNCHECKED.Si vous cliquez sur le bouton envoie une notification d' BN_CLICKED à la fenêtre propriétaire et remplace l'état du bouton.Par défaut, le texte associé s'affiche à droite de la case à cocher.Pour afficher du texte à gauche de la case à cocher, utilisez le style d' BS_LEFTTEXT ou d' BS_RIGHTBUTTON . |
BS_AUTORADIOBUTTON |
Crée une case d'option avec deux états : BST_CHECKED et BST_UNCHECKED.Les cases d'option sont généralement utilisées dans les groupes, chaque groupe ayant un maximum d'une option activée à la fois.Si vous cliquez sur le bouton envoie une notification d' BN_CLICKED à la fenêtre propriétaire, définit l'état de la case d'option sélectionnée à BST_CHECKED, et définit les états de toutes les autres cases d'option du groupe de boutons à BST_UNCHECKED.Par défaut, le texte associé s'affiche à droite de la case d'option.Pour afficher du texte à gauche de la case d'option, utilisez le style d' BS_LEFTTEXT ou d' BS_RIGHTBUTTON . |
BS_CHECKBOX |
Crée un bouton de case à cocher avec deux états : BST_CHECKED et BST_UNCHECKED.Si vous cliquez sur le bouton envoie une notification d' BN_CLICKED à la fenêtre propriétaire mais ne modifie pas l'état du bouton.Par défaut, le texte associé s'affiche à droite de la case à cocher.Pour afficher du texte à gauche de la case à cocher, utilisez le style d' BS_LEFTTEXT ou d' BS_RIGHTBUTTON . |
BS_COMMANDLINK |
Crée un bouton de liaison de commande.Un bouton de liaison de commande est un détail du bouton de commande à Windows Vista qui affiche une flèche verte à gauche du texte principal et d'une remarque en dessous de le texte principal.Vous pouvez définir le texte à retenir à l'aide de CButton::SetNote. |
BS_DEFCOMMANDLINK |
Crée un bouton de liaison de commande.Un bouton de liaison de commande est un détail du bouton de commande à Windows Vista qui affiche une flèche verte à gauche du texte principal et d'une remarque en dessous de le texte principal.Vous pouvez définir le texte à retenir à l'aide de CButton::SetNote.Si le bouton est dans une boîte de dialogue, en appuyant sur la touche ENTRÉE envoie une notification d' BN_CLICKED à la boîte de dialogue même lorsque le bouton n'a pas le focus d'entrée. |
BS_DEFPUSHBUTTON |
Crée un bouton de commande qui a une bordure importante noire.Si le bouton est dans une boîte de dialogue, en appuyant sur la touche ENTRÉE envoie une notification d' BN_CLICKED à la boîte de dialogue même lorsque le bouton n'a pas le focus d'entrée. |
BS_DEFSPLITBUTTON |
Crée un bouton partagé.Un bouton partagé est un détail du bouton de commande à Windows Vista qui contient un bouton en regard de flèche déroulante.Lorsque vous cliquez sur le bouton, la commande par défaut est exécutée.Lorsque vous cliquez sur la flèche de déroulement, un menu de commandes supplémentaires s'affiche.Si le bouton partagé est dans une boîte de dialogue, en appuyant sur la touche ENTRÉE envoie une notification d' BN_CLICKED à la boîte de dialogue même lorsque le bouton n'a pas le focus d'entrée |
BS_GROUPBOX |
Crée un rectangle dans lequel d'autres boutons peuvent être regroupés.Le texte associé à ce style est affiché dans l'angle supérieur gauche du rectangle. |
BS_OWNERDRAW |
Crée un bouton owner-drawn.L'infrastructure appelle la méthode d' DrawItem lorsqu'un aspect visuel du bouton a changé.Ce style doit être défini lorsque vous utilisez la classe d' CBitmapButton . |
BS_PUSHBUTTON |
Crée un bouton de commande qui envoie une notification d' BN_CLICKED à la fenêtre propriétaire lorsque l'utilisateur clique sur le bouton. |
BS_RADIOBUTTON |
Crée une case d'option avec deux états : BST_CHECKED et BST_UNCHECKED.Les cases d'option sont généralement utilisées dans les groupes, chaque groupe ayant un maximum d'une option activée à la fois.Si vous cliquez sur le bouton envoie une notification d' BN_CLICKED à la fenêtre propriétaire mais ne change pas automatiquement l'état de boutons au groupe.Par défaut, le texte associé s'affiche à droite de la case d'option.Pour afficher du texte à gauche de la case d'option, utilisez le style d' BS_LEFTTEXT ou d' BS_RIGHTBUTTON . |
BS_SPLITBUTTON |
Crée un bouton partagé.Un bouton partagé est un détail du bouton de commande à Windows Vista qui contient un bouton en regard de flèche déroulante.Lorsque vous cliquez sur le bouton, la commande par défaut est exécutée.Lorsque vous cliquez sur la flèche de déroulement, un menu de commandes supplémentaires s'affiche. |
BS_USERBUTTON |
Obsolète, mais si pour la compatibilité avec les versions 16 bits de Windows.Les applications win32 doivent utiliser BS_OWNERDRAW à la place. |
Styles de case d'option et de case à cocher
Le tableau suivant répertorie les styles qui sont spécifiques à des cases d'option et de cases à cocher.Ces styles sont ignorés dans tous les autres types de bouton.Vous pouvez éventuellement choisir un ou plusieurs des éléments suivants.
Style |
Description |
|---|---|
BS_LEFTTEXT |
Lorsqu'il est combiné avec un style de case d'option ou de case à cocher, le texte apparaît sur le côté gauche de la case d'option ou de la case à cocher. |
BS_RIGHTBUTTON |
Lorsqu'il est combiné avec un style de case d'option ou de case à cocher, le texte apparaît sur le côté gauche de la case d'option ou de la case à cocher.Ce style est identique au style d' BS_LEFTTEXT . |
BS_PUSHLIKE |
Effectue une apparence de case à cocher ou de case d'option et se comporte comme un bouton de commande.Le bouton apparaît enfoncé lorsque son état est BST_CHECKED, enfoncé et estompée lorsque son état est BST_INDETERMINATE, puis relâché lorsque son état est BST_UNCHECKED. |
Styles d'alignement de texte
Le tableau suivant répertorie les options horizontales et de texte vertical d'inscription.Vous pouvez éventuellement choisir l'une des opérations suivantes.
Style |
Description |
|---|---|
BS_LEFT |
Aligne à gauche du texte dans le rectangle de bouton.Toutefois, si le bouton est une case à cocher ou une case d'option qui n'ont pas le style d' BS_RIGHTBUTTON , le texte est laissé aligné à droite de la case à cocher ou de la case d'option. |
BS_RIGHT |
La droite aligne le texte dans le rectangle de bouton.Toutefois, si le bouton est une case à cocher ou une case d'option qui n'ont pas le style d' BS_RIGHTBUTTON , le texte est simplement aligné à droite de la case à cocher ou de la case d'option. |
BS_CENTER |
Les centres texte horizontalement dans le rectangle de bouton. |
BS_TOP |
Les emplacements du texte en haut du rectangle de bouton. |
BS_BOTTOM |
Les emplacements du texte en bas du rectangle de bouton. |
BS_VCENTER |
Les centres texte verticalement dans le rectangle de bouton. |
Options de contenu de bouton
Le tableau suivant répertorie les options qui indiquent les éléments affichés dans le bouton.Types de bouton que seul le texte affiché ignorent ces styles.Vous pouvez éventuellement choisir l'une des opérations suivantes.
Style |
Description |
|---|---|
BS_BITMAP |
Spécifie que le bouton affiche une bitmap. |
BS_ICON |
Spécifie que le bouton affiche une icône. |
BS_TEXT |
Spécifie que le bouton affiche le texte. |
Autres options
Le tableau suivant répertorie les options supplémentaires que vous pouvez utiliser avec tout type de bouton.Vous pouvez éventuellement choisir un ou plusieurs des éléments suivants.
Style |
Description |
|---|---|
BS_FLAT |
Spécifie que le bouton est à deux dimensions et n'est pas dessiné avec l'ombrage par défaut pour créer une image à trois dimensions. |
BS_MULTILINE |
Encapsule le texte du bouton sur plusieurs lignes si la chaîne de texte est trop long de fonction sur une ligne unique le rectangle de bouton. |
BS_NOTIFY |
Permet à un bouton pour envoyer BN_DBLCLK, BN_KILLFOCUS, et messages de notification d' BN_SETFOCUS à sa fenêtre parente.Remarquez que les boutons envoient la notification d' BN_CLICKED que ce style est spécifié. |
Voir aussi
Référence
BN_CLICKED Notification