4D Doc Center : SET LIST ITEM FONT

Home

4D v14.3

SET LIST ITEM FONT


SET LIST ITEM FONT ( {* ;} list ; itemRef \| * ; font )

Parameter	Type	Description
*	Operator	If specified, list is an object name (string) If omitted, list is a list reference number
list	ListRef, String	List reference number (if * omitted) or Name of list type object (if * passed)
itemRef \| *	Longint, Operator	Item reference number or 0 for the last item added to the list or * for the current item of the list
font	String, Longint	Font name or number

Description

The SET LIST ITEM FONT command modifies the character font of the item specified by the itemRef parameter of the list whose reference number or object name is passed in list.

If you pass the first optional * parameter, you indicate that the list parameter is an object name (string) corresponding to a representation of the list in the form. If you do not pass this parameter, you indicate that the list parameter is a hierarchical list reference (ListRef). If you only use a single representation of the list or work with structural items (the second * is omitted), you can use either syntax. Conversely, if you use several representations of the same list and work with the current item (the second * is passed), the syntax based on the object name is required since each representation can have its own current item.

You can pass a reference number in itemRef. If this number does not correspond to any item of the list, the command does nothing. You can also pass 0 in itemRef in order to request the modification of the last item added to the list (using APPEND TO LIST).

Lastly, you can pass * in itemRef: in this case, the command will apply to the current item of the list. If several items are selected manually, the current item is the one that was selected last. If no item is selected, the command does nothing.

In the font parameter, pass the name or number of the font to be used. To reapply the default font of the hierarchical list, pass an empty string in font.

Example

Apply the Times font to the current item of the list:

SET LIST ITEM FONT(*;"Mylist";*;"Times")