TB_LOADIMAGES (Compact 2013)

3/28/2014

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 hinst is 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 INT value 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 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.

Windows Embedded Compact does not support IDB_HIST_LARGE_COLOR and IDB_HIST_SMALL_COLOR values for the iBitmapID parameter.

Requirements

Header

commctrl.h

See Also

Reference

Toolbar Controls Messages