4D v13.4
LISTBOX SET HIERARCHY
- 4D Language Reference
-
- List Box
-
- Managing List Box Objects
- Managing Hierarchical List Boxes
- LISTBOX COLLAPSE
- LISTBOX DELETE COLUMN
- LISTBOX DELETE ROWSUpd
- LISTBOX EXPAND
- LISTBOX GET ARRAYSUpd
- LISTBOX GET CELL POSITION
- LISTBOX Get column formulaNew
- LISTBOX Get column width
- LISTBOX Get footer calculationNew
- LISTBOX Get footers heightNew
- LISTBOX GET GRID COLORSNew
- LISTBOX GET GRIDNew
- LISTBOX Get headers heightNew
- LISTBOX GET HIERARCHY
- LISTBOX Get informationUpd
- LISTBOX Get locked columnsNew
- LISTBOX Get number of columns
- LISTBOX Get number of rows
- LISTBOX GET PRINT INFORMATION
- LISTBOX Get rows heightUpd
- LISTBOX Get static columnsNew
- LISTBOX GET TABLE SOURCEUpd
- LISTBOX INSERT COLUMN FORMULAUpd
- LISTBOX INSERT COLUMNUpd
- LISTBOX INSERT ROWSUpd
- LISTBOX MOVED COLUMN NUMBER
- LISTBOX MOVED ROW NUMBER
- LISTBOX SELECT BREAK
- LISTBOX SELECT ROW
- LISTBOX SET COLUMN FORMULANew
- LISTBOX SET COLUMN WIDTH
- LISTBOX SET FOOTER CALCULATIONNew
- LISTBOX SET FOOTERS HEIGHTNew
- LISTBOX SET GRID
- LISTBOX SET GRID COLOR
- LISTBOX SET HEADERS HEIGHTNew
- LISTBOX SET HIERARCHY
- LISTBOX SET LOCKED COLUMNSNew
- LISTBOX SET ROWS HEIGHTUpd
- LISTBOX SET STATIC COLUMNSNew
- LISTBOX SET TABLE SOURCEUpd
- LISTBOX SORT COLUMNS
LISTBOX SET HIERARCHY
| LISTBOX SET HIERARCHY ( {* ;} object ; hierarchical {; hierarchy} ) | ||||||||
| Parameter | Type | Description | ||||||
| * | Operator |
|
If specified, object is an object name (string) If omitted, object is a variable | |||||
| object | Form object |
|
Object name (if * is specified) or Variable (if * is omitted) | |||||
| hierarchical | Boolean |
|
True = hierarchical list box False = non-hierarchical list box | |||||
| hierarchy | Pointer array |
|
Array of pointers | |||||
The LISTBOX SET HIERARCHY command lets you configure the list box object designated by the object and * parameters in hierarchical or non-hierarchical mode.
Note: This command only functions with list boxes based on arrays. When this command is used with a list box based on selections, it does nothing.
If you pass the optional * parameter, you indicate that the object parameter is an object name (string). If you do not pass this parameter, you indicate that the object parameter is a variable. In this case, you pass a variable reference instead of a string.
The Boolean hierarchical parameter lets you specify the list box mode:
- if you pass True, the list box is displayed in hierarchical mode,
- if you pass False, the list box is displayed in non-hierarchical mode (standard array mode).
When you pass a list box in hierarchical mode, certain properties are automatically restricted. For more information, please refer to the Managing Hierarchical List Boxes section.
The hierarchy parameter is used to designate the arrays of the list box to be used to construct the hierarchy (see example). If you display the list box in hierarchical mode and omit this parameter:
- if the list box is already in hierarchical mode, the command does nothing.
- if the list box is in non-hierarchical mode and has never been declared hierarchical, the first array is used as the hierarchy by default.
- if the list box is in non-hierarchical mode but has previously been declared hierarchical, the last hierarchy is re-established.
Definition of the aCountry, aRegion and aCity arrays as the hierarchy of a list box:
ARRAY POINTER($ArrHierarch;3)
$ArrHierarch{1}:=->aCountry `First break level
$ArrHierarch{2}:=->aRegion `Second break level
$ArrHierarch{3}:=->aCity `Third break level
LISTBOX SET HIERARCHY(*;"mylistbox";True;$ArrHierarch)
Product: 4D
Theme: List Box
Number:
1098
Created: 4D v12
LISTBOX GET HIERARCHY
Managing Hierarchical List Boxes
