Partager via


Styles de contrôle et de bouton de barre d’outils

Les styles de fenêtre suivants sont spécifiques aux barres d’outils. Ils sont combinés avec d’autres styles de fenêtre lors de la création de la barre d’outils.

Note Pour common controls version 6.00, si un style visuel est utilisé avec la barre d’outils, les boutons sont toujours transparents, quel que soit le paramètre de style. Sinon, le comportement de transparence est normal, comme l’indique l’utilisation du style TBSTYLE_FLAT ou TBSTYLE_TRANSPARENT.

Notes

Comctl32.dll version 6 n’est pas redistribuable, mais elle est incluse dans Windows. Pour utiliser Comctl32.dll version 6, spécifiez-la dans un manifeste. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.

Constante Description
TBSTYLE_ALTDRAG
Permet aux utilisateurs de modifier la position d’un bouton de barre d’outils en le faisant glisser tout en maintenant la touche ALT enfoncée. Si ce style n’est pas spécifié, l’utilisateur doit maintenir la touche Maj enfoncée tout en faisant glisser un bouton. Notez que le style CCS_ADJUSTABLE doit être spécifié pour permettre aux boutons de la barre d’outils d’être déplacés.
TBSTYLE_CUSTOMERASE
Version 4.70. Génère des codes de notification NM_CUSTOMDRAW lorsque la barre d’outils traite WM_ERASEBKGND messages.
TBSTYLE_FLAT
Version 4.70. Crée une barre d’outils plate. Dans une barre d’outils plate, la barre d’outils et les boutons sont transparents et le suivi à chaud est activé. Le texte du bouton s’affiche sous les bitmaps de bouton. Pour éviter les problèmes de repeint, ce style doit être défini avant que le contrôle de barre d’outils ne devienne visible.
TBSTYLE_LIST
Version 4.70. Crée une barre d’outils plate avec le texte du bouton à droite de la bitmap. Sinon, ce style est identique à TBSTYLE_FLAT. Pour éviter les problèmes de repeint, ce style doit être défini avant que le contrôle de barre d’outils ne devienne visible.
TBSTYLE_REGISTERDROP
Version 4.71. Génère TBN_GETOBJECT codes de notification pour demander la suppression d’objets cibles lorsque le curseur passe sur les boutons de la barre d’outils.
TBSTYLE_TOOLTIPS
Crée un contrôle d’info-bulle qu’une application peut utiliser pour afficher le texte descriptif des boutons dans la barre d’outils.
TBSTYLE_TRANSPARENT
Version 4.71. Crée une barre d’outils transparente. Dans une barre d’outils transparente, la barre d’outils est transparente, mais les boutons ne le sont pas. Le texte du bouton s’affiche sous les bitmaps de bouton. Pour éviter les problèmes de repeint, ce style doit être défini avant que le contrôle de barre d’outils ne devienne visible.
TBSTYLE_WRAPABLE
Crée une barre d’outils qui peut avoir plusieurs lignes de boutons. Les boutons de barre d’outils peuvent être « encapsulé » à la ligne suivante lorsque la barre d’outils devient trop étroite pour inclure tous les boutons sur la même ligne. Lorsque la barre d’outils est encapsulée, l’arrêt se produit sur le séparateur le plus à droite ou sur le bouton le plus à droite s’il n’y a aucun séparateur dans la barre. Ce style doit être défini pour afficher un contrôle de barre d’outils verticale lorsque la barre d’outils fait partie d’un contrôle de barre d’outils verticale. Ce style ne peut pas être combiné avec CCS_VERT.

Note: Un bouton de barre d’outils peut avoir une combinaison des styles suivants. Pour spécifier un style de bouton, définissez les indicateurs appropriés dans le membre fsStyle de la structure TBBUTTON du bouton. Tous les styles ne peuvent pas être combinés.

Pour Shell version 4.72 et antérieure, les indicateurs de style de fenêtre et de bouton avaient le formulaire TBSTYLE_XXX. Si vous compilez une application avec la version 4.72 ou antérieure de Commctrl.h, vous devez utiliser les indicateurs de style de bouton TBSTYLE_XXX. Pour les versions 5.80 et ultérieures, tous les styles de bouton ont le formulaire BTNS_XXX. Toutes les valeurs TBSTYLE_XXX ont des valeurs BTNS_XXX équivalentes, avec la même signification et la même valeur numérique. Pour des raisons pratiques, les deux formulaires sont indiqués dans le tableau suivant.

