1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160
|
<html>
<head>
<title>Pmw.MenuBar reference manual</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#0000ee"
vlink="551a8b" alink="ff0000">
<center><P ALIGN="CENTER">
<IMG SRC = transdove.gif ALT = "" WIDTH=70 HEIGHT=75>
<IMG SRC = transdove.gif ALT = "" WIDTH=70 HEIGHT=75>
<IMG SRC = transdove.gif ALT = "" WIDTH=70 HEIGHT=75>
</p></center>
<h1 ALIGN="CENTER">Pmw.MenuBar</h1>
<p>
<dl>
<dt> <h3>Name</h3><dd>
<p>Pmw.MenuBar() -
manager widget for menu buttons and menus
</p>
<dt> <h3>Inherits</h3><dd>
<a href="MegaWidget.html">Pmw.MegaWidget</a><br>
<dt> <h3>Description</h3><dd>
<p>
This class creates a manager widget for containing menus. There
are methods to add menu buttons and menus to the menu bar and for
adding menu items to the menus. Menu buttons may be added to the
left or right of the widget. Each menu button and menu item may
have help text to be displayed by a <a href="Balloon.html">Pmw.Balloon</a> widget.</p>
<p></p>
<dt> <h3>Options</h3><dd>
Options for this megawidget and its base
classes are described below.<p>
<a name=option.balloon></a>
<dl><dt> <strong>balloon
</strong><dd>
Specifies a <a href="Balloon.html">Pmw.Balloon</a> widget to display the help text for menu
buttons and menu items. If <strong>None</strong>, no help is displayed. The default is <strong>None</strong>.</p>
</dt></dl>
<a name=option.padx></a>
<dl><dt> <strong>padx
</strong><dd>
Initialisation option. Specifies a padding distance to leave between each menu button in
the x direction and also between the menu buttons and the outer
edge of the menu bar. The default is <strong>0</strong>.</p>
</dt></dl>
<dt> <h3>Components</h3><dd>
Components created by this megawidget and its base
classes are described below.<p>
<a name=component.hull></a>
<dl><dt> <strong>hull
</strong><dd>
This acts as the body for the entire megawidget. Other components
are created as children of the hull to further specialise the
widget. By default, this component is a Tkinter.Frame.</p>
</dt></dl>
<dt> <h3>Dynamic components</h3><dd>
<p>
Menu buttons and menu components are created dynamically by
the <code>addmenu()</code> method. By default, the buttons are of type
Tkinter.Menubutton and are created with a component group of
<strong>Button</strong>. Menus are of type Tkinter.Menu and are created with
a component group of <strong>Menu</strong>.</p>
<p> </p>
<a name=methods></a>
<dt> <h3>Methods</h3><dd>
Only methods specific to this megawidget are described below.
For a description of its inherited methods, see the
manuals for its base classes.
<p>
<a name=method.addcascademenu></a>
<dl><dt> <strong>addcascademenu</strong>(<em>menuName</em>, <em>submenu</em>, <em>help</em> = <strong>''</strong>, **<em>kw</em>)<dd>
<p></p>
</dt></dl>
<a name=method.addmenu></a>
<dl><dt> <strong>addmenu</strong>(<em>menuName</em>, <em>balloonHelp</em>, <em>statusHelp</em> = <strong>None</strong>, <em>side</em> = <strong>'left'</strong>, **<em>kw</em>)<dd>
Add a menu button and its associated menu to the menu bar. Any
keyword arguments present will be passed to the constructor when
creating the menu button. If the <strong>text</strong> keyword argument is not
given, the <strong>text</strong> option of the menu button defaults to
<em>menuName</em>. Each menu button is packed into the menu bar using
the given <em>side</em>, which should be either <strong>left</strong> or <strong>right</strong>.</p>
<p> If the <strong>balloon</strong> option has been defined, <em>balloonHelp</em> and
<em>statusHelp</em> are passed to the balloon as the help strings for the
menu button. See the <code>bind()</code> method of <a href="Balloon.html">Pmw.Balloon</a> for how these
strings may be displayed.</p>
<p> The menu button is created as a component named
<em>menuName</em>-<strong>button</strong> and the menu is created as a component named
<em>menuName</em>-<strong>menu</strong>. The method returns the menu button component
widget.</p>
</dt></dl>
<a name=method.addmenuitem></a>
<dl><dt> <strong>addmenuitem</strong>(<em>menuName</em>, <em>type</em>, <em>help</em> = <strong>''</strong>, **<em>kw</em>)<dd>
Add a menu item to the menu given by <em>menuName</em>. The kind of menu
item is given by <em>type</em> and may be one of <strong>command</strong>, <strong>separator</strong>,
<strong>checkbutton</strong>, <strong>radiobutton</strong> or <strong>cascade</strong>. Any keyword arguments
present will be passed to the menu when creating the menu item.
See Tkinter.Menu for the valid options for each type. When the
mouse is moved over the menu item, the string given by <em>help</em> will
be displayed by the <strong>balloon</strong>'s <strong>statuscommand</strong>.</p>
</dt></dl>
<a name=method.deletemenu></a>
<dl><dt> <strong>deletemenu</strong>(<em>menuName</em>)<dd>
<p></p>
</dt></dl>
<a name=method.deletemenuitems></a>
<dl><dt> <strong>deletemenuitems</strong>(<em>menuName</em>, <em>start</em> = <strong>'0'</strong>, <em>end</em> = <strong>None</strong>)<dd>
<p></p>
</dt></dl>
<a name=method.disableall></a>
<dl><dt> <strong>disableall</strong>()<dd>
<p></p>
</dt></dl>
<a name=method.enableall></a>
<dl><dt> <strong>enableall</strong>()<dd>
<p></p>
</dt></dl>
</dl>
<center><P ALIGN="CENTER">
<IMG SRC = blue_line.gif ALT = "" WIDTH=320 HEIGHT=5>
</p></center>
<font size=-1>
<center><P ALIGN="CENTER">
<a href="index.html">Home</a>.
Pmw 0.6.2
Maintainer
<a href="mailto:gregm@iname.com">gregm@iname.com</a>.
23 Feb 1998
</p></center>
</font>
</body>
</html>
|