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.