BKM QUERYTABBITMAP

This message queries the bit-map handle associated with the specified page.

Syntax

param1
ULONG ulPageId;   /* Page ID. */

param2
ULONG ulReserved; /* Reserved value, should be 0. */

Parameters

ulPageId (ULONG) - Input

Page identifier of the page whose bit-map handle is requested. This should be a page for which a BKA_MAJOR or BKA_MINOR attribute has been specified.

ulReserved (ULONG) - Input

Reserved value, should be 0.

Returns

hbm (HBITMAP) - returns

Handle of the bit map associated with the specified page identifier:

BOOKERR_INVALID_PARAMETERS: An invalid page ID was specified for the ulPageId parameter.

NULLHANDLE: No bit-map handle is associated with the page specified in the ulPageId parameter.

Other: Handle of the bit map associated with the specified page identifier.

Remarks

The tab bit-map handle is set by using the BKM_SETTABBITMAP message.

If this message is sent for a page having both major and minor tab attributes, the notebook returns the bit map associated with the major 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 NULLHANDLE.