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