TB_ADDBITMAP消息

  • 项目

将一个或多个图像添加到可用于工具栏的按钮图像列表中。

参数

wParam

位图中按钮图像的数量。 如果 lParam 指定系统定义的位图，则忽略此参数。

lParam

指向 TBADDBITMAP 结构的指针，该结构包含位图资源的标识符，以及包含位图资源的可执行文件的模块实例的句柄。

返回值

如果成功，则返回第一个新图像的索引，否则返回 -1。

备注

如果工具栏是使用 CreateWindowEx 函数创建的，则必须在发送TB_ADDBITMAP之前将TB_BUTTONSTRUCTSIZE消息发送到工具栏。

示例

以下示例从资源 (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