DOC HOME
SITE MAP
MAN PAGES
GNU INFO
SEARCH
PRINT BOOK
VtDrawnListDeselectItem(1vtcl)
VtDrawnListDeselectItem -- deselect an item from a DrawnList
Synopsis
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.
Return values
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
25 April 2004
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004