Поделиться через


TB_ADDBITMAP сообщение

Добавляет одно или несколько изображений в список изображений кнопок, доступных для панели инструментов.

Параметры

wParam

Количество изображений кнопок на растровом рисунке. Если lParam задает системное растровое изображение, этот параметр игнорируется.

lParam

Указатель на структуру TBADDBITMAP , содержащую идентификатор ресурса растрового изображения, и дескриптор экземпляра модуля с исполняемым файлом, содержащим ресурс растрового изображения.

Возвращаемое значение

Возвращает индекс первого нового образа в случае успешного выполнения или значение -1 в противном случае.

Комментарии

Если панель инструментов была создана с помощью функции CreateWindowEx , необходимо отправить сообщение TB_BUTTONSTRUCTSIZE на панель инструментов перед отправкой TB_ADDBITMAP.

Примеры

В следующем примере создается растровое изображение из ресурса (IDB_BITMAP1), сопоставляется цвет фона (в данном случае черный) с цветом лица системной кнопки и добавляется на панель инструментов.

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);

Требования

Требование Значение
Минимальная версия клиента
Windows Vista [только классические приложения]
Минимальная версия сервера
Windows Server 2003 [только классические приложения]
Заголовок
Commctrl.h