Synopsis

Screenshot

Options

This sets the focus to the widget. To unset the focus it must be set to another widget.

-itemslist of strings (default: "")

Creates for each element of this list a new item. The string value of the element is used as text and value of the item.

-itemListlist of two-element-lists

Creates for each element of this list a new item. The first element of each element is used as text and the second element is used as value of the item. (TODO: pixmap for each item)

-name string

Name of the widget, can be used to set options in an rc file.

-onChangedstring (default: "")

Tcl command which is executed if the value of the option menu is changed via the GUI. Before evaluation the following percent strings are substituted:

%wwidget name%vvalue of the active item

NOTE: This command is not called if the value is changed via the option -value.

-onShowHelpstring (default: "")

Tcl command which is executed in the global scope if the "show-help" signal is received, which is normally the case if the user presses F1 or Ctrl-F1. Before evaluation the following percent strings are substituted:

%wwidget name%hhelp type: either "whatsThis" or "tooltip"

-onPopupMenustring (default: "")

Tcl command which is executed if the "popup-menu" signal is received, which is normally the case if the user presses Shift-F10. Before evaluation the following percent strings are substituted:

%wwidget name

-onRealizestring (default: "")

Tcl command which is executed in the global scope if the widget has been realized. Before evaluation the following percent strings are substituted:

%wwidget name

-sensitiveboolean (default: 1)

Whether or not the item is sensitive to user input.

-tooltipstring

Message that appear next to this widget when the mouse pointer is held over it for a short amount of time.

-valuestring

Value of the item which shall be activated

-variablestring (default: "")

Name of a (global) variable which is changed whenever the option menu is changed.