Purpose

.ShapeProjection allows you to specify the visual level on which certain objects will be displayed.
 

Syntax

Setting:             ObjectReference.ShapeProjection = Value

Retrieving:        Variable = ObjectReference.ShapeProjection
 

Operation

ObjectReference is the Tag Name of the object
Value is one of Raised, Inset or Normal
Variable is an alphanumeric variable
 

Remarks

.ShapeProjection can be applied to lines as well as format boxes and radios group boxes.

.ShapeProjection specifies the level on which the object appears:

Normal makes the object appear to be on the display surface.
Inset makes the object appear to be below the display surface.
Raised makes the object appear to be above the display surface.

When used with property .BoxAppearance equal to Surface, the effect applies to the entire area of the box.  
When used with .BoxAppearance equal to Border, the effect applies only to the outline of the box.

.ShapeProjection is used in conjunction with .BoxAppearance. and .ShapeBold, and there are only certain valid combinations of these which comprise the Box Styles.  If an invalid combination is defined it will be ignored.

The value returned in the retrieving command is in upper case.
 

Example

To set the style of a box to Surface, Raised, Bold for the box (Tag Name = CustomerNameBox):

CustomerNameBox.ShapeProjection = "RAISED"
CustomerNameBox.BoxAppearance = "SURFACE"
CustomerNameBox.ShapeBold = TRUE


To reset the box .ShapeProjection to Inset while .BoxAppearance and .ShapeBold remain the same:

CustomerNameBox.ShapeProjection = "INSET"


To retrieve the value of the .ShapeProjection property from the box:

$CUSTOMERNAMEBOX_ShapeProjection = CustomerNameBox.ShapeProjection