focusForeColor

Type: Integer

Availability: Read or write at any time

The focusForeColor property of the Control class contains the foreground color used to display text associated with a control when the control has focus or a child of the control has focus. You can use the focusForeColor and focusBackColor 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 focusForeColor property is not Black, that property value is used instead of the value of the foreColor property to draw the text associated with the control 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 focusForeColor 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 focusForeColor 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 focusForeColor property of the control is Black (0)

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

2016.0.01 and higher