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:


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.


Dynamic? Yes
Supported in Grid? No
Dependencies: None


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"

Applies To

utree (Tree)

Related Topics