Partager via


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.