SET LIST ITEM PROPERTIES

version 6.0

SET LIST ITEM PROPERTIES (list; itemRef; enterable; styles; icon)

Parameter	Type		Description
list	ListRef		List reference number
itemRef	Number		Item reference number, or
			0 for last item appended to the list
enterable	Boolean		TRUE = Enterable, FALSE = Non-enterable
styles	Number		Font style for the item
icon	Number		'cicn' MacOS-based resource ID, or
			65536 + 'PICT' MacOS-based resource ID, or
			131072 + Picture Reference Number

The command SET LIST ITEM PROPERTIES modifies the item whose item reference number is passed in itemRef within the list whose reference number is passed in list.

If there is no item with the item reference number that is passed, the command does nothing. You can optionally pass 0 in itemRef to modify the last item added to the list using APPEND TO LIST.

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 thecommand APPEND TO LIST.

Note: To change the text of the item or its sublist, use the command SET LIST ITEM.

To make an item enterable, pass TRUE in enterable; otherwise, pass FALSE.

Important: In order for an item to be enterable, it must belong to a list that is enterable. To make a whole list enterable, use the SET ENTERABLE command. To make an individual list item enterable, use SET LIST ITEM PROPERTIES. Changing the enterable property at the list level does not affect the enterable properties of the items. However, an item can be enterable only if its list is enterable.

You specify the font style of the item in the styles parameter. You pass a combination (one or a sum) of the following predefined constants:

Note: On Windows, only the styles Plain or a combination of Bold, Italic, and Underline are available.

To associate an icon to the item, pass one of the following numeric values:

• N, where N is the resource ID of MacOS-based 'cicn' resource

• Use PICT resource+N, where N is the the resource ID of a MacOS-based 'PICT' resource

• Use PicRef+N, where N is the reference number of a Picture from the Design environment Picture Library

Pass zero (0), if you do not want any graphic for the item.

Note: Use PICT resource and Use PicRef are predefined constants provided by 4D.

See the example for the command APPEND TO LIST.

GET LIST ITEM PROPERTIES, SET LIST ITEM.