DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

VtDrawnListGetItem(VTCL)


VtDrawnListGetItem -- get record(s) from a DrawnList

Syntax

VtDrawnListGetItem drawnlist_widgetName [options]

Description

Gets the records from the list. Returns a list of lists; a two dimension list of the items in the DrawnList.
{
   { 0 {string} {data}}
   { 0 {string} {data}}
}

Options


-all (NA)
Gets the entire list.

-field column matchStr (NA)
Gets fields on the basis of a match on columns of data. For example, if your list contains:
{0 1 "String one"}
{0 1 "String two"} 
{0 1 "String three"}
specifying -field 2 "String two" matches item 2.

-position integer (NA)
Specifies an item to get by position. (The base position is 1. To indicate the last item on the list, use 0.)

-positionList integer_list (NA)
Specifies a list of item positions to get. If this option is selected, VtDrawnListGetSelectedItem returns a list of positions instead of the normal return value.

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