Barre d'outils

Cette section contient des informations sur les éléments de programmation utilisés avec les contrôles de barre d’outils.

Vues d'ensemble

Rubrique	Contenu
À propos des contrôles de barre d’outils	Une barre d’outils est un contrôle qui contient un ou plusieurs boutons. Chaque bouton, lorsqu’un utilisateur clique, envoie un message de commande à la fenêtre parente. En règle générale, les boutons d’une barre d’outils correspondent aux éléments du menu de l’application, ce qui offre à l’utilisateur un moyen supplémentaire et plus direct d’accéder aux commandes d’une application.
Utilisation des contrôles de barre d’outils	Cette rubrique contient des détails d’implémentation et des exemples de code pour l’utilisation de contrôles de barre d’outils dans vos applications.

Fonctions

Rubrique	Contenu
CreateMappedBitmap	Crée une bitmap à utiliser dans une barre d’outils.
CreateToolbarEx	Crée une fenêtre de barre d’outils et ajoute les boutons spécifiés à la barre d’outils. Note: Cette fonction est déconseillée, car elle ne prend pas en charge toutes les fonctionnalités des barres d’outils. Utilisez Plutôt CreateWindowEx . Pour obtenir des exemples, consultez Utilisation de contrôles de barre d’outils.

Messages

