VtDrawnListSetItemValues(VTCL)


VtDrawnListSetItemValues -- sets values of item in DrawnList given specified options

Synopsis

VtDrawnListSetItemValues drawnlist_widgetName [options]

Description

Given an item in a DrawnList (via position or field option), sets the options passed in. Currently, -overrideFont and -itemBorder are the only options available to set. These options only work in the graphical environment.

Options


-field column matchStr (NA)
Specify a match string for a column of data in the DrawnList.

The value of matchStr is compared to each field in the named column, and the appropriate records are matched. 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.

-itemBorder NONE | ONOFFD.NM | DOUBLED.NM | SOLID (CS)
Used to set a border around a DrawnList item. This option only applies to the graphical environment.

-overrideFont string (CS)
Sets the font of a DrawnList item to one of the symbolic font names defined in the SCO Visual Tcl application resource file. This option only applies to the graphical environment.

-position integer (NA)
Specifies the position of the item to set the value of. (The base position is 1. To indicate the last item on the list, use 0.)

-positionList integer (NA)
Select a list of items by position.

Return values

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

DRAWNLIST_BORDER
border is of unknown type

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

Standard errors
See ``Tcl widget creation errors'' in Developing Visual Tcl applications.

02 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 - 02 June 2005