GET LIST PROPERTIES

version 2004 (Modified)

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

The GET LIST PROPERTIES command 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).

If the multiSelections parameter is set to 0, multiple selections of items (manually or by programming) are not possible in the list. If it is set to 1, multiple selections are allowed.

If the editable parameter is set to 1, the list is editable when it is displayed as a choice list in a record. If it is set to 0, the list is not editable.

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 Application environment:

The object method for a button:

      ` bMacOrWin button Object Method
   GET LIST PROPERTIES(hList;$vlAppearance;$vlIcon;$vlLH;$vlClick;$vlSelect;$vlModif)
   If ($vlAppearance=Ala Macintosh)
      $vlAppearance:=Ala Windows
      $vlIcon:=Windows node
      $vlModif:=1
   Else 
      $vlAppearance:=A la Macintosh
      $vlIcon:=Macintosh node
       $vlModif:=1
   End if 
   SET LIST PROPERTIES(hList;$vlAppearance;$vlIcon;$vlLH;$vlClick;$vlSelect;$vlModif)

This method lets you display the list as follows:

SET LIST PROPERTIES.