Retrieving a Property Value

Purpose

To fetch the value of a property and store in assigned data element

Syntax

Variable = ObjectReference.PropertyName

Operation

ObjectReference is the tag name for the field, format, cycle, session, application, or client object. It cannot be a variable and it is case sensitive.

PropertyName is the predefined name of a property. It cannot be a variable and it is not case sensitive.

Variable is either an alpha or numeric data element, depending on property. The data type must match the data type of the property.

Remarks

Various properties apply to different objects types. Some examples are Forecolor, Backcolor, Aboutbox, and Enable. For more information see the property descriptions and the valid properties for each object type.

Many properties are specified as string values but are stored in an internal format undefined to the user. When retrieving those property values, the internal format is converted back into a string but the string will always be in upper case unless otherwise specified in the property description. Boolean properties are returned as 0 or 1.

Retrieval of colour names is described in Colour Values and the retrieval of font names is covered in Font Names.

Example

$COLOR = CustName.FOREcolor

$NAME = EOD.graphic

$CustForecolor = CustAddress.ForeColor

To copy the property of one object to another object:

CustAddress.ForeColor = ShipAddress.ForeColor

#FONTBOLD = CustAddress.BOLD

IF #FONTBOLD = TRUE

              CustAddress.ITALIC = FALSE

ENDIF