TB_ADDBITMAP message

Ajoute une ou plusieurs images à la liste des images de bouton disponibles pour une barre d’outils.

Paramètres

wParam

Nombre d’images de bouton dans la bitmap. Si lParam spécifie une bitmap définie par le système, ce paramètre est ignoré.

lParam

Pointeur vers une structure TBADDBITMAP qui contient l’identificateur d’une ressource bitmap et le handle vers le module instance avec le fichier exécutable qui contient la ressource bitmap.

Valeur retournée

Retourne l’index de la première nouvelle image en cas de réussite, ou -1 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_ADDBITMAP.

Exemples

L’exemple suivant crée une bitmap à partir d’une ressource (IDB_BITMAP1), mappe la couleur d’arrière-plan (noir dans ce cas) à la couleur du visage du bouton système et l’ajoute à la barre d’outils.

DWORD backgroundColor = GetSysColor(COLOR_BTNFACE);
COLORMAP colorMap;
colorMap.from = RGB(0, 0, 0);
colorMap.to = backgroundColor;
HBITMAP hbm = CreateMappedBitmap(g_hInst, IDB_BITMAP1, 0, &colorMap, 1);
TBADDBITMAP tb;
tb.hInst = NULL;
tb.nID = (UINT_PTR)hbm;

// hWndToolbar is the window handle of the toolbar.
// Do not forget to send TB_BUTTONSTRUCTSIZE if the toolbar was 
// created by using CreateWindowEx.
int index = SendMessage (hWndToolbar, TB_ADDBITMAP, 0, (LPARAM)&tb);

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