 |  |
21.15. The Menu Widget
Create a menu with the Menu method, to be displayed later with the post method.
$menu = $parent->Menu(options)
The standard configuration options that apply to Menu are: -activebackground, -activeforeground, -background, -bg, -borderwidth, -bw, -cursor, -disabledfore-ground, -font, -foreground, -fg, -relief, and -takefocus.
Other options are:
- -activeborderwidth => amount
- Sets the width of the edges for the active menu item.
- -menuitems => list
- Specifies items to create in the menu as a list of lists.
- -postcommand => callback
- The command to invoke before the menu is posted. For example, to update the state of the menu items.
- -tearoff => boolean
- Whether to allow the menu to be "torn off." Default is 1.
- -selectcolor => color
- Color of the selection box for checkbuttons or radiobuttons.
21.15.1. Menu Indexes
Menus have indexes for manipulating individual menu items. They are:
- n
- Menu item n, with 0 representing the first item
- active
- The current menu item
- end or last
- The last menu item
- none
- No menu item
- @n
- The menu item closest to the y coordinate specified by n
- pattern
- The first menu item with text that matches the pattern
21.15.2. Menu Methods
In addition to configure and cget, the following methods are defined for the Menu widget:
- add
-
Adds items to the end of a menu. The
first argument is the type of menu item to add, and additional
arguments are options to the menu item. For example:
$menu = $mainwindow->Menu; $menu->add( 'command', -label => "New", "-command" => \&newfile );
- entrycget
- Gets information on a specific menu item given an index.
- entryconfigure
- Changes information on a specific menu item given an index.
- post
- Displays the menu widget.
- unpost
- Removes the menu widget from display.
- postcascade
- Unposts a submenu and posts the cascade menu associated with the menu item at the specified index.
- delete
- Removes menu items from the menu.
- index
- Given a named index, returns the numerical index for that menu item.
- insert
- Inserts a menu item at the specified index. Same as add, except that it takes an index as the first argument.
- invoke
- Invokes the menu item at the specified index as if it was selected.
- type
- Returns the type of menu item at the specified index.
- yposition
- Returns the y coordinate of the topmost pixel of the menu item.
|  | |
| 21.14. The Menubutton Widget |  | 21.16. The Optionmenu Widget |
Copyright © 2002 O'Reilly & Associates. All rights reserved.