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 [仅限桌面应用] |
| 标头 |
|