TO _ 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 l’image bitmap. Si lParam spécifie une image 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 l’instance de module avec le fichier exécutable qui contient la ressource bitmap.

Valeur de retour

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 to _ BUTTONSTRUCTSIZE à la barre d’outils avant d’envoyer to _ ADDBITMAP.

Exemples

L’exemple suivant crée une image bitmap à partir d’une ressource (IDB _ bitmap1), mappe la couleur d’arrière-plan (noir dans ce cas) à la couleur de la face 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 [Applications de bureau Vista uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
En-tête
Commctrl. h