Purpose

.ForeColor allows you to specify which colour is applied to the foreground of certain objects.
 

Syntax

Setting:         ObjectReference.ForeColor = Value

Retrieving:      Variable = ObjectReference.ForeColor
 

Operation

ObjectReference is the Tag Name of the object
Value is a RGB triplet string or a string holding a colour name (see Color Values)
Variable is an alphanumeric variable
 

Remarks

Logical colour names are defined in the Application Definitions File.

The colour value retrieved is always the same as the value set, irrespective of any colour mapping done by the operating system or display subsystem.
 

Examples

To set the .ForeColor property of a text string (Tag Name = CustomerNamePrompt) to green:

CustomerNamePrompt.FORECOLOR = "GREEN" or:

CustomerNamePrompt.FORECOLOR = "0,255,0"  or:

$GREEN = "GREEN"
CustomerNamePrompt.FORECOLOR = $GREEN


To set the .ForeColor for the Visa Radio Button label to the logical name "RED".  (The Windows Client is at liberty to map this to another colour through a colour mapping specified in the Application Definitions File):

CreditCardGroup.Button(VisaButton).ForeColor = "RED"


To retrieve the .ForeColor from the same Visa Radio Button label into the contents of $VISALABELCOLOR.  (The value should be the string "RED"):

$VISALABELCOLOR = CreditCardGroup.Button(VisaButton).ForeColor