4D v13.4

GET LIST PROPERTIES

Home

 
4D v13.4
GET LIST PROPERTIES

GET LIST PROPERTIES 


 

GET LIST PROPERTIES ( list ; appearance {; icon {; lineHeight {; doubleClick {; multiSelections {; editable}}}}} ) 
Parameter Type   Description
list  ListRef in List reference number
appearance  Longint in Graphical style of the list 1 = Hierarchical list a la Macintosh 2 = Hierarchical list a la Windows
icon  Longint in ‘cicn’ Mac OS-based resource ID
lineHeight  Longint in Minimal line height expressed in pixels
doubleClick  Longint in Expand/Collapse sublist on double-click? 0 = Yes, 1= No
multiSelections  Longint in Multiple selections: 0 = No, 1 = Yes
editable  Longint in List editable by user: 0 = No, 1 = Yes

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

The appearance parameter returns the graphical style of the list.

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

The lineHeight parameter 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 SET LIST PROPERTIES command and/or in the Design environment List Editor, if the list was created there or saved using the SAVE LIST command.

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

Example  

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:

 
PROPERTIES 

Product: 4D
Theme: Hierarchical Lists
Number: 632

 
INDEX

Alphabetical list of commands

 
HISTORY 

Modified: 4D 2004

 
SEE ALSO 

SET LIST PROPERTIES