focusBackColor

Type: Integer

Availability: Read or write at any time

The focusBackColor property of the Control class contains the background color of a control when the control has focus or a child of the control has focus. You can use the focusBackColor and focusForeColor properties to give the user a better visual prompt as to which control has focus.

The default value of zero (Black) indicates that the property is always ignored when drawing the control.

JADE uses the RGB scheme for colors. The valid range for a normal RGB color is zero (0) through 16,777,215 (#FFFFFF). The high byte of a number in this range equals 0; the lower three bytes (from least to most significant byte) determine the amount of red, green, and blue, respectively. The red, green, and blue components are each represented by a number in the range 0 through 255 (#FF). If the high byte is 128, JADE uses the system colors, as defined in the Control Panel of the user. To determine the Integer value of a color from the RGB values:

int:= RedValue + (GreenValue * 256) + (BlueValue * 256 * 256);

When the value of the focusBackColor property is not Black, that property value is used instead of the value of the backColor property to erase the control area when the control has focus or a child of the control has focus.

Although this property is defined in the Control class, it is not relevant to all controls. The controls that make use of this property must be capable of gaining the focus, they can be control parents, and they cannot be external controls such as .NET controls.

The controls that use the focusBackColor property and support definition in the JADE Painter are:

• BaseControl

• Button

• CheckBox

• ComboBox

• Folder

• Frame

• GroupBox

• Sheet

• ListBox

• OptionButton

• Picture

• StatusLine

• Table

• TextBox

• JadeMask

• JadeDockBar

• JadeDockContainer

• JadeEditMask

• JadeRichText.

In addition, the focusBackColor property is defined in the JadeSkinControl class so that you can specify it as part of a control skin on the Jade Skin Maintenance dialog. When a skin is assigned to a control that uses this property, the value is used when the control has focus or a child of the control has focus if all of the following are true.

• The value is not Black (0)

• The value of the equivalent focusBackColor property of the control is Black (0)

• The equivalent backColor value of the control is the default for the control

2016.0.01 and higher