Constante Description
BTNS_AUTOSIZE
Version 5.80. Spécifie que le contrôle de barre d’outils ne doit pas affecter la largeur standard au bouton. Au lieu de cela, la largeur du bouton est calculée en fonction de la largeur du texte et de l’image du bouton. Utilisez l’indicateur de style équivalent , TBSTYLE_AUTOSIZE, pour les versions 4.72 et antérieures.
BTNS_BUTTON
Version 5.80. Crée un bouton standard. Utilisez l’indicateur de style équivalent , TBSTYLE_BUTTON, pour les versions 4.72 et antérieures. Cet indicateur est défini sur 0 et doit être utilisé pour indiquer qu’aucun autre indicateur n’est défini.
BTNS_CHECK
Version 5.80. Crée un bouton poussoir à double état qui bascule entre les états pressés et non enfoncés chaque fois que l’utilisateur clique dessus. Le bouton a une couleur d’arrière-plan différente lorsqu’il est dans l’état appuyé. Utilisez l’indicateur de style équivalent , TBSTYLE_CHECK, pour les versions 4.72 et antérieures.
BTNS_CHECKGROUP
Version 5.80. Crée un bouton qui reste enfoncé jusqu’à ce qu’un autre bouton du groupe soit appuyé, comme les boutons d’option (également appelés cases d’option). Cela revient à combiner BTNS_CHECK et BTNS_GROUP. Utilisez l’indicateur de style équivalent , TBSTYLE_CHECKGROUP, pour les versions 4.72 et antérieures.
BTNS_DROPDOWN
Version 5.80. Crée un bouton de style de liste déroulante qui peut afficher une liste lorsque l’utilisateur clique sur le bouton. Au lieu du message WM_COMMAND utilisé pour les boutons normaux, les boutons déroulants envoient un code de notification TBN_DROPDOWN . Une application peut ensuite faire en sorte que le gestionnaire de notifications affiche une liste d’options. Utilisez l’indicateur de style équivalent , TBSTYLE_DROPDOWN, pour les versions 4.72 et antérieures.
Si la barre d’outils a le style étendu TBSTYLE_EX_DRAWDDARROWS , les boutons déroulants affichent une flèche déroulante dans une section distincte à leur droite. Si vous cliquez sur la flèche, un code de notification TBN_DROPDOWN est envoyé. Si vous cliquez sur le bouton associé, un message WM_COMMAND est envoyé.
BTNS_GROUP
Version 5.80. Lorsqu’il est combiné avec BTNS_CHECK, crée un bouton qui reste enfoncé jusqu’à ce qu’un autre bouton du groupe soit appuyé. Utilisez l’indicateur de style équivalent , TBSTYLE_GROUP, pour les versions 4.72 et antérieures.
BTNS_NOPREFIX
Version 5.80. Spécifie que le texte du bouton n’aura pas de préfixe d’accélérateur associé. Utilisez l’indicateur de style équivalent , TBSTYLE_NOPREFIX, pour les versions 4.72 et antérieures.
BTNS_SEP
Version 5.80. Crée un séparateur, en fournissant un petit écart entre les groupes de boutons. Un bouton qui a ce style ne reçoit pas d’entrée utilisateur. Utilisez l’indicateur de style équivalent , TBSTYLE_SEP, pour les versions 4.72 et antérieures.
BTNS_SHOWTEXT
Version 5.81. Spécifie que le texte du bouton doit être affiché. Tous les boutons peuvent avoir du texte, mais seuls les boutons avec le style de bouton BTNS_SHOWTEXT l’affichent. Ce style de bouton doit être utilisé avec le style TBSTYLE_LIST et le style étendu TBSTYLE_EX_MIXEDBUTTONS . Si vous définissez du texte pour les boutons qui n’ont pas le style BTNS_SHOWTEXT, le contrôle de barre d’outils l’affiche automatiquement en tant qu’info-bulle lorsque le curseur pointe sur le bouton. Cette fonctionnalité permet à votre application d’éviter de gérer le code de notification TBN_GETINFOTIP ou TTN_GETDISPINFO pour la barre d’outils.
BTNS_WHOLEDROPDOWN
Version 5.80. Spécifie que le bouton aura une flèche déroulante, mais pas en tant que section distincte. Les boutons avec ce style se comportent de la même façon, que le style étendu TBSTYLE_EX_DRAWDDARROWS soit défini ou non.
TBSTYLE_AUTOSIZE
Équivalent à BTNS_AUTOSIZE. Utilisez TBSTYLE_AUTOSIZE pour les versions 4.72 et antérieures .
TBSTYLE_BUTTON
Équivalent à BTNS_BUTTON. Utilisez TBSTYLE_BUTTON pour les versions 4.72 et antérieures.
TBSTYLE_CHECK
Équivalent à BTNS_CHECK. Utilisez TBSTYLE_CHECK pour les versions 4.72 et antérieures .
TBSTYLE_CHECKGROUP
Équivalent à BTNS_CHECKGROUP. Utilisez TBSTYLE_CHECKGROUP pour les versions 4.72 et antérieures .
TBSTYLE_DROPDOWN
Équivalent à BTNS_DROPDOWN. Utilisez TBSTYLE_DROPDOWN pour les versions 4.72 et antérieures.
TBSTYLE_GROUP
Équivalent à BTNS_GROUP. Utilisez TBSTYLE_GROUP pour les versions 4.72 et antérieures.
TBSTYLE_NOPREFIX
Équivalent à BTNS_NOPREFIX. Utilisez TBSTYLE_NOPREFIX pour les versions 4.72 et antérieures .
TBSTYLE_SEP
Équivalent à BTNS_SEP. Utilisez TBSTYLE_SEP pour les versions 4.72 et antérieures .

Spécifications

Condition requise Valeur
En-tête
CommCtrl.h