VtListSetItem(VTCL)

VtListSetItem -- set a List item to a specified value

Syntax

VtListSetItem list_widgetName [options]

Sets a List item (indicated by -item or -position) to the value specified by -newItem. To set all items in the List use -itemList.

-item string (C): Sets the item to change.
-itemList list (C): Sets a list of items to change.
-newItem string (NA): Sets the new value to assign to the List item being changed.
-position integer (NA): Specifies the position of an item to change. (The base position is 1. To indicate the last item on the List, use 0.)

INVALID_POSITION: the position value is outside the List range
ITEM_OR_LIST: need to set either -item or -itemList
ITEM_OR_POSITION: need to set either -item or -position
NEED_NEW_ITEM: need to specify a new item (replacement)
NEED_OPTION: no option was specified
NO_FIELD: couldn't find the referenced field
NOT_LIST: referenced widget is not a List
OPTION_COUNT: too many or too few options specified
RECORD_COUNT: number of records specifed exceeds number of available records
Standard errors: See ``Tcl widget creation errors'' in SCO Visual Tcl Programmer's Guide and Reference.