CFrameWnd::AddBitmap

This method adds one or more images to the list of button images available for use in the command bar.

At a Glance

Header file:	Afxwin.h
Platforms:	H/PC 2.0, Palm-size PC, H/PC Pro
Windows CE versions:	1.0 and later

Syntax

BOOL AddBitmap( int nToolbarBitmapID, int nNImages );

Parameters

nToolbarBitmapID

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

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 indicates success. FALSE indicates failure.

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 will not be displayed in color on Windows CE 1.0 platforms.

This method of the CFrameWnd class is unique to Windows CE.