Book HomeJava and XSLTSearch this book

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.



Library Navigation Links

Copyright © 2002 O'Reilly & Associates. All rights reserved.