TB_LOADIMAGES message

Article
12/11/2020

Loads system-defined button images into a toolbar control's image list.

Parameters

wParam

Identifier of a system-defined button image list. This parameter can be set to one of the following values.

Value	Meaning
IDB_HIST_LARGE_COLOR	Windows Explorer bitmaps in large size.
IDB_HIST_SMALL_COLOR	Windows Explorer bitmaps in small size.
IDB_STD_LARGE_COLOR	Standard bitmaps in large size.
IDB_STD_SMALL_COLOR	Standard bitmaps in small size.
IDB_VIEW_LARGE_COLOR	View bitmaps in large size.
IDB_VIEW_SMALL_COLOR	View bitmaps in small size.
IDB_HIST_NORMAL	Windows Explorer travel buttons and favorites bitmaps in normal state.
IDB_HIST_HOT	Windows Explorer travel buttons and favorites bitmaps in hot state.
IDB_HIST_DISABLED	Windows Explorer travel buttons and favorites bitmaps in disabled state.
IDB_HIST_PRESSED	Windows Explorer travel buttons and favorites bitmaps in pressed state.

lParam

Instance handle. This parameter must be set to HINST_COMMCTRL.

Return value

The count of images in the image list. Returns zero if the toolbar has no image list or if the existing image list is empty.

Remarks

You must use the proper image index values when you prepare TBBUTTON structures prior to sending the TB_ADDBUTTONS message. For a list of image index values for these preset bitmaps, see Toolbar Standard Button Image Index Values.

Examples

The following sample code loads the system standard small color images.

// hWndToobar is the window handle of the toolbar control.
SendMessage(hWndToolbar, TB_LOADIMAGES, (WPARAM)IDB_STD_SMALL_COLOR, (LPARAM)HINST_COMMCTRL);

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	Commctrl.h