home | O'Reilly's CD bookshelfs | FreeBSD | Linux | Cisco | Cisco Exam  

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.