summaryrefslogtreecommitdiffstats
path: root/doc/html/qmenubar.html
diff options
context:
space:
mode:
authorTimothy Pearson <kb9vqf@pearsoncomputing.net>2011-11-08 12:31:36 -0600
committerTimothy Pearson <kb9vqf@pearsoncomputing.net>2011-11-08 12:31:36 -0600
commitd796c9dd933ab96ec83b9a634feedd5d32e1ba3f (patch)
tree6e3dcca4f77e20ec8966c666aac7c35bd4704053 /doc/html/qmenubar.html
downloadtqt3-d796c9dd933ab96ec83b9a634feedd5d32e1ba3f.tar.gz
tqt3-d796c9dd933ab96ec83b9a634feedd5d32e1ba3f.zip
Test conversion to TQt3 from Qt3 8c6fc1f8e35fd264dd01c582ca5e7549b32ab731
Diffstat (limited to 'doc/html/qmenubar.html')
-rw-r--r--doc/html/qmenubar.html593
1 files changed, 593 insertions, 0 deletions
diff --git a/doc/html/qmenubar.html b/doc/html/qmenubar.html
new file mode 100644
index 000000000..fe899bdaa
--- /dev/null
+++ b/doc/html/qmenubar.html
@@ -0,0 +1,593 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/widgets/qmenubar.cpp:75 -->
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>TQMenuBar Class</title>
+<style type="text/css"><!--
+fn { margin-left: 1cm; text-indent: -1cm; }
+a:link { color: #004faf; text-decoration: none }
+a:visited { color: #672967; text-decoration: none }
+body { background: #ffffff; color: black; }
+--></style>
+</head>
+<body>
+
+<table border="0" cellpadding="0" cellspacing="0" width="100%">
+<tr bgcolor="#E5E5E5">
+<td valign=center>
+ <a href="index.html">
+<font color="#004faf">Home</font></a>
+ | <a href="classes.html">
+<font color="#004faf">All&nbsp;Classes</font></a>
+ | <a href="mainclasses.html">
+<font color="#004faf">Main&nbsp;Classes</font></a>
+ | <a href="annotated.html">
+<font color="#004faf">Annotated</font></a>
+ | <a href="groups.html">
+<font color="#004faf">Grouped&nbsp;Classes</font></a>
+ | <a href="functions.html">
+<font color="#004faf">Functions</font></a>
+</td>
+<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQMenuBar Class Reference</h1>
+
+<p>The TQMenuBar class provides a horizontal menu bar.
+<a href="#details">More...</a>
+<p><tt>#include &lt;<a href="qmenubar-h.html">qmenubar.h</a>&gt;</tt>
+<p>Inherits <a href="qframe.html">TQFrame</a> and <a href="qmenudata.html">TQMenuData</a>.
+<p><a href="qmenubar-members.html">List of all member functions.</a>
+<h2>Public Members</h2>
+<ul>
+<li class=fn><a href="#TQMenuBar"><b>TQMenuBar</b></a> ( TQWidget&nbsp;*&nbsp;parent = 0, const&nbsp;char&nbsp;*&nbsp;name = 0 )</li>
+<li class=fn><a href="#~TQMenuBar"><b>~TQMenuBar</b></a> ()</li>
+<li class=fn>virtual void <a href="#show"><b>show</b></a> ()</li>
+<li class=fn>virtual void <a href="#hide"><b>hide</b></a> ()</li>
+<li class=fn>virtual int <a href="#heightForWidth"><b>heightForWidth</b></a> ( int&nbsp;max_width ) const</li>
+<li class=fn>enum <a href="#Separator-enum"><b>Separator</b></a> { Never = 0, InWindowsStyle = 1 }</li>
+<li class=fn>Separator separator () const &nbsp;<em>(obsolete)</em></li>
+<li class=fn>virtual void setSeparator ( Separator&nbsp;when ) &nbsp;<em>(obsolete)</em></li>
+<li class=fn>void <a href="#setDefaultUp"><b>setDefaultUp</b></a> ( bool )</li>
+<li class=fn>bool <a href="#isDefaultUp"><b>isDefaultUp</b></a> () const</li>
+</ul>
+<h2>Signals</h2>
+<ul>
+<li class=fn>void <a href="#activated"><b>activated</b></a> ( int&nbsp;id )</li>
+<li class=fn>void <a href="#highlighted"><b>highlighted</b></a> ( int&nbsp;id )</li>
+</ul>
+<h2>Important Inherited Members</h2>
+<ul>
+<li class=fn>int <a href="#insertItem"><b>insertItem</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;text, const&nbsp;TQObject&nbsp;*&nbsp;receiver, const&nbsp;char&nbsp;*&nbsp;member, const&nbsp;TQKeySequence&nbsp;&amp;&nbsp;accel = 0, int&nbsp;id = -1, int&nbsp;index = -1 )</li>
+<li class=fn>int <a href="#insertItem-2"><b>insertItem</b></a> ( const&nbsp;TQIconSet&nbsp;&amp;&nbsp;icon, const&nbsp;TQString&nbsp;&amp;&nbsp;text, const&nbsp;TQObject&nbsp;*&nbsp;receiver, const&nbsp;char&nbsp;*&nbsp;member, const&nbsp;TQKeySequence&nbsp;&amp;&nbsp;accel = 0, int&nbsp;id = -1, int&nbsp;index = -1 )</li>
+<li class=fn>int <a href="#insertItem-3"><b>insertItem</b></a> ( const&nbsp;TQPixmap&nbsp;&amp;&nbsp;pixmap, const&nbsp;TQObject&nbsp;*&nbsp;receiver, const&nbsp;char&nbsp;*&nbsp;member, const&nbsp;TQKeySequence&nbsp;&amp;&nbsp;accel = 0, int&nbsp;id = -1, int&nbsp;index = -1 )</li>
+<li class=fn>int <a href="#insertItem-4"><b>insertItem</b></a> ( const&nbsp;TQIconSet&nbsp;&amp;&nbsp;icon, const&nbsp;TQPixmap&nbsp;&amp;&nbsp;pixmap, const&nbsp;TQObject&nbsp;*&nbsp;receiver, const&nbsp;char&nbsp;*&nbsp;member, const&nbsp;TQKeySequence&nbsp;&amp;&nbsp;accel = 0, int&nbsp;id = -1, int&nbsp;index = -1 )</li>
+<li class=fn>int <a href="#insertItem-5"><b>insertItem</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;text, int&nbsp;id = -1, int&nbsp;index = -1 )</li>
+<li class=fn>int <a href="#insertItem-6"><b>insertItem</b></a> ( const&nbsp;TQIconSet&nbsp;&amp;&nbsp;icon, const&nbsp;TQString&nbsp;&amp;&nbsp;text, int&nbsp;id = -1, int&nbsp;index = -1 )</li>
+<li class=fn>int <a href="#insertItem-7"><b>insertItem</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;text, TQPopupMenu&nbsp;*&nbsp;popup, int&nbsp;id = -1, int&nbsp;index = -1 )</li>
+<li class=fn>int <a href="#insertItem-8"><b>insertItem</b></a> ( const&nbsp;TQIconSet&nbsp;&amp;&nbsp;icon, const&nbsp;TQString&nbsp;&amp;&nbsp;text, TQPopupMenu&nbsp;*&nbsp;popup, int&nbsp;id = -1, int&nbsp;index = -1 )</li>
+<li class=fn>int <a href="#insertItem-9"><b>insertItem</b></a> ( const&nbsp;TQPixmap&nbsp;&amp;&nbsp;pixmap, int&nbsp;id = -1, int&nbsp;index = -1 )</li>
+<li class=fn>int <a href="#insertItem-a"><b>insertItem</b></a> ( const&nbsp;TQIconSet&nbsp;&amp;&nbsp;icon, const&nbsp;TQPixmap&nbsp;&amp;&nbsp;pixmap, int&nbsp;id = -1, int&nbsp;index = -1 )</li>
+<li class=fn>int <a href="#insertItem-b"><b>insertItem</b></a> ( const&nbsp;TQPixmap&nbsp;&amp;&nbsp;pixmap, TQPopupMenu&nbsp;*&nbsp;popup, int&nbsp;id = -1, int&nbsp;index = -1 )</li>
+<li class=fn>int <a href="#insertItem-c"><b>insertItem</b></a> ( const&nbsp;TQIconSet&nbsp;&amp;&nbsp;icon, const&nbsp;TQPixmap&nbsp;&amp;&nbsp;pixmap, TQPopupMenu&nbsp;*&nbsp;popup, int&nbsp;id = -1, int&nbsp;index = -1 )</li>
+<li class=fn>int <a href="#insertItem-d"><b>insertItem</b></a> ( TQWidget&nbsp;*&nbsp;widget, int&nbsp;id = -1, int&nbsp;index = -1 )</li>
+<li class=fn>int <a href="#insertItem-e"><b>insertItem</b></a> ( const&nbsp;TQIconSet&nbsp;&amp;&nbsp;icon, TQCustomMenuItem&nbsp;*&nbsp;custom, int&nbsp;id = -1, int&nbsp;index = -1 )</li>
+<li class=fn>int <a href="#insertItem-f"><b>insertItem</b></a> ( TQCustomMenuItem&nbsp;*&nbsp;custom, int&nbsp;id = -1, int&nbsp;index = -1 )</li>
+<li class=fn>int <a href="#insertSeparator"><b>insertSeparator</b></a> ( int&nbsp;index = -1 )</li>
+<li class=fn>void <a href="#removeItem"><b>removeItem</b></a> ( int&nbsp;id )</li>
+<li class=fn>void <a href="#clear"><b>clear</b></a> ()</li>
+<li class=fn>bool <a href="#isItemEnabled"><b>isItemEnabled</b></a> ( int&nbsp;id ) const</li>
+<li class=fn>void <a href="#setItemEnabled"><b>setItemEnabled</b></a> ( int&nbsp;id, bool&nbsp;enable )</li>
+<li class=fn>bool <a href="#isItemVisible"><b>isItemVisible</b></a> ( int&nbsp;id ) const</li>
+<li class=fn>void <a href="#setItemVisible"><b>setItemVisible</b></a> ( int&nbsp;id, bool&nbsp;visible )</li>
+</ul>
+<h2>Properties</h2>
+<ul>
+<li class=fn>bool <a href="#defaultUp-prop"><b>defaultUp</b></a>&nbsp;- the popup orientation</li>
+<li class=fn>Separator separator&nbsp;- in which cases a menubar sparator is drawn &nbsp;<em>(obsolete)</em></li>
+</ul>
+<h2>Protected Members</h2>
+<ul>
+<li class=fn>virtual void <a href="#drawContents"><b>drawContents</b></a> ( TQPainter&nbsp;*&nbsp;p )</li>
+<li class=fn>virtual void <a href="#menuContentsChanged"><b>menuContentsChanged</b></a> ()</li>
+<li class=fn>virtual void <a href="#menuStateChanged"><b>menuStateChanged</b></a> ()</li>
+</ul>
+<hr><a name="details"></a><h2>Detailed Description</h2>
+
+
+The TQMenuBar class provides a horizontal menu bar.
+<p>
+
+<p> A menu bar consists of a list of pull-down menu items. You add
+menu items with <a href="qmenudata.html#insertItem">insertItem()</a>. For example, asuming that <tt>menubar</tt> is a
+pointer to a TQMenuBar and <tt>filemenu</tt> is a pointer to a
+<a href="qpopupmenu.html">TQPopupMenu</a>, the following statement inserts the menu into the menu
+bar:
+<pre>
+ menubar-&gt;insertItem( "&amp;File", filemenu );
+ </pre>
+
+The ampersand in the menu item's text sets Alt+F as a shortcut for
+this menu. (You can use "&amp;&amp;" to get a real ampersand in the menu
+bar.)
+<p> Items are either enabled or disabled. You toggle their state with
+<a href="qmenudata.html#setItemEnabled">setItemEnabled</a>().
+<p> There is no need to lay out a menu bar. It automatically sets its
+own geometry to the top of the parent widget and changes it
+appropriately whenever the parent is resized.
+<p>
+<p> Example of creating a menu bar with menu items (from <a href="menu-example.html">menu/menu.cpp</a>):
+
+
+<pre> <a href="qpopupmenu.html">TQPopupMenu</a> *file = new <a href="qpopupmenu.html">TQPopupMenu</a>( this );
+</pre><pre> file-&gt;<a href="qmenudata.html#insertItem">insertItem</a>( p1, "&amp;Open", this, SLOT(open()), CTRL+Key_O );
+ file-&gt;<a href="qmenudata.html#insertItem">insertItem</a>( p2, "&amp;New", this, SLOT(news()), CTRL+Key_N );
+</pre><pre> menu = new TQMenuBar( this );
+</pre><pre> menu-&gt;<a href="qmenudata.html#insertItem">insertItem</a>( "&amp;File", file );
+</pre>
+<p> In most main window style applications you would use the menuBar()
+provided in <a href="qmainwindow.html">TQMainWindow</a>, adding <a href="qpopupmenu.html">TQPopupMenu</a>s to the menu bar
+and adding <a href="qaction.html">TQAction</a>s to the popup menus.
+<p> Example (from <a href="qaction-application-example.html">action/application.cpp</a>):
+
+
+<pre> <a href="qpopupmenu.html">TQPopupMenu</a> * file = new <a href="qpopupmenu.html">TQPopupMenu</a>( this );
+ <a href="qmainwindow.html#menuBar">menuBar</a>()-&gt;insertItem( "&amp;File", file );
+ fileNewAction-&gt;<a href="qaction.html#addTo">addTo</a>( file );
+</pre>
+<p> Menu items can have text and pixmaps (or iconsets), see the
+various <a href="qmenudata.html#insertItem">insertItem()</a>
+overloads, as well as separators, see <a href="qmenudata.html#insertSeparator">insertSeparator()</a>. You can
+also add custom menu items that are derived from
+<a href="qcustommenuitem.html">TQCustomMenuItem</a>.
+<p> Menu items may be removed with <a href="qmenudata.html#removeItem">removeItem</a>() and enabled or
+disabled with <a href="qmenudata.html#setItemEnabled">setItemEnabled()</a>.
+<p> <img src=qmenubar-m.png> <img src=qmenubar-w.png>
+<p> <h3> TQMenuBar on TQt/Mac
+</h3>
+<a name="1"></a><p> TQMenuBar on TQt/Mac is a wrapper for using the system-wide menubar.
+If you have multiple menubars in one dialog the outermost menubar
+(normally inside a widget with <a href="qt.html#WidgetFlags">widget flag</a> <a href="qt.html#WidgetFlags-enum">WType_TopLevel</a>) will
+be used for the system-wide menubar.
+<p> Note that arbitrary TQt widgets <em>cannot</em> be inserted into a
+TQMenuBar on the Mac because TQt uses Mac's native menus which don't
+support this functionality. This limitation does not apply to
+stand-alone TQPopupMenus.
+<p> TQt/Mac also provides a menubar merging feature to make TQMenuBar
+conform more closely to accepted Mac OS X menubar layout. The
+merging functionality is based on string matching the title of a
+<a href="qpopupmenu.html">TQPopupMenu</a> entry. These strings are translated (using
+<a href="qobject.html#tr">TQObject::tr</a>()) in the "TQMenuBar" context. If an entry is moved its
+slots will still fire as if it was in the original place. The
+table below outlines the strings looked for and where the entry is
+placed if matched:
+<p> <center><table cellpadding="4" cellspacing="2" border="0">
+<tr bgcolor="#a2c511"> <th valign="top">String matches <th valign="top">Placement <th valign="top">Notes
+<tr bgcolor="#f0f0f0"> <td valign="top">about.*
+<td valign="top">Application Menu | About <application name>
+<td valign="top">If this entry is not found no About item will appear in
+the Application Menu
+<tr bgcolor="#d0d0d0"> <td valign="top">config, options, setup, settings or preferences
+<td valign="top">Application Menu | Preferences
+<td valign="top">If this entry is not found the Settings item will be disabled
+<tr bgcolor="#f0f0f0"> <td valign="top">tquit or exit
+<td valign="top">Application Menu | Quit <application name>
+<td valign="top">If this entry is not found a default Quit item will be
+created to call <a href="qapplication.html#tquit">TQApplication::tquit</a>()
+</table></center>
+<p> <a href="menu-example.html">menu/menu.cpp</a> is an example of
+TQMenuBar and <a href="qpopupmenu.html">TQPopupMenu</a> use.
+<p> <p>See also <a href="qpopupmenu.html">TQPopupMenu</a>, <a href="qaccel.html">TQAccel</a>, <a href="qaction.html">TQAction</a>, <a href="http://developer.apple.com/techpubs/macosx/Carbon/HumanInterfaceToolbox/Aqua/aqua.html">Aqua Style Guidelines</a>, <a href="guibooks.html#fowler">GUI Design Handbook: Menu Bar</a>, and <a href="application.html">Main Window and Related Classes</a>.
+
+<hr><h2>Member Type Documentation</h2>
+<h3 class=fn><a name="Separator-enum"></a>TQMenuBar::Separator</h3>
+
+<p> This enum type is used to decide whether TQMenuBar should draw a
+separator line at its bottom.
+<ul>
+<li><tt>TQMenuBar::Never</tt> - In many applications there is already a separator,
+and having two looks wrong.
+<li><tt>TQMenuBar::InWindowsStyle</tt> - In some other applications a separator looks
+good in Windows style, but nowhere else.
+</ul>
+<hr><h2>Member Function Documentation</h2>
+<h3 class=fn><a name="TQMenuBar"></a>TQMenuBar::TQMenuBar ( <a href="qwidget.html">TQWidget</a>&nbsp;*&nbsp;parent = 0, const&nbsp;char&nbsp;*&nbsp;name = 0 )
+</h3>
+Constructs a menu bar called <em>name</em> with parent <em>parent</em>.
+
+<h3 class=fn><a name="~TQMenuBar"></a>TQMenuBar::~TQMenuBar ()
+</h3>
+Destroys the menu bar.
+
+<h3 class=fn>void <a name="activated"></a>TQMenuBar::activated ( int&nbsp;id )<tt> [signal]</tt>
+</h3>
+
+<p> This signal is emitted when a menu item is selected; <em>id</em> is the
+id of the selected item.
+<p> Normally you will connect each menu item to a single slot using
+<a href="qmenudata.html#insertItem">TQMenuData::insertItem</a>(), but sometimes you will want to connect
+several items to a single slot (most often if the user selects
+from an array). This signal is useful in such cases.
+<p> <p>See also <a href="#highlighted">highlighted</a>() and <a href="qmenudata.html#insertItem">TQMenuData::insertItem</a>().
+
+<p>Example: <a href="progress-example.html#x67">progress/progress.cpp</a>.
+<h3 class=fn>void <a name="clear"></a>TQMenuData::clear ()
+</h3>
+Removes all menu items.
+<p> <p>See also <a href="qmenudata.html#removeItem">removeItem</a>() and <a href="qmenudata.html#removeItemAt">removeItemAt</a>().
+
+<p>Examples: <a href="mdi-example.html#x2029">mdi/application.cpp</a> and <a href="qwerty-example.html#x370">qwerty/qwerty.cpp</a>.
+<h3 class=fn>void <a name="drawContents"></a>TQMenuBar::drawContents ( <a href="qpainter.html">TQPainter</a>&nbsp;*&nbsp;p )<tt> [virtual protected]</tt>
+</h3>
+Called from <a href="qframe.html#paintEvent">TQFrame::paintEvent</a>(). Draws the menu bar contents
+using painter <em>p</em>.
+
+<p>Reimplemented from <a href="qframe.html#drawContents">TQFrame</a>.
+<h3 class=fn>int <a name="heightForWidth"></a>TQMenuBar::heightForWidth ( int&nbsp;max_width ) const<tt> [virtual]</tt>
+</h3>
+Returns the height that the menu would resize itself to if its
+parent (and hence itself) resized to the given <em>max_width</em>. This
+can be useful for simple layout tasks in which the height of the
+menu bar is needed after items have been inserted. See <a href="showimg-example.html">showimg/showimg.cpp</a> for an example of the usage.
+
+<p>Example: <a href="showimg-example.html#x1325">showimg/showimg.cpp</a>.
+<p>Reimplemented from <a href="qwidget.html#heightForWidth">TQWidget</a>.
+<h3 class=fn>void <a name="hide"></a>TQMenuBar::hide ()<tt> [virtual]</tt>
+</h3>
+Reimplements <a href="qwidget.html#hide">TQWidget::hide</a>() in order to deselect any selected
+item, and calls setUpLayout() for the main window.
+
+<p>Example: <a href="grapher-nsplugin-example.html#x2745">grapher/grapher.cpp</a>.
+<p>Reimplemented from <a href="qwidget.html#hide">TQWidget</a>.
+<h3 class=fn>void <a name="highlighted"></a>TQMenuBar::highlighted ( int&nbsp;id )<tt> [signal]</tt>
+</h3>
+
+<p> This signal is emitted when a menu item is highlighted; <em>id</em> is
+the id of the highlighted item.
+<p> Normally, you will connect each menu item to a single slot using
+<a href="qmenudata.html#insertItem">TQMenuData::insertItem</a>(), but sometimes you will want to connect
+several items to a single slot (most often if the user selects
+from an array). This signal is useful in such cases.
+<p> <p>See also <a href="#activated">activated</a>() and <a href="qmenudata.html#insertItem">TQMenuData::insertItem</a>().
+
+<h3 class=fn>int <a name="insertItem"></a>TQMenuData::insertItem ( const&nbsp;<a href="qstring.html">TQString</a>&nbsp;&amp;&nbsp;text, const&nbsp;<a href="qobject.html">TQObject</a>&nbsp;*&nbsp;receiver, const&nbsp;char&nbsp;*&nbsp;member, const&nbsp;<a href="qkeysequence.html">TQKeySequence</a>&nbsp;&amp;&nbsp;accel = 0, int&nbsp;id = -1, int&nbsp;index = -1 )
+</h3>
+The family of <a href="qmenudata.html#insertItem">insertItem</a>() functions inserts menu items into a
+popup menu or a menu bar.
+<p> A menu item is usually either a text string or a pixmap, both with
+an optional icon or keyboard accelerator. For special cases it is
+also possible to insert custom items (see <a href="qcustommenuitem.html">TQCustomMenuItem</a>) or
+even widgets into popup menus.
+<p> Some insertItem() members take a popup menu as an additional
+argument. Use this to insert submenus into existing menus or
+pulldown menus into a menu bar.
+<p> The number of insert functions may look confusing, but they are
+actually tquite simple to use.
+<p> This default version inserts a menu item with the text <em>text</em>,
+the accelerator key <em>accel</em>, an id and an optional index and
+connects it to the slot <em>member</em> in the object <em>receiver</em>.
+<p> Example:
+<pre>
+ TQMenuBar *mainMenu = new TQMenuBar;
+ <a href="qpopupmenu.html">TQPopupMenu</a> *fileMenu = new <a href="qpopupmenu.html">TQPopupMenu</a>;
+ fileMenu-&gt;<a href="qmenudata.html#insertItem">insertItem</a>( "New", myView, SLOT(newFile()), CTRL+Key_N );
+ fileMenu-&gt;<a href="qmenudata.html#insertItem">insertItem</a>( "Open", myView, SLOT(open()), CTRL+Key_O );
+ mainMenu-&gt;<a href="qmenudata.html#insertItem">insertItem</a>( "File", fileMenu );
+ </pre>
+
+<p> Not all insert functions take an object/slot parameter or an
+accelerator key. Use <a href="qmenudata.html#connectItem">connectItem</a>() and <a href="qmenudata.html#setAccel">setAccel</a>() on those items.
+<p> If you need to translate accelerators, use <a href="qobject.html#tr">tr</a>() with the text and
+accelerator. (For translations use a string <a href="qkeysequence.html">key
+ sequence</a>.):
+<pre>
+ fileMenu-&gt;insertItem( <a href="qobject.html#tr">tr</a>("Open"), myView, SLOT(open()),
+ <a href="qobject.html#tr">tr</a>("Ctrl+O") );
+ </pre>
+
+<p> In the example above, pressing Ctrl+O or selecting "Open" from the
+menu activates the myView->open() function.
+<p> Some insert functions take a <a href="qiconset.html">TQIconSet</a> parameter to specify the
+little menu item icon. Note that you can always pass a <a href="qpixmap.html">TQPixmap</a>
+object instead.
+<p> The <em>id</em> specifies the identification number associated with the
+menu item. Note that only positive values are valid, as a negative
+value will make TQt select a unique id for the item.
+<p> The <em>index</em> specifies the position in the menu. The menu item is
+appended at the end of the list if <em>index</em> is negative.
+<p> Note that keyboard accelerators in TQt are not application-global,
+instead they are bound to a certain top-level window. For example,
+accelerators in <a href="qpopupmenu.html">TQPopupMenu</a> items only work for menus that are
+associated with a certain window. This is true for popup menus
+that live in a menu bar since their accelerators will then be
+installed in the menu bar itself. This also applies to stand-alone
+popup menus that have a top-level widget in their <a href="qwidget.html#parentWidget">parentWidget</a>()
+chain. The menu will then install its accelerator object on that
+top-level widget. For all other cases use an independent <a href="qaccel.html">TQAccel</a>
+object.
+<p> <b>Warning:</b> Be careful when passing a literal 0 to <a href="qmenudata.html#insertItem">insertItem</a>()
+because some C++ compilers choose the wrong overloaded function.
+Cast the 0 to what you mean, e.g. <tt>(TQObject*)0</tt>.
+<p> <b>Warning:</b> On Mac OS X, items that connect to a slot that are inserted into a
+menubar will not function as we use the native menubar that knows nothing
+about signals or slots. Instead insert the items into a popup menu and
+insert the popup menu into the menubar. This may be fixed in a future TQt
+version.
+<p> Returns the allocated <a href="qmenudata.html#menu-identifier">menu identifier</a> number (<em>id</em> if <em>id</em> >= 0).
+<p> <p>See also <a href="qmenudata.html#removeItem">removeItem</a>(), <a href="qmenudata.html#changeItem">changeItem</a>(), <a href="qmenudata.html#setAccel">setAccel</a>(), <a href="qmenudata.html#connectItem">connectItem</a>(), <a href="qaccel.html">TQAccel</a>, and <a href="qnamespace-h.html">qnamespace.h</a>.
+
+<p>Examples: <a href="addressbook-example.html#x569">addressbook/mainwindow.cpp</a>, <a href="canvas-example.html#x2936">canvas/canvas.cpp</a>, <a href="menu-example.html#x1869">menu/menu.cpp</a>, <a href="qwerty-example.html#x371">qwerty/qwerty.cpp</a>, <a href="scrollview-example.html#x634">scrollview/scrollview.cpp</a>, <a href="showimg-example.html#x1327">showimg/showimg.cpp</a>, and <a href="sound-example.html#x2810">sound/sound.cpp</a>.
+<h3 class=fn>int <a name="insertItem-2"></a>TQMenuData::insertItem ( const&nbsp;<a href="qiconset.html">TQIconSet</a>&nbsp;&amp;&nbsp;icon, const&nbsp;<a href="qstring.html">TQString</a>&nbsp;&amp;&nbsp;text, const&nbsp;<a href="qobject.html">TQObject</a>&nbsp;*&nbsp;receiver, const&nbsp;char&nbsp;*&nbsp;member, const&nbsp;<a href="qkeysequence.html">TQKeySequence</a>&nbsp;&amp;&nbsp;accel = 0, int&nbsp;id = -1, int&nbsp;index = -1 )
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> Inserts a menu item with icon <em>icon</em>, text <em>text</em>, accelerator
+<em>accel</em>, optional id <em>id</em>, and optional <em>index</em> position. The
+menu item is connected it to the <em>receiver</em>'s <em>member</em> slot. The
+icon will be displayed to the left of the text in the item.
+<p> Returns the allocated <a href="qmenudata.html#menu-identifier">menu identifier</a> number (<em>id</em> if <em>id</em> >= 0).
+<p> <p>See also <a href="qmenudata.html#removeItem">removeItem</a>(), <a href="qmenudata.html#changeItem">changeItem</a>(), <a href="qmenudata.html#setAccel">setAccel</a>(), <a href="qmenudata.html#connectItem">connectItem</a>(), <a href="qaccel.html">TQAccel</a>, and <a href="qnamespace-h.html">qnamespace.h</a>.
+
+<h3 class=fn>int <a name="insertItem-3"></a>TQMenuData::insertItem ( const&nbsp;<a href="qpixmap.html">TQPixmap</a>&nbsp;&amp;&nbsp;pixmap, const&nbsp;<a href="qobject.html">TQObject</a>&nbsp;*&nbsp;receiver, const&nbsp;char&nbsp;*&nbsp;member, const&nbsp;<a href="qkeysequence.html">TQKeySequence</a>&nbsp;&amp;&nbsp;accel = 0, int&nbsp;id = -1, int&nbsp;index = -1 )
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> Inserts a menu item with pixmap <em>pixmap</em>, accelerator <em>accel</em>,
+optional id <em>id</em>, and optional <em>index</em> position. The menu item
+is connected it to the <em>receiver</em>'s <em>member</em> slot. The icon will
+be displayed to the left of the text in the item.
+<p> To look best when being highlighted as a menu item, the pixmap
+should provide a mask (see <a href="qpixmap.html#mask">TQPixmap::mask</a>()).
+<p> Returns the allocated <a href="qmenudata.html#menu-identifier">menu identifier</a> number (<em>id</em> if <em>id</em> >= 0).
+<p> <p>See also <a href="qmenudata.html#removeItem">removeItem</a>(), <a href="qmenudata.html#changeItem">changeItem</a>(), <a href="qmenudata.html#setAccel">setAccel</a>(), and <a href="qmenudata.html#connectItem">connectItem</a>().
+
+<h3 class=fn>int <a name="insertItem-4"></a>TQMenuData::insertItem ( const&nbsp;<a href="qiconset.html">TQIconSet</a>&nbsp;&amp;&nbsp;icon, const&nbsp;<a href="qpixmap.html">TQPixmap</a>&nbsp;&amp;&nbsp;pixmap, const&nbsp;<a href="qobject.html">TQObject</a>&nbsp;*&nbsp;receiver, const&nbsp;char&nbsp;*&nbsp;member, const&nbsp;<a href="qkeysequence.html">TQKeySequence</a>&nbsp;&amp;&nbsp;accel = 0, int&nbsp;id = -1, int&nbsp;index = -1 )
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> Inserts a menu item with icon <em>icon</em>, pixmap <em>pixmap</em>,
+accelerator <em>accel</em>, optional id <em>id</em>, and optional <em>index</em>
+position. The icon will be displayed to the left of the pixmap in
+the item. The item is connected to the <em>member</em> slot in the <em>receiver</em> object.
+<p> To look best when being highlighted as a menu item, the pixmap
+should provide a mask (see <a href="qpixmap.html#mask">TQPixmap::mask</a>()).
+<p> Returns the allocated <a href="qmenudata.html#menu-identifier">menu identifier</a> number (<em>id</em> if <em>id</em> >= 0).
+<p> <p>See also <a href="qmenudata.html#removeItem">removeItem</a>(), <a href="qmenudata.html#changeItem">changeItem</a>(), <a href="qmenudata.html#setAccel">setAccel</a>(), <a href="qmenudata.html#connectItem">connectItem</a>(), <a href="qaccel.html">TQAccel</a>, and <a href="qnamespace-h.html">qnamespace.h</a>.
+
+<h3 class=fn>int <a name="insertItem-5"></a>TQMenuData::insertItem ( const&nbsp;<a href="qstring.html">TQString</a>&nbsp;&amp;&nbsp;text, int&nbsp;id = -1, int&nbsp;index = -1 )
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> Inserts a menu item with text <em>text</em>, optional id <em>id</em>, and
+optional <em>index</em> position.
+<p> Returns the allocated <a href="qmenudata.html#menu-identifier">menu identifier</a> number (<em>id</em> if <em>id</em> >= 0).
+<p> <p>See also <a href="qmenudata.html#removeItem">removeItem</a>(), <a href="qmenudata.html#changeItem">changeItem</a>(), <a href="qmenudata.html#setAccel">setAccel</a>(), and <a href="qmenudata.html#connectItem">connectItem</a>().
+
+<h3 class=fn>int <a name="insertItem-6"></a>TQMenuData::insertItem ( const&nbsp;<a href="qiconset.html">TQIconSet</a>&nbsp;&amp;&nbsp;icon, const&nbsp;<a href="qstring.html">TQString</a>&nbsp;&amp;&nbsp;text, int&nbsp;id = -1, int&nbsp;index = -1 )
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> Inserts a menu item with icon <em>icon</em>, text <em>text</em>, optional id
+<em>id</em>, and optional <em>index</em> position. The icon will be displayed
+to the left of the text in the item.
+<p> Returns the allocated <a href="qmenudata.html#menu-identifier">menu identifier</a> number (<em>id</em> if <em>id</em> >= 0).
+<p> <p>See also <a href="qmenudata.html#removeItem">removeItem</a>(), <a href="qmenudata.html#changeItem">changeItem</a>(), <a href="qmenudata.html#setAccel">setAccel</a>(), and <a href="qmenudata.html#connectItem">connectItem</a>().
+
+<h3 class=fn>int <a name="insertItem-7"></a>TQMenuData::insertItem ( const&nbsp;<a href="qstring.html">TQString</a>&nbsp;&amp;&nbsp;text, <a href="qpopupmenu.html">TQPopupMenu</a>&nbsp;*&nbsp;popup, int&nbsp;id = -1, int&nbsp;index = -1 )
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> Inserts a menu item with text <em>text</em>, submenu <em>popup</em>, optional
+id <em>id</em>, and optional <em>index</em> position.
+<p> The <em>popup</em> must be deleted by the programmer or by its parent
+widget. It is not deleted when this menu item is removed or when
+the menu is deleted.
+<p> Returns the allocated <a href="qmenudata.html#menu-identifier">menu identifier</a> number (<em>id</em> if <em>id</em> >= 0).
+<p> <p>See also <a href="qmenudata.html#removeItem">removeItem</a>(), <a href="qmenudata.html#changeItem">changeItem</a>(), <a href="qmenudata.html#setAccel">setAccel</a>(), and <a href="qmenudata.html#connectItem">connectItem</a>().
+
+<h3 class=fn>int <a name="insertItem-8"></a>TQMenuData::insertItem ( const&nbsp;<a href="qiconset.html">TQIconSet</a>&nbsp;&amp;&nbsp;icon, const&nbsp;<a href="qstring.html">TQString</a>&nbsp;&amp;&nbsp;text, <a href="qpopupmenu.html">TQPopupMenu</a>&nbsp;*&nbsp;popup, int&nbsp;id = -1, int&nbsp;index = -1 )
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> Inserts a menu item with icon <em>icon</em>, text <em>text</em>, submenu <em>popup</em>, optional id <em>id</em>, and optional <em>index</em> position. The icon
+will be displayed to the left of the text in the item.
+<p> The <em>popup</em> must be deleted by the programmer or by its parent
+widget. It is not deleted when this menu item is removed or when
+the menu is deleted.
+<p> Returns the allocated <a href="qmenudata.html#menu-identifier">menu identifier</a> number (<em>id</em> if <em>id</em> >= 0).
+<p> <p>See also <a href="qmenudata.html#removeItem">removeItem</a>(), <a href="qmenudata.html#changeItem">changeItem</a>(), <a href="qmenudata.html#setAccel">setAccel</a>(), and <a href="qmenudata.html#connectItem">connectItem</a>().
+
+<h3 class=fn>int <a name="insertItem-9"></a>TQMenuData::insertItem ( const&nbsp;<a href="qpixmap.html">TQPixmap</a>&nbsp;&amp;&nbsp;pixmap, int&nbsp;id = -1, int&nbsp;index = -1 )
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> Inserts a menu item with pixmap <em>pixmap</em>, optional id <em>id</em>, and
+optional <em>index</em> position.
+<p> To look best when being highlighted as a menu item, the pixmap
+should provide a mask (see <a href="qpixmap.html#mask">TQPixmap::mask</a>()).
+<p> Returns the allocated <a href="qmenudata.html#menu-identifier">menu identifier</a> number (<em>id</em> if <em>id</em> >= 0).
+<p> <p>See also <a href="qmenudata.html#removeItem">removeItem</a>(), <a href="qmenudata.html#changeItem">changeItem</a>(), <a href="qmenudata.html#setAccel">setAccel</a>(), and <a href="qmenudata.html#connectItem">connectItem</a>().
+
+<h3 class=fn>int <a name="insertItem-a"></a>TQMenuData::insertItem ( const&nbsp;<a href="qiconset.html">TQIconSet</a>&nbsp;&amp;&nbsp;icon, const&nbsp;<a href="qpixmap.html">TQPixmap</a>&nbsp;&amp;&nbsp;pixmap, int&nbsp;id = -1, int&nbsp;index = -1 )
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> Inserts a menu item with icon <em>icon</em>, pixmap <em>pixmap</em>, optional
+id <em>id</em>, and optional <em>index</em> position. The icon will be
+displayed to the left of the pixmap in the item.
+<p> Returns the allocated <a href="qmenudata.html#menu-identifier">menu identifier</a> number (<em>id</em> if <em>id</em> >= 0).
+<p> <p>See also <a href="qmenudata.html#removeItem">removeItem</a>(), <a href="qmenudata.html#changeItem">changeItem</a>(), <a href="qmenudata.html#setAccel">setAccel</a>(), and <a href="qmenudata.html#connectItem">connectItem</a>().
+
+<h3 class=fn>int <a name="insertItem-b"></a>TQMenuData::insertItem ( const&nbsp;<a href="qpixmap.html">TQPixmap</a>&nbsp;&amp;&nbsp;pixmap, <a href="qpopupmenu.html">TQPopupMenu</a>&nbsp;*&nbsp;popup, int&nbsp;id = -1, int&nbsp;index = -1 )
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> Inserts a menu item with pixmap <em>pixmap</em>, submenu <em>popup</em>,
+optional id <em>id</em>, and optional <em>index</em> position.
+<p> The <em>popup</em> must be deleted by the programmer or by its parent
+widget. It is not deleted when this menu item is removed or when
+the menu is deleted.
+<p> Returns the allocated <a href="qmenudata.html#menu-identifier">menu identifier</a> number (<em>id</em> if <em>id</em> >= 0).
+<p> <p>See also <a href="qmenudata.html#removeItem">removeItem</a>(), <a href="qmenudata.html#changeItem">changeItem</a>(), <a href="qmenudata.html#setAccel">setAccel</a>(), and <a href="qmenudata.html#connectItem">connectItem</a>().
+
+<h3 class=fn>int <a name="insertItem-c"></a>TQMenuData::insertItem ( const&nbsp;<a href="qiconset.html">TQIconSet</a>&nbsp;&amp;&nbsp;icon, const&nbsp;<a href="qpixmap.html">TQPixmap</a>&nbsp;&amp;&nbsp;pixmap, <a href="qpopupmenu.html">TQPopupMenu</a>&nbsp;*&nbsp;popup, int&nbsp;id = -1, int&nbsp;index = -1 )
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> Inserts a menu item with icon <em>icon</em>, pixmap <em>pixmap</em> submenu <em>popup</em>, optional id <em>id</em>, and optional <em>index</em> position. The icon
+will be displayed to the left of the pixmap in the item.
+<p> The <em>popup</em> must be deleted by the programmer or by its parent
+widget. It is not deleted when this menu item is removed or when
+the menu is deleted.
+<p> Returns the allocated <a href="qmenudata.html#menu-identifier">menu identifier</a> number (<em>id</em> if <em>id</em> >= 0).
+<p> <p>See also <a href="qmenudata.html#removeItem">removeItem</a>(), <a href="qmenudata.html#changeItem">changeItem</a>(), <a href="qmenudata.html#setAccel">setAccel</a>(), and <a href="qmenudata.html#connectItem">connectItem</a>().
+
+<h3 class=fn>int <a name="insertItem-d"></a>TQMenuData::insertItem ( <a href="qwidget.html">TQWidget</a>&nbsp;*&nbsp;widget, int&nbsp;id = -1, int&nbsp;index = -1 )
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> Inserts a menu item that consists of the widget <em>widget</em> with
+optional id <em>id</em>, and optional <em>index</em> position.
+<p> Ownership of <em>widget</em> is transferred to the popup menu or to the
+menu bar.
+<p> Theoretically, any widget can be inserted into a popup menu. In
+practice, this only makes sense with certain widgets.
+<p> If a widget is not focus-enabled (see
+<a href="qwidget.html#isFocusEnabled">TQWidget::isFocusEnabled</a>()), the menu treats it as a separator;
+this means that the item is not selectable and will never get
+focus. In this way you can, for example, simply insert a <a href="qlabel.html">TQLabel</a> if
+you need a popup menu with a title.
+<p> If the widget is focus-enabled it will get focus when the user
+traverses the popup menu with the arrow keys. If the widget does
+not accept <tt>ArrowUp</tt> and <tt>ArrowDown</tt> in its key event handler,
+the focus will move back to the menu when the respective arrow key
+is hit one more time. This works with a <a href="qlineedit.html">TQLineEdit</a>, for example. If
+the widget accepts the arrow key itself, it must also provide the
+possibility to put the focus back on the menu again by calling
+<a href="qwidget.html#focusNextPrevChild">TQWidget::focusNextPrevChild</a>(). Futhermore, if the embedded widget
+closes the menu when the user made a selection, this can be done
+safely by calling:
+<pre>
+ if ( <a href="qwidget.html#isVisible">isVisible</a>() &amp;&amp;
+ <a href="qwidget.html#parentWidget">parentWidget</a>() &amp;&amp;
+ <a href="qwidget.html#parentWidget">parentWidget</a>()-&gt;inherits("TQPopupMenu") )
+ <a href="qwidget.html#parentWidget">parentWidget</a>()-&gt;close();
+ </pre>
+
+<p> Returns the allocated <a href="qmenudata.html#menu-identifier">menu identifier</a> number (<em>id</em> if <em>id</em> >= 0).
+<p> <p>See also <a href="qmenudata.html#removeItem">removeItem</a>().
+
+<h3 class=fn>int <a name="insertItem-e"></a>TQMenuData::insertItem ( const&nbsp;<a href="qiconset.html">TQIconSet</a>&nbsp;&amp;&nbsp;icon, <a href="qcustommenuitem.html">TQCustomMenuItem</a>&nbsp;*&nbsp;custom, int&nbsp;id = -1, int&nbsp;index = -1 )
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> Inserts a custom menu item <em>custom</em> with an <em>icon</em> and with
+optional id <em>id</em>, and optional <em>index</em> position.
+<p> This only works with popup menus. It is not supported for menu
+bars. Ownership of <em>custom</em> is transferred to the popup menu.
+<p> If you want to connect a custom item to a slot, use <a href="qmenudata.html#connectItem">connectItem</a>().
+<p> Returns the allocated <a href="qmenudata.html#menu-identifier">menu identifier</a> number (<em>id</em> if <em>id</em> >= 0).
+<p> <p>See also <a href="qmenudata.html#connectItem">connectItem</a>(), <a href="qmenudata.html#removeItem">removeItem</a>(), and <a href="qcustommenuitem.html">TQCustomMenuItem</a>.
+
+<h3 class=fn>int <a name="insertItem-f"></a>TQMenuData::insertItem ( <a href="qcustommenuitem.html">TQCustomMenuItem</a>&nbsp;*&nbsp;custom, int&nbsp;id = -1, int&nbsp;index = -1 )
+</h3>
+This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
+<p> Inserts a custom menu item <em>custom</em> with optional id <em>id</em>, and
+optional <em>index</em> position.
+<p> This only works with popup menus. It is not supported for menu
+bars. Ownership of <em>custom</em> is transferred to the popup menu.
+<p> If you want to connect a custom item to a slot, use <a href="qmenudata.html#connectItem">connectItem</a>().
+<p> Returns the allocated <a href="qmenudata.html#menu-identifier">menu identifier</a> number (<em>id</em> if <em>id</em> >= 0).
+<p> <p>See also <a href="qmenudata.html#connectItem">connectItem</a>(), <a href="qmenudata.html#removeItem">removeItem</a>(), and <a href="qcustommenuitem.html">TQCustomMenuItem</a>.
+
+<h3 class=fn>int <a name="insertSeparator"></a>TQMenuData::insertSeparator ( int&nbsp;index = -1 )
+</h3>
+Inserts a separator at position <em>index</em>, and returns the <a href="qmenudata.html#menu-identifier">menu identifier</a>
+number allocated to it. The separator becomes the last menu item if
+<em>index</em> is negative.
+<p> In a popup menu a separator is rendered as a horizontal line. In a
+<a href="motif-extension.html#Motif">Motif</a> menu bar a separator is spacing, so the rest of the items
+(normally just "Help") are drawn right-justified. In a Windows
+menu bar separators are ignored (to comply with the Windows style
+guidelines).
+
+<p>Examples: <a href="addressbook-example.html#x570">addressbook/mainwindow.cpp</a>, <a href="menu-example.html#x1870">menu/menu.cpp</a>, <a href="progress-example.html#x69">progress/progress.cpp</a>, <a href="qwerty-example.html#x372">qwerty/qwerty.cpp</a>, <a href="scrollview-example.html#x635">scrollview/scrollview.cpp</a>, <a href="showimg-example.html#x1328">showimg/showimg.cpp</a>, and <a href="sound-example.html#x2811">sound/sound.cpp</a>.
+<h3 class=fn>bool <a name="isDefaultUp"></a>TQMenuBar::isDefaultUp () const
+</h3><p>Returns the popup orientation.
+See the <a href="qmenubar.html#defaultUp-prop">"defaultUp"</a> property for details.
+<h3 class=fn>bool <a name="isItemEnabled"></a>TQMenuData::isItemEnabled ( int&nbsp;id ) const
+</h3>
+Returns TRUE if the item with identifier <em>id</em> is enabled;
+otherwise returns FALSE
+<p> <p>See also <a href="qmenudata.html#setItemEnabled">setItemEnabled</a>() and <a href="qmenudata.html#isItemVisible">isItemVisible</a>().
+
+<h3 class=fn>bool <a name="isItemVisible"></a>TQMenuData::isItemVisible ( int&nbsp;id ) const
+</h3>
+Returns TRUE if the menu item with the id <em>id</em> is visible;
+otherwise returns FALSE.
+<p> <p>See also <a href="qmenudata.html#setItemVisible">setItemVisible</a>().
+
+<h3 class=fn>void <a name="menuContentsChanged"></a>TQMenuBar::menuContentsChanged ()<tt> [virtual protected]</tt>
+</h3>
+Recomputes the menu bar's display data according to the new
+contents.
+<p> You should never need to call this; it is called automatically by
+<a href="qmenudata.html">TQMenuData</a> whenever it needs to be called.
+
+<p>Reimplemented from <a href="qmenudata.html#menuContentsChanged">TQMenuData</a>.
+<h3 class=fn>void <a name="menuStateChanged"></a>TQMenuBar::menuStateChanged ()<tt> [virtual protected]</tt>
+</h3>
+Recomputes the menu bar's display data according to the new state.
+<p> You should never need to call this; it is called automatically by
+<a href="qmenudata.html">TQMenuData</a> whenever it needs to be called.
+
+<p>Reimplemented from <a href="qmenudata.html#menuStateChanged">TQMenuData</a>.
+<h3 class=fn>void <a name="removeItem"></a>TQMenuData::removeItem ( int&nbsp;id )
+</h3>
+
+<p> Removes the menu item that has the identifier <em>id</em>.
+<p> <p>See also <a href="qmenudata.html#removeItemAt">removeItemAt</a>() and <a href="qmenudata.html#clear">clear</a>().
+
+<p>Example: <a href="canvas-chart-example.html#x2885">chart/chartform.cpp</a>.
+<h3 class=fn><a href="qmenubar.html#Separator-enum">Separator</a> <a name="separator"></a>TQMenuBar::separator () const
+</h3><p>Returns in which cases a menubar sparator is drawn.
+See the <a href="qmenubar.html#separator-prop">"separator"</a> property for details.
+<h3 class=fn>void <a name="setDefaultUp"></a>TQMenuBar::setDefaultUp ( bool )
+</h3><p>Sets the popup orientation.
+See the <a href="qmenubar.html#defaultUp-prop">"defaultUp"</a> property for details.
+<h3 class=fn>void <a name="setItemEnabled"></a>TQMenuData::setItemEnabled ( int&nbsp;id, bool&nbsp;enable )
+</h3>
+If <em>enable</em> is TRUE, enables the menu item with identifier <em>id</em>;
+otherwise disables the menu item with identifier <em>id</em>.
+<p> <p>See also <a href="qmenudata.html#isItemEnabled">isItemEnabled</a>().
+
+<p>Examples: <a href="mdi-example.html#x2033">mdi/application.cpp</a>, <a href="menu-example.html#x1873">menu/menu.cpp</a>, <a href="progress-example.html#x72">progress/progress.cpp</a>, and <a href="showimg-example.html#x1331">showimg/showimg.cpp</a>.
+<h3 class=fn>void <a name="setItemVisible"></a>TQMenuData::setItemVisible ( int&nbsp;id, bool&nbsp;visible )
+</h3>
+If <em>visible</em> is TRUE, shows the menu item with id <em>id</em>; otherwise
+hides the menu item with id <em>id</em>.
+<p> <p>See also <a href="qmenudata.html#isItemVisible">isItemVisible</a>() and <a href="qmenudata.html#isItemEnabled">isItemEnabled</a>().
+
+<h3 class=fn>void <a name="setSeparator"></a>TQMenuBar::setSeparator ( <a href="qmenubar.html#Separator-enum">Separator</a>&nbsp;when )<tt> [virtual]</tt>
+</h3><p>Sets in which cases a menubar sparator is drawn to <em>when</em>.
+See the <a href="qmenubar.html#separator-prop">"separator"</a> property for details.
+<h3 class=fn>void <a name="show"></a>TQMenuBar::show ()<tt> [virtual]</tt>
+</h3>
+Reimplements <a href="qwidget.html#show">TQWidget::show</a>() in order to set up the correct
+keyboard accelerators and to raise itself to the top of the widget
+stack.
+
+<p>Example: <a href="grapher-nsplugin-example.html#x2746">grapher/grapher.cpp</a>.
+<p>Reimplemented from <a href="qwidget.html#show">TQWidget</a>.
+<hr><h2>Property Documentation</h2>
+<h3 class=fn>bool <a name="defaultUp-prop"></a>defaultUp</h3>
+<p>This property holds the popup orientation.
+<p>The default popup orientation. By default, menus pop "down" the
+screen. By setting the property to TRUE, the menu will pop "up".
+You might call this for menus that are <em>below</em> the document to
+which they refer.
+<p> If the menu would not fit on the screen, the other direction is
+used automatically.
+
+<p>Set this property's value with <a href="#setDefaultUp">setDefaultUp</a>() and get this property's value with <a href="#isDefaultUp">isDefaultUp</a>().
+<h3 class=fn><a href="qmenubar.html#Separator-enum">Separator</a> <a name="separator-prop"></a>separator</h3>
+<p>This property holds in which cases a menubar sparator is drawn.
+<p><b>This property is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
+<p>
+<p>Set this property's value with <a href="#setSeparator">setSeparator</a>() and get this property's value with <a href="#separator">separator</a>().
+<!-- eof -->
+<hr><p>
+This file is part of the <a href="index.html">TQt toolkit</a>.
+Copyright &copy; 1995-2007
+<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
+<table width=100% cellspacing=0 border=0><tr>
+<td>Copyright &copy; 2007
+<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
+<td align=right><div align=right>TQt 3.3.8</div>
+</table></div></address></body>
+</html>