Formats
Uniface list of properties that define the appearance of columns in the Details style of the list view of the tree widget.
"Formats=ColumnFormat1
{!ColumnFormat2{!...ColumnFormatn}}"
where ColumnFormat is:
SortValue{DecimalIndicatorAlignment{ColumnWidth}}
| Value | Description |
|---|---|
| SortValue | Sort order of the column; For more information, see Sorting. |
| DecimalIndicator | Character to be used for the decimal place indicator for numeric fields in the tree column. For more information, see Decimal Indicator. |
| Alignment | Alignment of column's label text; values
can be L (Left), R (Right), or C (Center). |
| ColumnWidth | Width, in character cells, of the selected column. Value must be an integer greater than or equal to 0. If omitted, the width is unchanged. If zero, the width is determined by the width of the column label. |
Usage
| Dynamic? | Yes |
| Supported in Grid? | No |
| Dependencies: | None |
Description
The Formats property for the tree widget combines some of the properties represented in the Define Columns of List View dialog box. This property formats the appearance of columns in the Details style of the list view of the tree widget.
Use this property to dynamically specify the sort
order, alignment, and width of a column. Separate items in the string using GOLD !
(!).
Tip: To dynamically set the column headers (labels), use the Labels property. For more information, see Labels.
Using in ProcScript
You can use $properties or $fieldproperties to set or get the property and its value. For more information, see $properties and $fieldproperties.
The following example formats the first three columns of the List View of the tree TREEFLD as follows:
- Sort data in the first column alphabetically, aligned left, width 30 characters.
- Sort data in the second column numerically, aligned right, width 10 characters.
- Sort data in the third column by tree item type, leaving all other format settings unchanged.
$properties(TREE_FLD) = "formats=CL30!NR10!I"