Rubrique	Contenu
TB_ADDBITMAP	Ajoute une ou plusieurs images à la liste des images de bouton disponibles pour une barre d’outils.
TB_ADDBUTTONS	Ajoute un ou plusieurs boutons à une barre d’outils.
TB_ADDSTRING	Ajoute une nouvelle chaîne au pool de chaînes de la barre d’outils.
TB_AUTOSIZE	Provoque le redimensionnement d’une barre d’outils.
TB_BUTTONCOUNT	Récupère le nombre de boutons actuellement dans la barre d’outils.
TB_BUTTONSTRUCTSIZE	Spécifie la taille de la structure TBBUTTON .
TB_CHANGEBITMAP	Modifie la bitmap d’un bouton dans une barre d’outils.
TB_CHECKBUTTON	Vérifie ou désélectionner un bouton donné dans une barre d’outils.
TB_COMMANDTOINDEX	Récupère l’index de base zéro pour le bouton associé à l’identificateur de commande spécifié.
TB_CUSTOMIZE	Affiche la boîte de dialogue Personnaliser la barre d’outils .
TB_DELETEBUTTON	Supprime un bouton de la barre d’outils.
TB_ENABLEBUTTON	Active ou désactive le bouton spécifié dans une barre d’outils.
TB_GETANCHORHIGHLIGHT	Récupère le paramètre de mise en surbrillance de l’ancre pour une barre d’outils.
TB_GETBITMAP	Récupère l’index de la bitmap associée à un bouton dans une barre d’outils.
TB_GETBITMAPFLAGS	Récupère les indicateurs qui décrivent le type de bitmap à utiliser.
TB_GETBUTTON	Récupère des informations sur le bouton spécifié dans une barre d’outils.
TB_GETBUTTONINFO	Récupère des informations étendues pour un bouton dans une barre d’outils.
TB_GETBUTTONSIZE	Récupère la largeur et la hauteur actuelles des boutons de barre d’outils, en pixels.
TB_GETBUTTONTEXT	Récupère le texte d’affichage d’un bouton dans une barre d’outils.
TB_GETCOLORSCHEME	Récupère les informations du jeu de couleurs à partir du contrôle de barre d’outils.
TB_GETDISABLEDIMAGELIST	Récupère la liste d’images qu’un contrôle de barre d’outils utilise pour afficher les boutons inactifs.
TB_GETEXTENDEDSTYLE	Récupère les styles étendus d’un contrôle de barre d’outils.
TB_GETHOTIMAGELIST	Récupère la liste d’images qu’un contrôle de barre d’outils utilise pour afficher les boutons chauds.
TB_GETHOTITEM	Récupère l’index de l’élément chaud dans une barre d’outils.
TB_GETIDEALSIZE	Obtient la taille idéale de la barre d’outils.
TB_GETIMAGELIST	Récupère la liste d’images qu’un contrôle de barre d’outils utilise pour afficher les boutons dans leur état par défaut. Un contrôle de barre d’outils utilise cette liste d’images pour afficher les boutons lorsqu’ils ne sont pas activés ou désactivés.
TB_GETIMAGELISTCOUNT	Obtient le nombre de listes d’images associées à la barre d’outils.
TB_GETINSERTMARK	Récupère la marque d’insertion actuelle pour la barre d’outils.
TB_GETINSERTMARKCOLOR	Récupère la couleur utilisée pour dessiner la marque d’insertion de la barre d’outils.
TB_GETITEMDROPDOWNRECT	Obtient le rectangle englobant de la fenêtre déroulante d’un élément de barre d’outils avec BTNS_DROPDOWN de style.
TB_GETITEMRECT	Récupère le rectangle englobant d’un bouton dans une barre d’outils.
TB_GETMAXSIZE	Récupère la taille totale de tous les boutons et séparateurs visibles dans la barre d’outils.
TB_GETMETRICS	Récupère les métriques d’un contrôle de barre d’outils.
TB_GETOBJECT	Récupère le IDropTarget pour un contrôle de barre d’outils.
TB_GETPADDING	Récupère le remplissage d’un contrôle de barre d’outils.
TB_GETPRESSEDIMAGELIST	Obtient la liste d’images qu’un contrôle de barre d’outils utilise pour afficher les boutons dans un état enfoncé.
TB_GETRECT	Récupère le rectangle englobant pour un bouton de barre d’outils spécifié.
TB_GETROWS	Récupère le nombre de lignes de boutons dans une barre d’outils avec le style TBSTYLE_WRAPABLE .
TB_GETSTATE	Récupère des informations sur l’état du bouton spécifié dans une barre d’outils, par exemple s’il est activé, appuyé ou activé.
TB_GETSTRING	Récupère une chaîne du pool de chaînes d’une barre d’outils.
TB_GETSTYLE	Récupère les styles actuellement utilisés pour un contrôle de barre d’outils.
TB_GETTEXTROWS	Récupère le nombre maximal de lignes de texte pouvant être affichées sur un bouton de barre d’outils.
TB_GETTOOLTIPS	Récupère le handle du contrôle d’info-bulle, le cas échéant, associé à la barre d’outils.
TB_GETUNICODEFORMAT	Récupère l’indicateur de format de caractères Unicode pour le contrôle.
TB_HASACCELERATOR	Destiné à un usage interne ; non recommandé pour une utilisation dans les applications. Récupère le nombre de boutons de barre d’outils qui ont le caractère d’accélérateur spécifié.
TB_HIDEBUTTON	Masque ou affiche le bouton spécifié dans une barre d’outils.
TB_HITTEST	Détermine l’emplacement d’un point dans un contrôle de barre d’outils.
TB_INDETERMINATE	Définit ou efface l’état indéterminé du bouton spécifié dans une barre d’outils.
TB_INSERTBUTTON	Insère un bouton dans une barre d’outils.
TB_INSERTMARKHITTEST	Récupère les informations de marque d’insertion d’un point dans une barre d’outils.
TB_ISBUTTONCHECKED	Détermine si le bouton spécifié dans une barre d’outils est activé.
TB_ISBUTTONENABLED	Détermine si le bouton spécifié dans une barre d’outils est activé.
TB_ISBUTTONHIDDEN	Détermine si le bouton spécifié dans une barre d’outils est masqué.
TB_ISBUTTONHIGHLIGHTED	Vérifie l’état de surbrillance d’un bouton de barre d’outils.
TB_ISBUTTONINDETERMINATE	Détermine si le bouton spécifié dans une barre d’outils est indéterminé.
TB_ISBUTTONPRESSED	Détermine si le bouton spécifié dans une barre d’outils est appuyé.
TB_LOADIMAGES	Charge les images de bouton définies par le système dans la liste d’images d’un contrôle de barre d’outils.
TB_MAPACCELERATOR	Détermine l’ID du bouton qui correspond au caractère d’accélérateur spécifié.
TB_MARKBUTTON	Définit l’état de surbrillance d’un bouton donné dans un contrôle de barre d’outils.
TB_MOVEBUTTON	Déplace un bouton d’un index à un autre.
TB_PRESSBUTTON	Appuie ou relâche le bouton spécifié dans une barre d’outils.
TB_REPLACEBITMAP	Remplace une bitmap existante par une nouvelle bitmap.
TB_SAVERESTORE	Envoyez ce message pour lancer l’enregistrement ou la restauration d’un état de barre d’outils.
TB_SETANCHORHIGHLIGHT	Définit le paramètre de surbrillance d’ancre pour une barre d’outils.
TB_SETBITMAPSIZE	Définit la taille des images bitmap à ajouter à une barre d’outils.
TB_SETBOUNDINGSIZE	Destiné à un usage interne ; non recommandé pour une utilisation dans les applications. Définit la taille englobante d’un contrôle de barre d’outils à plusieurs colonnes.
TB_SETBUTTONINFO	Définit les informations d’un bouton existant dans une barre d’outils.
TB_SETBUTTONSIZE	Définit la taille des boutons d’une barre d’outils.
TB_SETBUTTONWIDTH	Définit les largeurs de bouton minimales et maximales dans le contrôle de barre d’outils.
TB_SETCMDID	Définit l’identificateur de commande d’un bouton de barre d’outils.
TB_SETCOLORSCHEME	Définit les informations de jeu de couleurs pour le contrôle de barre d’outils.
TB_SETDISABLEDIMAGELIST	Définit la liste d’images que le contrôle de barre d’outils utilisera pour afficher les boutons désactivés.
TB_SETDRAWTEXTFLAGS	Définit les indicateurs de dessin de texte pour la barre d’outils.
TB_SETEXTENDEDSTYLE	Définit les styles étendus d’un contrôle de barre d’outils.
TB_SETHOTIMAGELIST	Définit la liste d’images que le contrôle de barre d’outils utilisera pour afficher les boutons dynamiques.
TB_SETHOTITEM	Définit l’élément actif dans une barre d’outils.
TB_SETHOTITEM2	Définit l’élément actif dans une barre d’outils.
TB_SETIMAGELIST	Définit la liste d’images que la barre d’outils utilise pour afficher les boutons qui sont dans leur état par défaut.
TB_SETINDENT	Définit la mise en retrait du premier bouton dans un contrôle de barre d’outils.
TB_SETINSERTMARK	Définit la marque d’insertion actuelle pour la barre d’outils.
TB_SETINSERTMARKCOLOR	Définit la couleur utilisée pour dessiner la marque d’insertion de la barre d’outils.
TB_SETLISTGAP	Définit la distance entre les boutons de la barre d’outils d’une barre d’outils spécifique.
TB_SETMAXTEXTROWS	Définit le nombre maximal de lignes de texte affichées sur un bouton de barre d’outils.
TB_SETMETRICS	Définit les métriques d’un contrôle de barre d’outils.
TB_SETPADDING	Définit le remplissage d’un contrôle de barre d’outils.
TB_SETPARENT	Définit la fenêtre à laquelle le contrôle de barre d’outils envoie des codes de notification.
TB_SETPRESSEDIMAGELIST	Définit la liste d’images que la barre d’outils utilise pour afficher les boutons dans un état appuyé.
TB_SETROWS	Définit le nombre de lignes de boutons dans une barre d’outils.
TB_SETSTATE	Définit l’état du bouton spécifié dans une barre d’outils.
TB_SETSTYLE	Définit le style d’un contrôle de barre d’outils.
TB_SETTOOLTIPS	Associe un contrôle d’info-bulle à une barre d’outils.
TB_SETUNICODEFORMAT	Définit l’indicateur de format de caractères Unicode pour le contrôle. Ce message vous permet de modifier le jeu de caractères utilisé par le contrôle au moment de l’exécution plutôt que d’avoir à recréer le contrôle.
TB_SETWINDOWTHEME	Définit le style visuel d’un contrôle de barre d’outils.
TB_TRANSLATEACCELERATOR	Transmet un message clavier à la barre d’outils.

