Purpose

.Scale allows you to specify the size, utilizing the GUI height and width function specification, for certain objects.
 

Syntax

Setting:         ObjectReference.Scale = Value

Retrieving:    Variable = ObjectReference.Scale
 

Operation

ObjectReference is the Tag Name of the object
Value is the setting for the property (TRUE or 1 = scalable, FALSE or 0 = not scalable)
Variable is a numeric variable
 

Remarks

Setting scale to TRUE causes the image or text to be scaled to fit the defined size of the object on the screen.  

Icons and Buttons

For icons, the defined size must include space for the label if the alignment is specified as CENTER.

For best results with images, the defined size of the object should be proportional to the size of the image.  Otherwise, the image may be stretched or shrunk more in one direction than the other.
 

Example

To allow the icon object (Tag Name = CustomerActiveIcon) to be displayed as a scalable icon, assuming the GUI height and width are defined:

CustomerActiveIcon.SCALE = 1


To display the Static Text object (Tag Name = CustomerNamePrompt) as normal text, assuming the GUI height, width and large attributes are set in the function source:

CustomerNamePrompt.Scale = FALSE


To retrieve the value of the .Scale property from the icon object (Tag Name = CustomerActiveIcon:

#CustomerActiveIcon_SCALE = CustomerActiveIcon.Scale