The Border class is used to define borders around the perimeters of on-screen objects. The Border is drawn immediately inside an object's rectangle. The border of an object is separate from the three-dimensional look of the object which is governed by the 3D special effect properties.
The Border properties of an object are normally specified through the Display dialog box, but you may use a script to change them in order to visually highlight a special condition.
The Border Class has three properties:
Color (Color is itself a Class Property - see Color)
A fourth property WidthY - may appear in the Property Pick List, but this property is not implemented and should be ignored.
Style determines how the border is drawn, but it will only take effect if WidthX (the line thicknesses of the horizontal and vertical drawing strokes) is greater than 0.
The effect of changing a Border property of an object will not appear until the object is redrawn, either as a result of a user action or through a script that redraws the object.
Type
Number
Details
The number represents a style for the border, depending on the type of object and the width of the border. As long as the border is set to either 0 or 1, the styles for Line objects are as follows:
0 = Solid
1 = Long Dashed
2 = Short Dashed
3 = Alternating dash and dot
4 = Alternating dash and double dot
5 = None
6 = InsideFrame (same as Solid)
Any other positive number gives a line style of none; all negative numbers give a solid line.
For all other objects which use Borders, the styles are:
0 = Solid
1 = Solid
2 = Short Dashed (same as for a Line object)
All other numbers positive or negative give a solid line.
Usually initialized by highlighting the Border option in the in the Display Properties Dialog and then selecting an option from the Line Type picklist, this read/write property indicates the thickness of an object's border.
The effect of changing a Border property of an object will not appear until the object is redrawn, either as a result of a user action or through a script that redraws the object.
Type
Number.
Details
WidthX is the thickness of the border (on all sides). The thickness of a border increases inward, remaining inside the defined rectangle.
The WidthX property of an object's border is designed using the Display dialog box, and fixed after that, but it can be modified through a script to visually highlight a special condition. As with all Event Scripted visual changes to an object, these are run-time changes, and the display properties will return to their original values when the form is closed.
Note that a WidthX value of anything other than 0 or 1 makes the border style solid, no matter what the value for its Style property is.
Example
MyBoxObject.border.Widthx := 40
...which would set an extremely wide border inside the object.