DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

VtDrawnListDeselectItem(VTCL)


VtDrawnListDeselectItem -- deselect an item from a DrawnList

Syntax

VtDrawnListDeselectItem drawnlist_widgetName [options]

Description

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

Options


-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.

Errors


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

© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003