Notifications

Rubrique	Contenu
NM_CHAR (barre d’outils)	Envoyé par la barre d’outils lorsqu’il reçoit un message WM_CHAR . Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
NM_CLICK (barre d’outils)	Envoyé par un contrôle de barre d’outils lorsque l’utilisateur clique sur un élément avec le bouton gauche de la souris. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
NM_CUSTOMDRAW (barre d’outils)	Envoyé par la barre d’outils pour informer sa fenêtre parente des opérations de dessin. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
NM_DBLCLK (barre d’outils)	Avertit la fenêtre parente d’un contrôle de barre d’outils que l’utilisateur a double-cliqué sur le bouton gauche de la souris dans le contrôle. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
NM_KEYDOWN (barre d’outils)	Envoyé par un contrôle lorsque le contrôle a le focus clavier et que l’utilisateur appuie sur une touche. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
NM_LDOWN	Avertit la fenêtre parente d’une barre d’outils que vous avez appuyé sur le bouton gauche de la souris. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
NM_RCLICK (barre d’outils)	Envoyé par un contrôle de barre d’outils lorsque l’utilisateur clique sur la barre d’outils avec le bouton droit de la souris. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
NM_RDBLCLK (barre d’outils)	Avertit la fenêtre parente d’un contrôle que l’utilisateur a double-cliqué sur le bouton droit de la souris dans le contrôle. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
NM_RELEASEDCAPTURE (barre d’outils)	Avertit la fenêtre parente d’un contrôle de barre d’outils que le contrôle libère la capture de la souris. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
NM_TOOLTIPSCREATED (barre d’outils)	Avertit la fenêtre parente d’une barre d’outils que la barre d’outils a créé un contrôle d’info-bulle. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_BEGINADJUST	Avertit la fenêtre parente d’une barre d’outils que l’utilisateur a commencé à personnaliser une barre d’outils. Ce code de message est envoyé sous la forme d’un message WM_NOTIFY .
TBN_BEGINDRAG	Avertit la fenêtre parente d’une barre d’outils que l’utilisateur a commencé à faire glisser un bouton dans une barre d’outils. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_CUSTHELP	Avertit la fenêtre parente d’une barre d’outils que l’utilisateur a choisi le bouton Aide dans la boîte de dialogue Personnaliser la barre d’outils. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_DELETINGBUTTON	Envoyé par un contrôle de barre d’outils lorsqu’un bouton est sur le point d’être supprimé.
TBN_DRAGOUT	Envoyé par un contrôle de barre d’outils lorsque l’utilisateur clique sur un bouton, puis déplace le curseur hors du bouton. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_DRAGOVER	Détermine si un message TB_MARKBUTTON doit être envoyé pour un bouton qui est déplacé. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_DROPDOWN	Envoyé par un contrôle de barre d’outils lorsque l’utilisateur clique sur un bouton déroulant. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_DUPACCELERATOR	Détermine si une touche d’accélérateur peut être utilisée sur au moins deux barres d’outils actives. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_ENDADJUST	Avertit la fenêtre parente d’une barre d’outils que l’utilisateur a cessé de personnaliser une barre d’outils. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_ENDDRAG	Avertit la fenêtre parente de la barre d’outils que l’utilisateur a cessé de faire glisser un bouton dans une barre d’outils. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_GETBUTTONINFO	Récupère les informations de personnalisation de la barre d’outils et notifie la fenêtre parente de la barre d’outils de toute modification apportée à la barre d’outils. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_GETDISPINFO	Récupère les informations d’affichage d’un élément de barre d’outils. Cette notification est envoyée sous la forme d’un message WM_NOTIFY .
TBN_GETINFOTIP	Récupère les informations d’info-bulle pour un élément de barre d’outils. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_GETOBJECT	Envoyé par un contrôle de barre d’outils qui utilise le style TBSTYLE_REGISTERDROP pour demander un objet cible de déplacement lorsque le pointeur passe sur l’un de ses boutons. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_HOTITEMCHANGE	Envoyé par un contrôle de barre d’outils lorsque l’élément chaud (mis en surbrillance) change. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_INITCUSTOMIZE	Avertit la fenêtre parente d’une barre d’outils que la personnalisation a démarré. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_MAPACCELERATOR	Demande l’index du bouton dans la barre d’outils correspondant au caractère d’accélérateur spécifié. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_QUERYDELETE	Avertit la fenêtre parente de la barre d’outils si un bouton peut être supprimé d’une barre d’outils pendant que l’utilisateur personnalise la barre d’outils. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_QUERYINSERT	Indique à la fenêtre parente de la barre d’outils si un bouton peut être inséré à gauche du bouton spécifié pendant que l’utilisateur personnalise une barre d’outils. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_RESET	Avertit la fenêtre parente de la barre d’outils que l’utilisateur a réinitialisé le contenu de la boîte de dialogue Personnaliser la barre d’outils. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_RESTORE	Avertit la fenêtre parente d’une barre d’outils qu’une barre d’outils est en cours de restauration. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_SAVE	Avertit la fenêtre parente d’une barre d’outils qu’une barre d’outils est en cours d’enregistrement. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_TOOLBARCHANGE	Avertit la fenêtre parente de la barre d’outils que l’utilisateur a personnalisé une barre d’outils. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_WRAPACCELERATOR	Demande l’index du bouton dans une ou plusieurs barres d’outils correspondant au caractère d’accélérateur spécifié. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
TBN_WRAPHOTITEM	Avertit une application avec deux barres d’outils ou plus que l’élément chaud est sur le point de changer. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .

