BKM SETTABCOLOR

This message can be sent to a notebook to set the background color of a tab.

Syntax

param1
ULONG ulPageId; /* Page ID. */

param2
ULONG rgbColor; /* Tab color */

Parameters

ulPageId (ULONG) - Input

Page identifier with which to associate the tab color. Specify zero to change all the tabs to a specific color. This parameter is ignored if the BKV_AUTOCOLOR attribute has been specified for the ulPageId parameter.

rgbColor (ULONG) - Input

Color that the tab should be set to. Additionally, the following value may be used:

BKV_AUTOCOLOR: Automatically paint the tabs with a default set of colors.

Returns

rc (BOOL) - returns

Success indicator:

TRUE: Tab color was successfully set.

FALSE: Unable to set tab color. If the page ID specified in the ulPageId parameter is invalid, FALSE is returned and no action is taken.

Remarks

This message works only for notebooks with the style BKS_TABBEDDIALOG. The colors set by BKV_AUTOTABCOLORS are as follows:

0x0055DBFF  0x0080DBAA 0x008092FF  0x00D5B6AA  0x00FFFFAA 0x00AA92AA  0x00FF9255  0x00FFDB55  0x00FFB6AA  0x00FFDBAA

In 16-color mode, or when the Palette Manager is active in 256-color mode, notebooks that are in auto-color mode switch to a set of dithered colors, making sure that the tab text is readable.

The application can change the color of the tab again by sending additional BKM_SETTABCOLOR messages for the specified page.

If the page ID specified in the ulPageId is zero, all the tabs are set to the specified color.

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.