OBJECT SET PADDING
OBJECT SET PADDING ( * ; object : Text ; padding : Object )
OBJECT SET PADDING ( object : Variable, Field ; padding : Object )
| Parameter | Type | Description | |
|---|---|---|---|
| * | Operator | → | If specified, object is an object name (string) If omitted, object is a variable or field |
| object | Text, Variable, Field | → | Object name (if * is specified) or Variable or field (if * is omitted) |
| padding | Object | → | Padding values |
History
| Release | Changes |
|---|---|
| 21 R5 | Created |
Description
The OBJECT SET PADDING command sets the padding of the object(s) designated by the object and * parameters.
If you pass the optional * parameter, this indicates that the object parameter is an object name (a string). If you do not pass this parameter, this indicates that object is a variable or field. In this case, you pass a variable or field reference instead of a string.
In padding, pass an object containing the following properties:
| Property | Type | Description |
|---|---|---|
top | Integer | Padding between the content and the top border |
bottom | Integer | Padding between the content and the bottom border |
left | Integer | Padding between the content and the left border |
right | Integer | Padding between the content and the right border |
All properties are optional. If a property is omitted, its current value remains unchanged.
Padding values are expressed in pixels. If a negative value is assigned, the effective padding is set to 0.
Padding can be applied to the following types of form objects:
For list boxes, list box columns, and list box headers and footers, the same padding object is used, but only the top and left values are taken into account for rendering:
topis applied as both top and bottom padding,leftis applied as both left and right padding.
Example
var $padding:={top: 20; left: 10}
OBJECT SET PADDING(*; "List box"; $padding)
The top value is applied to the top and bottom padding, while the left value is applied to the left and right padding.
See also
OBJECT Get padding
OBJECT Get vertical alignment
OBJECT SET VERTICAL ALIGNMENT
Properties
| Command number | 1865 |
| Thread safe | no |