TB_ADDBUTTONS message

Article
06/13/2023

Ajoute un ou plusieurs boutons à une barre d’outils.

Paramètres

wParam: Nombre de boutons à ajouter.
lParam: Pointeur vers un tableau de structures TBBUTTON qui contiennent des informations sur les boutons à ajouter. Il doit y avoir le même nombre d’éléments dans le tableau que les boutons spécifiés par wParam.

Valeur retournée

Retourne TRUE en cas de réussite, ou FALSE dans le cas contraire.

Notes

Si la barre d’outils a été créée à l’aide de la fonction CreateWindowEx , vous devez envoyer le message TB_BUTTONSTRUCTSIZE à la barre d’outils avant d’envoyer TB_ADDBUTTONS.

Consultez TB_SETIMAGELIST pour savoir comment affecter des bitmaps aux boutons de barre d’outils à partir d’une ou plusieurs listes d’images.

Exemples

L’exemple de code suivant ajoute trois boutons à une barre d’outils, à l’aide de la bitmap système standard pour les boutons d’affichage. Le message TB_ADDBITMAP retourne l’index de la première image de bouton dans la liste d’images. Les images individuelles sont identifiées par leurs décalages par rapport à cette valeur.

TBADDBITMAP tbAddBitmap;
tbAddBitmap.hInst = HINST_COMMCTRL;
tbAddBitmap.nID = IDB_VIEW_SMALL_COLOR;

// There are 12 items in IDB_VIEW_SMALL_COLOR.  However, because this is a standard
// system-defined bitmap, the wParam (nButtons) is ignored.
//
// hWndToolbar is the handle of the toolbar window.
//
// Do not forget to send TB_BUTTONSTRUCTSIZE if the toolbar was created
// by using CreateWindowEx.
//
int stdidx = SendMessage(hWndToolbar, TB_ADDBITMAP, 0, (LPARAM)&tbAddBitmap);

// Define the buttons. 
// IDM_SETLARGEICONVIEW and so on are application-defined command IDs.

const int numButtons = 3;
TBBUTTON tbButtonsAdd[numButtons] = 
{
    {stdidx + VIEW_LARGEICONS, IDM_SETLARGEICONVIEW, TBSTATE_ENABLED, BTNS_BUTTON},
    {stdidx + VIEW_SMALLICONS, IDM_SETSMALLICONVIEW, TBSTATE_ENABLED, BTNS_BUTTON},
    {stdidx + VIEW_DETAILS, IDM_SETDETAILSVIEW, TBSTATE_ENABLED, BTNS_BUTTON}
}; 

// Add the view buttons.
SendMessage(hWndToolbar, TB_ADDBUTTONS, numButtons, (LPARAM)tbButtonsAdd);

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	Commctrl.h
Noms Unicode et ANSI	TB_ADDBUTTONSW (Unicode) et TB_ADDBUTTONSA (ANSI)

Voir aussi

Valeurs d’index d’image de bouton standard de la barre d’outils

Partager via