ItemGroups Property
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.