VtDrawnListDeselectItem(1vtcl)

VtDrawnListDeselectItem -- deselect an item from a DrawnList

Synopsis

VtDrawnListDeselectItem drawnlist_widgetName [options]

Deselects an item from a DrawnList. It is an error if the position or the field options do not match something in the list.

-all (NA)

Deselects the entire list.

-field column matchStr (NA)

Deselects the item whose field column matches matchStr. For example, if your list contains:

{0 1 "String one"}
{0 1 "String two"} 
{0 1 "String three"}

specifying -field 2 "String one" would match item 1.

-position integer (NA)

Specifies the position of the item to deselect.

-positionList integer_list (NA)

Deselects the items at the specified positions.

If VtDrawnListDeselectItem fails, it returns one of the following error messages:

INVALID_POSITION: the position value is outside the list range
NO_FIELD: couldn't find the referenced field
NO_OPTION: no options were specified
NOT_DRAWNLIST: referenced widget is not a DrawnList
OPTION_COUNT: too many or too few options specified
RECORD_COUNT: number of records specifed exceeds number of available records