TabColor Property

Gets or sets the background color of the tab button.

object.TabColor = [color]

Where object is an object expression that evaluates to one of the controls in the Applies To list, and color is a value or constant that determines the background color of an object, as described in Settings.

Client support

Newlook Smartclient

Newlook Server

Skin limitations

None. Supported in both Material and Classic skin.

When the material skin is enabled the HoverColor property is ignored. However, if TabColor has been set then the tab button background will render in a shade 95% lighter than the specified color when the user hovers over the control. If TabColor has not been set, the tab button will render in a shade 95% lighter than the primary material color.

Use

This property determines the background color of the specified tab button. Use the BackColor property if you are wishing to specify the background color of the tab page.

Settings

The settings for color can be specified in one of the following ways:

Setting	Description	JScript Example
Hexadecimal colors	A hexadecimal value for Color can be specified by using the either the Themed or Custom color palette (see notes below) or by specifying the hexadecimal value of the color in the following format: `&H00BBGGRR` (where BB = the blue hex value, GG = the green hex value and RR = the red hex value) .	App.Activeform.MyLabel.BackColor = "&H000066FF";
Named colors	Colors specified in the Named tab of the Color palette (see notes below).	App.Activeform.MyLabel.BackColor = "Tomato";
Constant	One of the Newlook color constants. Refer to Color Constants for a full list.	App.Activeform.MyLabel.BackColor = nlClrBlue;

Color Palettes

There are four different color palettes available in Design:

Themed Color Palette

Allows the user to select a color from a series of themed color palettes.

Named Color Palette

Allows the user to select a color from the basic and extended .NET color keywords.

Custom Color Palette

Allows the user to enter specific RGB values, Hex value or select a color from a broader color palette.

Material Color Palette

Allows the user to select a color which is a shade of the current material skin's primary and secondary colors.

Converting color values in scripts and macros

It is possible to specify color values in either the hexadecimal-based &H00BBGGRR format or as a decimal value when setting color-based properties dynamically in a script or macro.

It is important to note though, that macros return colors in the hexadecimal format whereas scripts return colors as a decimal value.

Occasionally you may need to convert from the decimal format to the hexadecimal-based format in order to compare values within a script. To do this you can use the following code in your script:

VB SCRIPT

vHexColor = "&H00" & Hex(App.ActiveForm.BackColor)

JAVASCRIPT

vHexColor = "&H00" + App.ActiveForm.BackColor.toString(16);

Applies To

Tab control