Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This message loads bitmaps into a toolbar control's image list.

Syntax 

TB_LOADIMAGES 
wParam = (WPARAM)(INT) 
iBitmapID;

lParam = (LPARAM)(HINSTANCE) 
hinst;

Parameters

iBitmapID

Identifier of a bitmap that contains the images to be loaded. If hinstis HINST_COMMCTRL, this parameter specifies a set of standard toolbar button bitmaps, shown in the following list. Otherwise, this parameter must be the identifier of a bitmap resource that will be added to the image list as a single image.

Value Description

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
hinst

Program instance handle to the calling application. This parameter can be HINST_COMMCTRL to load a standard image list.

Return Value

Returns an INTvalue that represents the count of images in the image list, not including the one just added. Returns zero if the toolbar has no image list or if the existing image list is empty.

Remarks

If your application specifies HINST_COMMCTRL, then you must use the proper image index values when you prepare TBBUTTONstructures 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.

Windows Embedded CE does not support IDB_HIST_LARGE_COLOR and IDB_HIST_SMALL_COLOR values for the iBitmapIDparameter.

Requirements

Header commctrl.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also