VtComboBox(1vtcl)

VtComboBox -- create a ComboBox widget and return widget name

Synopsis

VtComboBox widgetName [options]

Description

Creates a ComboBox widget. Returns the widget name.

Options

-callback cmd (C)

Specifies the callback cmd. This is called when one of two conditions occurs:

The value changed and the widget lost focus.

The <Enter> keypress was received in the ComboBox text.

Additional callback key:

value: value in text field of the ComboBox.

-columns integer (CS)

Make the object integer columns wide. This means that integer characters are shown. In the graphical environment this will make the width of the object integer * MaxCharwidth wide (where MaxCharwidth is the width of the largest character in the current character set).

-dropListCallback cmd (CS)

Sets the callback cmd, called when the droplist on the ComboBox is opened.

Additional callback keys:

value: value in text field of ComboBox

-itemList string_ray (CSG)

Sets a list of items for the ComboBox object.

-readOnly (CS)

Disables entry into the text field of the ComboBox widget. Data may still be set by choosing items from the ComboBox droplist.

-rows integer (CS)

Makes the object display integer rows of text. If there are more than integer rows, the object will provide a vertical ScrollBar (to permit scrolling over the entire list). If there are less than integer rows, only that number of items will be shown. (The default value for integer is 6.)

-textVariable string (CS)

Updates the interpreter variable string with the widget value. The update happens under the same conditions that would invoke -callback, but before -callback is called. Setting a value into the interpreter variable updates the ComboBox as if setting -value on the widget.

-value string (CSG)

Sets the string to put in the text field in the ComboBox.

-valueChangedCallback cmd (CS)

Sets the callback cmd called after text is deleted from or inserted into the widget.

Additional callback keys:

value: value in text field of the ComboBox