18.16 The Optionmenu Widget

Use the Optionmenu method to create an option menu, in which the selected item is the value displayed. For example:

$mainwindow->OptionMenu(-textvariable => \$platform,
        -options => [ [ "UNIX", "unix" ],
		      [ "Windows NT", "winnt" ],
		      [ "Macintosh", "mac" ] ]) -> pack;

The -options argument takes a list of menu items. If the description of the menu items that are displayed are different from the values stored, the menu items are themselves written as two-item lists.

The standard configuration options that apply to Optionmenu are: -activebackground , -activeforeground , -background , -bg , -bitmap , -borderwidth , -bw , -cursor , -disabledforeground , -font , -foreground , -fg , -highlightbackground , -highlightcolor , -highlightthickness , -image , -justify , -relief , -state , -takefocus , -underline , -width , and -wraplength .

Other options are:

-command => callback

The command to execute when a selection is made, with its arguments being the values of the -textvariable and -variable options.

-indicatoron => boolean

Determines whether or not to display an indicator.

-menu => $menu

Displays the menu associated with $menu .

-options => list

Lists the menu options, as described above.

-tearoff => boolean

Whether or not to allow the menu to be "torn off." Default is 1.

-text => string

Specifies the text to display as a label for the option menu.

-textvariable => \$variable

Points to the variable containing text to be displayed in the option menu.

-variable => \$variable

Points to a variable containing a stored value, distinct from the value shown in the option menu.