Structures

Rubrique	Contenu
COLORMAP	Contient les informations utilisées par la fonction CreateMappedBitmap pour mapper les couleurs de l’image bitmap.
NMTBCUSTOMDRAW	Contient des informations spécifiques à un code de notification NM_CUSTOMDRAW envoyé par un contrôle de barre d’outils.
NMTBDISPINFO	Contient et reçoit des informations d’affichage pour un élément de barre d’outils. Cette structure est utilisée avec le code de notification TBN_GETDISPINFO .
NMTBGETINFOTIP	Contient et reçoit des informations d’info-bulle pour un élément de barre d’outils. Cette structure est utilisée avec le code de notification TBN_GETINFOTIP .
NMTBHOTITEM	Contient les informations utilisées avec le code de notification TBN_HOTITEMCHANGE .
NMTBRESTORE	Permet aux applications d’extraire les informations qui ont été placées dans NMTBSAVE lorsque l’état de la barre d’outils a été enregistré. Cette structure est transmise aux applications lorsqu’elles reçoivent un code de notification TBN_RESTORE .
NMTBSAVE	Cette structure est transmise aux applications lorsqu’elles reçoivent un code de notification TBN_SAVE . Il contient des informations sur le bouton en cours d’enregistrement. Les applications peuvent modifier les valeurs des membres pour enregistrer des informations supplémentaires.
NMTOOLBAR	Contient les informations utilisées pour traiter les codes de notification de la barre d’outils. Cette structure remplace la structure TBNOTIFY .
TBADDBITMAP	Ajoute une bitmap qui contient des images de bouton à une barre d’outils.
TBBUTTON	Contient des informations sur un bouton dans une barre d’outils.
TBBUTTONINFO	Contient ou reçoit des informations pour un bouton spécifique dans une barre d’outils.
TBINSERTMARK	Contient des informations sur la marque d’insertion dans un contrôle de barre d’outils.
TBMETRICS	Définit les métriques d’une barre d’outils utilisées pour réduire ou développer des éléments de barre d’outils.
TBREPLACEBITMAP	Utilisé avec le message TB_REPLACEBITMAP pour remplacer une bitmap de barre d’outils par une autre.
TBSAVEPARAMS	Spécifie l’emplacement dans le Registre où le message TB_SAVERESTORE stocke et récupère des informations sur l’état d’une barre d’outils.

Constantes

Rubrique	Contenu
États du bouton de barre d’outils	Cette section répertorie les états qu’un bouton de barre d’outils peut avoir.
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 indiqué par l’utilisation du style TBSTYLE_FLAT ou TBSTYLE_TRANSPARENT . Remarque : Comctl32.dll version 6 n’est pas redistribuable, mais elle est incluse dans Windows ou une version ultérieure. Pour utiliser Comctl32.dll version 6, spécifiez-la dans un manifeste. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.
Styles étendus de barre d’outils	Cette section répertorie les styles étendus pris en charge par les contrôles de barre d’outils.
Valeurs d’index d’image de bouton standard de la barre d’outils	Cette section spécifie les valeurs d’index des images dans des bitmaps standard.