DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

VtDrawnListSetItemValues(VTCL)


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

Syntax

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.

Errors


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 SCO Visual Tcl Programmer's Guide and Reference.

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