version 2004 (Modified)
GET LIST ITEM PROPERTIES (list; itemRef | *; enterable{; styles{; icon{; color}}})
Parameter | Type | Description | |
list | ListRef | List reference number | |
itemRef | * | Longint | * | Item reference number, or | |
0 for last list item added, or | |||
* for the current list item | |||
enterable | Boolean | TRUE = Enterable, FALSE = Non-enterable | |
styles | Number | Font style for the item | |
icon | Number | 'cicn' Mac OS-based resource ID, or | |
65536 + 'PICT' Mac OS-based resource ID, or | |||
131072 + Picture Reference Number | |||
color | Longint | RGB color value |
Description
The GET LIST ITEM PROPERTIES command returns the properties of the item designated by the itemRef parameter within the list whose list reference number is passed in list.
In itemRef, you can pass either a reference number, or the value 0 in order to designate the last item added to the list, or * in order to designate the current item of the list. If several items are selected, the current item is the last one selected.
If you pass * and no item is selected or if there is no item with the item reference number that is passed, the command leaves the parameters unchanged.
If you work with item reference numbers, build a list in which items have unique reference numbers, otherwise you will not be able to distinguish the items. For more information, refer to the description of the command APPEND TO LIST.
After the call:
enterable returns TRUE if the item is enterable.
styles returns the font style of the item.
icon returns the icon or picture assigned to the item, 0 if none.
color returns the color of the text of the item specified.
For details about these properties, see the description of the command SET LIST ITEM PROPERTIES.
See Also
GET LIST ITEM, SET LIST ITEM, SET LIST ITEM PROPERTIES.