TBADDBITMAP 结构 (commctrl.h)

将包含按钮图像的位图添加到工具栏。

语法

typedef struct tagTBADDBITMAP {
  HINSTANCE hInst;
  UINT_PTR  nID;
} TBADDBITMAP, *LPTBADDBITMAP;

hInst

类型： HINSTANCE

包含包含位图资源的可执行文件的模块实例的句柄。若要使用位图句柄而不是资源 ID，请将此成员设置为 NULL。

可以通过将 HINST_COMMCTRL 指定为 hInst 成员，将以下值之一指定为 nID 成员，将系统定义的按钮位图添加到列表中。

值	含义
IDB_STD_LARGE_COLOR	大型彩色标准位图。
IDB_STD_SMALL_COLOR	小的彩色标准位图。
IDB_VIEW_LARGE_COLOR	小而大的颜色视图位图。
IDB_VIEW_SMALL_COLOR	小颜色视图位图。
IDB_HIST_NORMAL	处于正常状态的 Windows 资源管理器旅行按钮和收藏夹位图。
IDB_HIST_HOT	处于热状态的 Windows 资源管理器旅行按钮和收藏夹位图。
IDB_HIST_DISABLED	处于禁用状态的 Windows 资源管理器旅行按钮和收藏夹位图。
IDB_HIST_PRESSED	处于按下状态的 Windows 资源管理器旅行按钮和收藏夹位图。

nID

类型： UINT_PTR

如果 hInst 为 NULL，请使用按钮图像将此成员设置为位图的位图句柄。否则，请将其设置为带有按钮图像的位图的资源标识符。

如果 nID 持有位图句柄而不是资源 ID，则在将其替换为 TB_REPLACEBITMAP之前，请不要销毁位图。否则，工具栏将被销毁。

定义的值可用作标准位图的索引。有关详细信息，请参阅工具栏标准按钮图像索引值。

TBADDBITMAP 结构与TB_ADDBITMAP消息一起使用。