SetItem Method (TREEVIEW)

PLBCMP GUI Only

The SetItem method changes the information stored for an item in a TREEVIEW object. The method uses the following format:

[label]	{object}.SetItem	[GIVING {return}] USING [Item=]{item*}[:
		[Text=]{text}][,[Image=]{image}][:
		[SelImage=]{selimage}][,[Param=]{param}]

Where:

label

object

Required. A TREEVIEW object that is modified.

return

Optional. A Numeric Variable that indicates the success or failure of the method.

item

Required. A decimal number or Numeric Variable that indicates the handle of the item to modify.

text

Optional. A Character String Variable or literal that specifies the new text associated with the item.

image

Optional. A decimal number or Numeric Variable that specifies an IMAGELIST index for normal display.

selimage

Optional. A decimal number or Numeric Variable that specifies an IMAGELIST index to display when selected.

param

Optional. A decimal number or Numeric Variable that specifies a user-defined value.

Flags Affected: EOS, OVER, ZERO

Note the following:

Only the information given in the method is changed.
If the value returned is zero, the ZERO Condition Flag is set.
If {return} is too small to contain result of the method, the OVER Condition Flag is set.
The EOS Condition Flag is always cleared.
Upon completion, {return} will contain the status of the modification as follows. $TRUE and $FALSE are defined in PLBEQU.INC.

For improved performance in the Application Server environment, do not specify the optional return value and parameters unless needed.

See Also: Method Syntax, TREEVIEW Methods