CFrameWnd::AddBitmap

Call this member function to add one or more images to the list of button images available for use in the command bar.

Syntax

BOOL AddBitmap( int nToolbarBitmapID, int nNImages );

At a Glance

Header File	Afxwin.h
Platforms
Versions	1.0 and later

Parameters

nToolbarBitmapID

Identifier of the bitmap resource that contains the button images. You may also use system-defined button bitmaps by specifying:

IDB_STD_SMALL_COLOR: Adds small, color standard bitmaps.
IDB_VIEW_SMALL_COLOR: Adds small, color view bitmaps.

nNImages

Number of button images in the bitmap.

Return Value

TRUE if the function succeeds. FALSE if it fails.

Remarks

Each button image should be 16×16 pixels in size.

If you specify the IDB_STD_SMALL_COLOR in the nToolbarBitmapID parameter, you can use the following values as indexes to the system-defined bitmaps.

STD_COPY	STD_PROPERTIES
STD_CUT	STD_REDOW
STD_DELETE	STD_REPLACE
STD_FIND	STD_PASTE
STD_FILENEW	STD_PRINT
STD_FILEOPEN	STD_PRINTPRE
STD_FILESAVE	STD_UNDO
STD_HELP

If you specify the IDB_VIEW_SMALL_COLOR in the nToolbarBitmapID parameter, you can use the following values as indexes to the system-defined bitmaps.

VIEW_DETAILS	VIEW_SORTDATE
VIEW_LARGEICONS	VIEW_SORTNAME
VIEW_LIST	VIEW_SORTSIZE
VIEW_SMALLICONS	VIEW_SORTTYPE

Windows CE 1.0 only supports 2 bits per pixel (2bp) gray scale, so the bitmaps won't be displayed in color on Windows CE 1.0 platforms.

Note This member function of the CFrameWnd class is unique to Windows CE.