The Optionmenu Widget (Perl in a Nutshell, 2nd Edition)

21.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 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, distinct from the value shown in the option menu.