BKM SETTABBITMAP

This message associates a bit-map handle with the specified page.

Syntax

param1
ULONG ulPageId;  /* Page ID. */

param2
HBITMAP hbm;     /* Bit-map handle. */

Parameters

ulPageId (ULONG) - Input: The page identifier with which to associate the bit-map handle. This should be a page for which a BKA_MAJOR or BKA_MINOR attribute has been specified.
hbm (HBITMAP) - Input: Bit-map handle.

Returns

rc (BOOL) - returns

Success indicator:

TRUE: Tab bit map was successfully set.

FALSE: Unable to set tab bit map. If the page ID specified in the ulPageId parameter is invalid or if it identifies a page that does not have a BKA_MAJOR or BKA_MINOR attribute, FALSE is returned and no bit map is associated with the page.

Remarks

If this message is sent for a page having both major and minor tab attributes, the notebook sets both the major and minor tab bit maps.

When displayed, the bit map is stretched to fit the size of the tab. If a tab has rounded or polygonal edges, the bit map is sized to fit the rectangular area of the tab.

Default Processing

The default window procedure does not expect to receive this message and therefore takes no action on it other than to return FALSE.