Perl in a Nutshell, 2nd Edition

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 descriptions of the menu items displayed are different from those of the values stored, the menu items are themselves written as two-item lists.

The standard configuration options that apply to Optionmenu are: -activeback-ground, -activeforeground, -background, -bg, -bitmap, -borderwidth, -bw, -cursor, -disabledforeground, -font, -foreground, -fg, -highlightbackground, -highlight-color, -highlightthickness, -image, -justify, -relief, -state, -takefocus, -un-derline, -width, and -wraplength.

Other options are:

-command => callback

The command to execute when a selection is made. Its arguments are the values of the -textvariable and -variable options.

-indicatoron => boolean

Determines whether to display an indicator.

-menu => $ menu

Displays the menu associated with $ menu.

-options => list

Lists the menu options, as described above.

-tearoff => boolean

Whether 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, ...