Topic: APLX Help : System Classes : Properties : list
[ Previous | Next | Contents | Index | APL Home ]

www.microapl.co.uk

The 'list' property


A character vector or matrix, or a nested matrix for a Tree

Valid for: List, Combo, Tree

List and Combo

The list property specifies the list of items displayed in a List box or Combo box. You can specify it as either a character matrix or a character vector (with lines delimited by carriage returns). For example, to set the contents of a list box to be the days of the week, you could enter:

    MyWin.List.list←⎕W

When referenced, the list property returns a character matrix.

Tree

For a Tree object, the list property is a matrix of 3, 4 or 5 columns, with one row for each node. (If there is just one node, it can be a vector).

Each row has fields: id depth label [image_indices [state]]:

|→--------------------------------------------------------|
↓     |→-----|   |→------| |→---------------------------| |
| 0 1 |LABEL1|   |1 1 0 0| | |→------------| |→-------| | |
|     ⌊------|   ⌊~------| | |HIGHLIGHTBOLD| |EXPANDED| | |
|                          | ⌊-------------| ⌊--------| | |
|                          ⌊∊---------------------------| |
|     |→-------| |→------| |→------------|                |
| 0 2 |LABEL1_A| |1 1 0 0| |HIGHLIGHTBOLD|                |
|     ⌊--------| ⌊~------| ⌊-------------|                |
|     |→-----|   |→------| |→-------|                     |
| 0 1 |LABEL2|   |1 1 0 0| |EXPANDED|                     |
|     ⌊------|   ⌊~------| ⌊--------|                     |
⌊∊--------------------------------------------------------|

This list is essentially a flattened hierarchy where the level of each node is given by the (relative but dense) 'depth' field. See the description of the Tree object for more details.


Topic: APLX Help : System Classes : Properties : list
[ Previous | Next | Contents | Index | APL Home ]