qpopupmenu.html
来自「QT 下载资料仅供参考」· HTML 代码 · 共 781 行 · 第 1/4 页
HTML
781 行
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><!-- /home/reggie/tmp/qt-3.0-reggie-5401/qt-x11-commercial-3.0.5/src/widgets/qpopupmenu.cpp:126 --><html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>QPopupMenu Class</title><style type="text/css"><!--h3.fn,span.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 Classes</font></a> | <a href="mainclasses.html"><font color="#004faf">Main Classes</font></a> | <a href="annotated.html"><font color="#004faf">Annotated</font></a> | <a href="groups.html"><font color="#004faf">Grouped 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>QPopupMenu Class Reference</h1><p>The QPopupMenu class provides a popup menu widget.<a href="#details">More...</a><p><tt>#include <<a href="qpopupmenu-h.html">qpopupmenu.h</a>></tt><p>Inherits <a href="qframe.html">QFrame</a> and <a href="qmenudata.html">QMenuData</a>.<p><a href="qpopupmenu-members.html">List of all member functions.</a><h2>Public Members</h2><ul><li><div class=fn><a href="#QPopupMenu"><b>QPopupMenu</b></a> ( QWidget * parent = 0, const char * name = 0 )</div></li><li><div class=fn><a href="#~QPopupMenu"><b>~QPopupMenu</b></a> ()</div></li><li><div class=fn>void <a href="#popup"><b>popup</b></a> ( const QPoint & pos, int indexAtPoint = -1 )</div></li><li><div class=fn>virtual void <a href="#updateItem"><b>updateItem</b></a> ( int id )</div></li><li><div class=fn>virtual void <a href="#setCheckable"><b>setCheckable</b></a> ( bool )</div></li><li><div class=fn>bool <a href="#isCheckable"><b>isCheckable</b></a> () const</div></li><li><div class=fn>int <a href="#exec"><b>exec</b></a> ()</div></li><li><div class=fn>int <a href="#exec-2"><b>exec</b></a> ( const QPoint & pos, int indexAtPoint = 0 )</div></li><li><div class=fn>virtual void <a href="#setActiveItem"><b>setActiveItem</b></a> ( int i )</div></li><li><div class=fn>int <a href="#idAt"><b>idAt</b></a> ( int index ) const</div></li><li><div class=fn>int <a href="#idAt-2"><b>idAt</b></a> ( const QPoint & pos ) const</div></li><li><div class=fn>int <a href="#insertTearOffHandle"><b>insertTearOffHandle</b></a> ( int id = -1, int index = -1 )</div></li></ul><h2>Signals</h2><ul><li><div class=fn>void <a href="#activated"><b>activated</b></a> ( int id )</div></li><li><div class=fn>void <a href="#highlighted"><b>highlighted</b></a> ( int id )</div></li><li><div class=fn>void <a href="#aboutToShow"><b>aboutToShow</b></a> ()</div></li><li><div class=fn>void <a href="#aboutToHide"><b>aboutToHide</b></a> ()</div></li></ul><h2>Important Inherited Members</h2><ul><li><div class=fn>int <a href="#insertItem"><b>insertItem</b></a> ( const QString & text, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )</div></li><li><div class=fn>int <a href="#insertItem-2"><b>insertItem</b></a> ( const QIconSet & icon, const QString & text, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )</div></li><li><div class=fn>int <a href="#insertItem-3"><b>insertItem</b></a> ( const QPixmap & pixmap, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )</div></li><li><div class=fn>int <a href="#insertItem-4"><b>insertItem</b></a> ( const QIconSet & icon, const QPixmap & pixmap, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )</div></li><li><div class=fn>int <a href="#insertItem-5"><b>insertItem</b></a> ( const QString & text, int id = -1, int index = -1 )</div></li><li><div class=fn>int <a href="#insertItem-6"><b>insertItem</b></a> ( const QIconSet & icon, const QString & text, int id = -1, int index = -1 )</div></li><li><div class=fn>int <a href="#insertItem-7"><b>insertItem</b></a> ( const QString & text, QPopupMenu * popup, int id = -1, int index = -1 )</div></li><li><div class=fn>int <a href="#insertItem-8"><b>insertItem</b></a> ( const QIconSet & icon, const QString & text, QPopupMenu * popup, int id = -1, int index = -1 )</div></li><li><div class=fn>int <a href="#insertItem-9"><b>insertItem</b></a> ( const QPixmap & pixmap, int id = -1, int index = -1 )</div></li><li><div class=fn>int <a href="#insertItem-a"><b>insertItem</b></a> ( const QIconSet & icon, const QPixmap & pixmap, int id = -1, int index = -1 )</div></li><li><div class=fn>int <a href="#insertItem-b"><b>insertItem</b></a> ( const QPixmap & pixmap, QPopupMenu * popup, int id = -1, int index = -1 )</div></li><li><div class=fn>int <a href="#insertItem-c"><b>insertItem</b></a> ( const QIconSet & icon, const QPixmap & pixmap, QPopupMenu * popup, int id = -1, int index = -1 )</div></li><li><div class=fn>int <a href="#insertItem-d"><b>insertItem</b></a> ( QWidget * widget, int id = -1, int index = -1 )</div></li><li><div class=fn>int <a href="#insertItem-e"><b>insertItem</b></a> ( const QIconSet & icon, QCustomMenuItem * custom, int id = -1, int index = -1 )</div></li><li><div class=fn>int <a href="#insertItem-f"><b>insertItem</b></a> ( QCustomMenuItem * custom, int id = -1, int index = -1 )</div></li><li><div class=fn>int <a href="#insertSeparator"><b>insertSeparator</b></a> ( int index = -1 )</div></li><li><div class=fn>void <a href="#removeItem"><b>removeItem</b></a> ( int id )</div></li><li><div class=fn>void <a href="#removeItemAt"><b>removeItemAt</b></a> ( int index )</div></li><li><div class=fn>void <a href="#clear"><b>clear</b></a> ()</div></li><li><div class=fn>QKeySequence <a href="#accel"><b>accel</b></a> ( int id ) const</div></li><li><div class=fn>void <a href="#setAccel"><b>setAccel</b></a> ( const QKeySequence & key, int id )</div></li><li><div class=fn>QIconSet * <a href="#iconSet"><b>iconSet</b></a> ( int id ) const</div></li><li><div class=fn>QString <a href="#text"><b>text</b></a> ( int id ) const</div></li><li><div class=fn>QPixmap * <a href="#pixmap"><b>pixmap</b></a> ( int id ) const</div></li><li><div class=fn>void <a href="#setWhatsThis"><b>setWhatsThis</b></a> ( int id, const QString & text )</div></li><li><div class=fn>QString <a href="#whatsThis"><b>whatsThis</b></a> ( int id ) const</div></li><li><div class=fn>void <a href="#changeItem"><b>changeItem</b></a> ( int id, const QString & text )</div></li><li><div class=fn>void <a href="#changeItem-2"><b>changeItem</b></a> ( int id, const QPixmap & pixmap )</div></li><li><div class=fn>void <a href="#changeItem-3"><b>changeItem</b></a> ( int id, const QIconSet & icon, const QString & text )</div></li><li><div class=fn>void <a href="#changeItem-4"><b>changeItem</b></a> ( int id, const QIconSet & icon, const QPixmap & pixmap )</div></li><li><div class=fn>bool <a href="#isItemEnabled"><b>isItemEnabled</b></a> ( int id ) const</div></li><li><div class=fn>void <a href="#setItemEnabled"><b>setItemEnabled</b></a> ( int id, bool enable )</div></li><li><div class=fn>bool <a href="#isItemChecked"><b>isItemChecked</b></a> ( int id ) const</div></li><li><div class=fn>void <a href="#setItemChecked"><b>setItemChecked</b></a> ( int id, bool check )</div></li><li><div class=fn>bool <a href="#connectItem"><b>connectItem</b></a> ( int id, const QObject * receiver, const char * member )</div></li><li><div class=fn>bool <a href="#disconnectItem"><b>disconnectItem</b></a> ( int id, const QObject * receiver, const char * member )</div></li><li><div class=fn>bool <a href="#setItemParameter"><b>setItemParameter</b></a> ( int id, int param )</div></li><li><div class=fn>int <a href="#itemParameter"><b>itemParameter</b></a> ( int id ) const</div></li></ul><h2>Properties</h2><ul><li><div class=fn>bool <a href="#checkable-prop"><b>checkable</b></a> - whether the display of check marks on menu items is enabled</div></li></ul><h2>Protected Members</h2><ul><li><div class=fn>int <a href="#itemHeight"><b>itemHeight</b></a> ( int row ) const</div></li><li><div class=fn>int <a href="#itemHeight-2"><b>itemHeight</b></a> ( QMenuItem * mi ) const</div></li><li><div class=fn>void <a href="#drawItem"><b>drawItem</b></a> ( QPainter * p, int tab_, QMenuItem * mi, bool act, int x, int y, int w, int h )</div></li><li><div class=fn>virtual void <a href="#drawContents"><b>drawContents</b></a> ( QPainter * p )</div></li><li><div class=fn>int <a href="#columns"><b>columns</b></a> () const</div></li></ul><hr><a name="details"></a><h2>Detailed Description</h2>The QPopupMenu class provides a popup menu widget.<p> <p> A popup menu widget is a selection menu. It can be either a pull-downmenu in a menu bar or a standalone context (popup) menu. Pull-down menusare shown by the menu bar when the user clicks on the respectiveitem or hits the specified shortcut key. Use <a href="qmenudata.html#insertItem">QMenuBar::insertItem</a>()to insert a popup menu into a menu bar. Show a context menu eitherasynchronously with <a href="#popup">popup</a>() or synchronously with <a href="#exec">exec</a>().<p> Technically, a popup menu consists of a list of menu items. You additems with <a href="qmenudata.html#insertItem">insertItem</a>(). An item is either a string, a pixmap or acustom item that provides its own drawing function (see<a href="qcustommenuitem.html">QCustomMenuItem</a>). In addition, items can have an optional icon drawnon the very left side and an accelerator key such as "Ctrl+X".<p> There are three kinds of menu items: separators, menu items that performan action and menu items that show a submenu. Separators are insertedwith <a href="qmenudata.html#insertSeparator">insertSeparator</a>(). For submenus, you pass a pointer to aQPopupMenu in your call to insertItem(). All other items areconsidered action items.<p> When inserting action items you usually specify a receiver and aslot. The receiver will be notifed whenever the item isselected. In addition, QPopupMenu provides two signals, <a href="#activated">activated</a>()and <a href="#highlighted">highlighted</a>(), which signal the identifier of the respective menuitem. It is sometimes practical to connect several items to oneslot. To distinguish between them, specify a slot that takes aninteger argument and use <a href="qmenudata.html#setItemParameter">setItemParameter</a>() to associate a uniquevalue with each item.<p> You clear a popup menu with <a href="qmenudata.html#clear">clear</a>() and remove single items with<a href="qmenudata.html#removeItem">removeItem</a>() or <a href="qmenudata.html#removeItemAt">removeItemAt</a>().<p> A popup menu can display check marks for certain items when enabledwith <a href="#setCheckable">setCheckable</a>(TRUE). You check or uncheck items with<a href="qmenudata.html#setItemChecked">setItemChecked</a>().<p> Items are either enabled or disabled. You toggle their state with<a href="qmenudata.html#setItemEnabled">setItemEnabled</a>(). Just before a popup menu becomes visible, itemits the <a href="#aboutToShow">aboutToShow</a>() signal. You can use this signal to set thecorrect enabled/disabled states of all menu items before the usersees it. The corresponding <a href="#aboutToHide">aboutToHide</a>() signal is emitted when themenu hides again.<p> You can provide What's This? help for single menu items with<a href="qmenudata.html#setWhatsThis">setWhatsThis</a>(). See <a href="qwhatsthis.html">QWhatsThis</a> for general information about thiskind of lightweight <a href="helpsystem.html#online-help">online help</a>.<p> For ultimate flexibility, you can also add entire widgets as itemsinto a popup menu (for example, a color selector).<p> A QPopupMenu can also provide a tear-off menu. A tear-off menu is atop-level window that contains a copy of the menu. This makes itpossible for the user to "tear off" frequently used menus andposition them in a convenient place on the screen. If you want thatfunctionality for a certain menu, insert a tear-off handle with<a href="#insertTearOffHandle">insertTearOffHandle</a>(). If you want to include custom widgets in atear-off menu, you should connect to the popup menu's signal (using<a href="qmenudata.html#connectItem">connectItem</a>() and the item ID that insertTearOffHandle() returns),and add the custom widgets you want to include. When using tear-offmenus, bear in mind that the concept isn't typically used onMicrosoft Windows so users may not be familiar with it. Considerusing a <a href="qtoolbar.html">QToolBar</a> instead.<p> menu/menu.cpp is a typical example of <a href="qmenubar.html">QMenuBar</a> and QPopupMenu use.<p> <p> <img src=qpopmenu-m.png> <img src=qpopmenu-w.png><p> <p>See also <a href="qmenubar.html">QMenuBar</a>, <a href="guibooks.html#fowler">GUI Design Handbook: Menu, Drop-Down and Pop-Up</a>, <a href="application.html">Main Window and Related Classes</a> and <a href="basic.html">Basic Widgets</a>.<hr><h2>Member Function Documentation</h2><h3 class=fn><a name="QPopupMenu"></a>QPopupMenu::QPopupMenu ( <a href="qwidget.html">QWidget</a> * parent = 0, const char * name = 0 )</h3>Constructs a popup menu with <em>parent</em> as a parent and <em>name</em> asobject name.<p> Although a popup menu is always a top-level widget, if a parent ispassed the popup menu will be deleted when that parent is destroyed(as with any other <a href="qobject.html">QObject</a>).<p> <h3 class=fn><a name="~QPopupMenu"></a>QPopupMenu::~QPopupMenu ()</h3>Destroys the popup menu.<h3 class=fn>void <a name="aboutToHide"></a>QPopupMenu::aboutToHide ()<tt> [signal]</tt></h3> <p> This signal is emitted just before the popup menu is hidden after ithas been displayed.<p> <b>Warning:</b> Do not open a widget in a slot connected to this signal.⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?