VtDrawnListSetItem


Replace the contents of an item in a DrawnList

Syntax

VtDrawnListSetItem drawnlist_widgetName [options]

Description

Replaces the contents of an item in a DrawnList with a new item.

Options

-field column matchStr (NA)
Replaces the item in which item number column matches the string matchStr. For example, if your list contains:
{0 1 "Apple"}
{0 1 "Orange"}  
{0 1 "Kumquat"}

specifying -field 2 "Apple" would match the first item in the list.

-fieldList list (C)
Specifies the new contents of an item. Default formatting is used unless an alternative format is supplied using the -formatList option.

For example:

   -formatList {{ICON 2} {STRING 20} {STRING 15}}  \
   -fieldList  [list 1 "Apple" "Fruit"]

-formatList list (CS)
Describes the columns used in the DrawnList. This field contains a list of column descriptions. Each column description in turn is a list containing the column type, the column width, and the column's left and right margins. The syntax is:
{ type width [left_margin, right_margin] }

The left_margin and right_margin parameters are optional. The following specifies a column that is of type ICON, with a width of 1 icon width and a left_margin and right_margin of 5 pixels:

{ ICON 1 5 5 }

Valid types are ICON, STRING, and DATA. DATA does not display on the screen; it is used to store item specific data.

-position integer (NA)
Replaces the item at position integer. The base position is 1. To indicate the last item on the list, use 0.

For information about using connection icons, refer to the VtDrawnList manual page.