GET LIST PROPERTIES

version 6.7 (Modified)

GET LIST PROPERTIES (list; appearance{; icon{; lineHeight{; doubleClick}}})

Parameter	Type		Description
list	ListRef		List reference number
appearance	Number		Graphical style of the list
			1  Hierarchical list ala Macintosh
			2  Hierarchical list ala Windows
icon	Number		'cicn' MacOS-based resource ID
lineHeight	Number		Minimal line height expressed in pixels
doubleClick	Longint		Expand/Collapse sublist on double-click?
			0 = Yes, 1= No

The command GET LIST PROPERTIES returns information about the list whose reference number you pass in list.

The parameter appearance returns the graphical style of the list.

The parameter icon returns the resource IDs of the node icons displayed in the list.

The parameter lineHeight returns the minimal line height.

If doubleClick is set to 1, double-clicking on a parent list item does not provoke its child list to expand or to collapse. If doubleClick is set to 0, this behavior is active (defaut value).

These properties can be set using the command SET LIST PROPERTIES and/or in the Design environment List Editor, if the list was created there or saved using the command SAVE LIST.

For a complete description of the appearance, node icons, minimal line height and double-click management of a list, see the command SET LIST PROPERTIES.

Given the list named hList, shown here in the User environment (in Macintosh appearance):

The object method for a button:

      ` bMacOrWin button Object Method
   GET LIST PROPERTIES(hList;$vlAppearance;$vlIcon;$vlLH)
   If ($vlAppearance=Ala Macintosh)
      $vlAppearance:=Ala Windows
      $vlIcon:=Windows node
      $vlLH:=20
   Else 
      $vlAppearance:=Ala Macintosh
      $vlIcon:=Macintosh node
        $vlLH:=0
   End if 
   SET LIST PROPERTIES(hList;$vlAppearance;$vlIcon;$vlLH)
   REDRAW LIST(hList) ` Do NOT forget to call REDRAW LIST otherwise the list won't be updated

will alternately display the list as shown above and here (in Windows appearance):

SET LIST PROPERTIES.