| Applies To: | ListView |
Description
This property specifies item groupings for a ListView object.
Note that this feature only applies if Native Look and Feel is enabled.
ItemGroups is a nested scalar or nested vector each of whose elements specifies a grouping. Each grouping is a 5-element vector as follows:
| [1] | Group caption | character vector |
| [2] | Item index | Vector of indices to the Items property that specifies which Items are in this grouping. |
| [3] | Caption alignment | an integer: 1 = left aligned caption (the default) 2 = centre aligned caption 4 = right-aligned caption |
| [4] | State | Integer (not yet implemented) |
| [5] | Footer text | character vector (not yet implemented) |
Note that State and Footer text are not yet implemented by Windows.
For example, the following expressions executed in the WTUTOR95 workspace will result in the display shown below.
'F'⎕WC'Form' 'ListView Object'
II←⍳⍴COUNTRIES
'F.L'⎕WC'ListView'COUNTRIES(0 0)(100 100)
('ImageList' 'F.I1')
('ImageIndex' (⍳⍴COUNTRIES))
'F.I1'⎕WC'ImageList'('Size' 32 32)
(⊂'F.I1.')⎕WC¨(⊂'Icon' ''),¨↓⍉↑FLAGBITS FLAGCMAP FLAGMASK
GROUPS←⊂'Europe'(11 4 5 6 7 8 9)
GROUPS,←⊂'Americas'(12 3 2)
GROUPS,←⊂'Rest of the World'(1 10)
F.L.ItemGroups←GROUPS
You can control the appearance of the groupings using the ItemGroupMetrics property.