QPopupMenu(3qt)

📦 version 3.3.8b, in fedora 43, fedora 44

💖 QPopupMenu 💖

okay so this is the manual page for QPopupMenu, straight out of the Qt 3 docs (that's the 3qt manual, bestie, iykyk). It's a popup menu widget and it's genuinely iconic, so let's get into it. ✨

🌸 NAME 🌸

QPopupMenu — Popup menu widget. That's it, that's the whole vibe. 🎀

✨ SYNOPSIS ✨

#include <qpopupmenu.h>

She Inherits QFrame and QMenuData. Two parents, one queen. 👑

🫶 Public Members 🫶

QPopupMenu ( QWidget * parent = 0, const char * name = 0 )
~QPopupMenu ()
void popup ( const QPoint & pos, int indexAtPoint = -1 )
virtual void updateItem ( int id )
virtual void setCheckable ( bool )
bool isCheckable () const
int exec ()
int exec ( const QPoint & pos, int indexAtPoint = 0 )
virtual void setActiveItem ( int i )
int idAt ( int index ) const
int idAt ( const QPoint & pos ) const
int insertTearOffHandle ( int id = -1, int index = -1 )

🦋 Signals 🦋

void activated ( int id )
void highlighted ( int id )
void aboutToShow ()
void aboutToHide ()

💜 Important Inherited Members 💜

These are the ones you'll actually be calling fr fr:

int insertItem ( const QString & text, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )
int insertItem ( const QIconSet & icon, const QString & text, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )
int insertItem ( const QPixmap & pixmap, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )
int insertItem ( const QIconSet & icon, const QPixmap & pixmap, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )
int insertItem ( const QString & text, int id = -1, int index = -1 )
int insertItem ( const QIconSet & icon, const QString & text, int id = -1, int index = -1 )
int insertItem ( const QString & text, QPopupMenu * popup, int id = -1, int index = -1 )
int insertItem ( const QIconSet & icon, const QString & text, QPopupMenu * popup, int id = -1, int index = -1 )
int insertItem ( const QPixmap & pixmap, int id = -1, int index = -1 )
int insertItem ( const QIconSet & icon, const QPixmap & pixmap, int id = -1, int index = -1 )
int insertItem ( const QPixmap & pixmap, QPopupMenu * popup, int id = -1, int index = -1 )
int insertItem ( const QIconSet & icon, const QPixmap & pixmap, QPopupMenu * popup, int id = -1, int index = -1 )
int insertItem ( QWidget * widget, int id = -1, int index = -1 )
int insertItem ( const QIconSet & icon, QCustomMenuItem * custom, int id = -1, int index = -1 )
int insertItem ( QCustomMenuItem * custom, int id = -1, int index = -1 )
int insertSeparator ( int index = -1 )
void removeItem ( int id )
void removeItemAt ( int index )
void clear ()
QKeySequence accel ( int id ) const
void setAccel ( const QKeySequence & key, int id )
QIconSet * iconSet ( int id ) const
QString text ( int id ) const
QPixmap * pixmap ( int id ) const
void setWhatsThis ( int id, const QString & text )
QString whatsThis ( int id ) const
void changeItem ( int id, const QString & text )
void changeItem ( int id, const QPixmap & pixmap )
void changeItem ( int id, const QIconSet & icon, const QString & text )
void changeItem ( int id, const QIconSet & icon, const QPixmap & pixmap )
bool isItemEnabled ( int id ) const
void setItemEnabled ( int id, bool enable )
bool isItemChecked ( int id ) const
void setItemChecked ( int id, bool check )
bool isItemVisible ( int id ) const
void setItemVisible ( int id, bool visible )
bool connectItem ( int id, const QObject * receiver, const char * member )
bool disconnectItem ( int id, const QObject * receiver, const char * member )
bool setItemParameter ( int id, int param )
int itemParameter ( int id ) const

⭐ Properties ⭐

bool checkable — whether the display of check marks on menu items is enabled. Little checkmarks, the moment. ✅

🌈 Protected Members 🌈

int itemHeight ( int row ) const
int itemHeight ( QMenuItem * mi ) const
void drawItem ( QPainter * p, int tab_, QMenuItem * mi, bool act, int x, int y, int w, int h )
virtual void drawContents ( QPainter * p )
int columns () const

💅 DESCRIPTION 💅

The QPopupMenu class provides a popup menu widget. slay

A popup menu widget is a selection menu. It can be either a pull-down menu in a menu bar or a standalone context (popup) menu. Pull-down menus are shown by the menu bar when the user clicks on the respective item or presses the specified shortcut key. Use QMenuBar::insertItem() to insert a popup menu into a menu bar. Show a context menu either asynchronously with popup() or synchronously with exec().

Technically, a popup menu consists of a list of menu items. You add items with insertItem(). An item is either a string, a pixmap or a custom item that provides its own drawing function (see QCustomMenuItem). In addition, items can have an optional icon drawn on the very left side and an accelerator key such as " Ctrl+X".

not me noticing the quote placement in " Ctrl+X" — that's exactly how the original has it, keep it, don't touch it 🙈

There are three kinds of menu items: separators, menu items that perform an action and menu items that show a submenu. Separators are inserted with insertSeparator(). For submenus, you pass a pointer to a QPopupMenu in your call to insertItem(). All other items are considered action items.

When inserting action items you usually specify a receiver and a slot. The receiver will be notifed whenever the item is selected. In addition, QPopupMenu provides two signals, activated() and highlighted(), which signal the identifier of the respective menu item. It is sometimes practical to connect several items to one slot. To distinguish between them, specify a slot that takes an integer argument and use setItemParameter() to associate a unique value with each item.

You clear a popup menu with clear() and remove single items with removeItem() or removeItemAt().

A popup menu can display check marks for certain items when enabled with setCheckable(TRUE). You check or uncheck items with setItemChecked().

Items are either enabled or disabled. You toggle their state with setItemEnabled(). Just before a popup menu becomes visible, it emits the aboutToShow() signal. You can use this signal to set the correct enabled/disabled states of all menu items before the user sees it. The corresponding aboutToHide() signal is emitted when the menu hides again.

You can provide What's This? help for single menu items with setWhatsThis(). See QWhatsThis for general information about this kind of lightweight online help.

For ultimate flexibility, you can also add entire widgets as items into a popup menu (for example, a color selector). 🎨

A QPopupMenu can also provide a tear-off menu. A tear-off menu is a top-level window that contains a copy of the menu. This makes it possible for the user to "tear off" frequently used menus and position them in a convenient place on the screen. If you want that functionality for a certain menu, insert a tear-off handle with insertTearOffHandle(). When using tear-off menus, bear in mind that the concept isn't typically used on Microsoft Windows so users may not be familiar with it. Consider using a QToolBar instead. Tear-off menus cannot contain custom widgets; if the original menu contains a custom widget item, this item is omitted.

⚠️ bestie, read that again: tear-off menus cannot contain custom widgets, and if your original menu has a custom widget item in it, that item gets omitted. No cap.

menu/menu.cpp is an example of QMenuBar and QPopupMenu use.

[Image Omitted]

See also QMenuBar, GUI Design Handbook: Menu, Drop-Down and Pop-Up, Main Window and Related Classes, and Basic Widgets.

📖 MEMBER FUNCTION DOCUMENTATION 📖

`QPopupMenu::QPopupMenu ( QWidget * parent = 0, const char * name = 0 )`

Constructs a popup menu called name with parent parent.

Although a popup menu is always a top-level widget, if a parent is passed the popup menu will be deleted when that parent is destroyed (as with any other QObject). So yes, it's top-level but it still gets taken out when parent goes. 💀

`QPopupMenu::~QPopupMenu ()`

Destroys the popup menu. bye bestie 🦋

`void QPopupMenu::aboutToHide ()` [signal]

This signal is emitted just before the popup menu is hidden after it has been displayed.

Warning: Do not open a widget in a slot connected to this signal. like literally do not, the original says don't, so don't 🙅‍♀️

See also aboutToShow(), setItemEnabled(), setItemChecked(), insertItem(), and removeItem().

`void QPopupMenu::aboutToShow ()` [signal]

This signal is emitted just before the popup menu is displayed. You can connect it to any slot that sets up the menu contents (e.g. to ensure that the right items are enabled).

See also aboutToHide(), setItemEnabled(), setItemChecked(), insertItem(), and removeItem().

Example: mdi/application.cpp.

`QKeySequence QMenuData::accel ( int id ) const`

Returns the accelerator key that has been defined for the menu item id, or 0 if it has no accelerator key or if there is no such menu item.

See also setAccel(), QAccel, and qnamespace.h.

`void QPopupMenu::activated ( int id )` [signal]

This signal is emitted when a menu item is selected; id is the id of the selected item.

Normally, you connect each menu item to a single slot using QMenuData::insertItem(), 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.

See also highlighted() and QMenuData::insertItem().

Examples:

`void QMenuData::changeItem ( int id, const QString & text )`

Changes the text of the menu item id to text. If the item has an icon, the icon remains unchanged.

`void QMenuData::changeItem ( int id, const QPixmap & pixmap )`

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Changes the pixmap of the menu item id to the pixmap pixmap. If the item has an icon, the icon is unchanged.

`void QMenuData::changeItem ( int id, const QIconSet & icon, const QString & text )`

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Changes the iconset and text of the menu item id to the icon and text respectively.

`void QMenuData::changeItem ( int id, const QIconSet & icon, const QPixmap & pixmap )`

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Changes the iconset and pixmap of the menu item id to icon and pixmap respectively.

`void QMenuData::clear ()`

Removes all menu items. poof, gone, no trace ✨

See also removeItem() and removeItemAt().

Examples:

`int QPopupMenu::columns () const` [protected]

If a popup menu does not fit on the screen it lays itself out so that it does fit. It is style dependent what layout means (for example, on Windows it will use multiple columns).

This functions returns the number of columns necessary.

💫 `bool QMenuData::connectItem ( int id, const QObject * receiver, const char * member )`

Okay so bestie, this one hooks up the menu item with identifier id to receiver's member slot (or signal, she's flexible like that 💅).

The receiver's slot (or signal) fires the moment that menu item gets activated. Iconic behavior, honestly.

See also disconnectItem() and setItemParameter().

Example: menu/menu.cpp.

🫶 `bool QMenuData::disconnectItem ( int id, const QObject * receiver, const char * member )`

Undoes the above. Detaches receiver's member from the menu item with identifier id.

Heads up: all connections get yeeted when the menu data object is destroyed. No lingering attachments, we love a clean breakup. 🧹

See also connectItem() and setItemParameter().

🎨 `void QPopupMenu::drawContents ( QPainter * p ) [virtual protected]`

Draws every single menu item using painter p. That's it, that's the function. The artiste does the work. ✨

Reimplemented from QFrame.

🖌️ `void QPopupMenu::drawItem ( QPainter * p, int tab_, QMenuItem * mi, bool act, int x, int y, int w, int h ) [protected]`

Paints menu item mi inside the area x, y, w, h, using painter p. The item comes out active if act is TRUE and inactive if act is FALSE. The rightmost tab_ pixels are reserved for the accelerator text — that's its lil lane, don't crowd it. 💅

⚡ `int QPopupMenu::exec ()`

Runs this popup synchronously. Very main-character, she blocks until she's done.

This is literally equivalent to exec(mapToGlobal(QPoint(0,0))). But most of the time you're gonna wanna say where she goes yourself, like at the current mouse position:

exec(QCursor::pos());

or lined up with a widget:

exec(somewidget.mapToGlobal(QPoint(0,0)));

Examples:

📍 `int QPopupMenu::exec ( const QPoint & pos, int indexAtPoint = 0 )`

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Executes this popup synchronously. (Yes, again. Same energy. 🔥)

She opens the popup menu so that item number indexAtPoint lands at the specified global position pos. Need to translate a widget's local coordinates into global ones? That's QWidget::mapToGlobal(), bestie.

The return code is the id of the selected item — either from the popup menu itself or from one of its submenus — or -1 if nothing got selected (usually because the user hit Esc. classic 🙈).

Not me pointing out that all signals are emitted as usual. So if you connect a menu item to a slot and call the menu's exec(), you get the result twice — once through the signal-slot connection, and once in exec()'s return value. Double delivery, no cap.

Common usage is to park the popup at the current mouse position:

exec( QCursor::pos() );

or aligned to a widget:

exec( somewidget.mapToGlobal(QPoint(0, 0)) );

Real talk though: when you're positioning a popup with exec() or popup(), do not trust the popup menu's current size(). For performance reasons the popup only resizes itself when it actually has to, so the size before and after the show is gonna be different a lot of the time. Use sizeHint() instead — it works out the proper size based on the menu's current contents. 🎀

🌟 `void QPopupMenu::highlighted ( int id ) [signal]`

Fires when a menu item gets highlighted, and id is the id of the item that got the spotlight. Main character moment, obviously. 👑

See also activated() and QMenuData::insertItem().

🖼️ `QIconSet * QMenuData::iconSet ( int id ) const`

Hands back the icon set that's been set for menu item id, or 0 if no icon set has been set at all (she's got nothing on, leave her alone).

See also changeItem(), text(), and pixmap().

🔢 `int QPopupMenu::idAt ( int index ) const`

Gives you the identifier of the menu item sitting at position index in the internal list, or -1 if index is out of range.

See also QMenuData::setId() and QMenuData::indexOf().

Example: scrollview/scrollview.cpp.

📌 `int QPopupMenu::idAt ( const QPoint & pos ) const`

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Returns the id of the item at pos, or -1 if there's no item there or if the thing at pos is a separator. Separators have no identity, they're just vibes. 🦋

🛠️ `int QMenuData::insertItem ( const QString & text, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )`

Okay so the whole insertItem() family is how you add menu items into a popup menu or a menu bar. Big family. Lots of cousins. All valid. 🫶

A menu item is usually either a text string or a pixmap, both with an optional icon or keyboard accelerator. And for the special cases? You can also insert custom items (see QCustomMenuItem) or even full widgets into popup menus. Wild, I know.

Some insertItem() members take a popup menu as an additional argument — use that to insert submenus into existing menus, or pulldown menus into a menu bar.

The number of insert functions may look confusing, but they are actually quite simple to use. I promise. Trust. ✨

This default version inserts a menu item with the text text, the accelerator key accel, an id and an optional index, and connects it to the slot member in the object receiver.

Example:

QMenuBar   *mainMenu = new QMenuBar;
QPopupMenu *fileMenu = new QPopupMenu;
fileMenu->insertItem( "New",  myView, SLOT(newFile()), CTRL+Key_N );
fileMenu->insertItem( "Open", myView, SLOT(open()),    CTRL+Key_O );
mainMenu->insertItem( "File", fileMenu );

Not all insert functions take an object/slot parameter or an accelerator key. For those items, use connectItem() and setAccel().

If you need to translate accelerators, use tr() with the text and accelerator. (For translations use a string key sequence.):

fileMenu->insertItem( tr("Open"), myView, SLOT(open()),
                      tr("Ctrl+O") );

In the example above, pressing Ctrl+O or selecting "Open" from the menu activates the myView->open() function.

Some insert functions take a QIconSet parameter to specify the little menu item icon. Note that you can always pass a QPixmap object instead.

The id specifies the identification number associated with the menu item. Only positive values are valid, bestie — a negative value makes Qt pick a unique id for the item itself.

The index specifies the position in the menu. If index is negative, the menu item just gets appended at the end of the list. Whatever, she'll find a spot. 💅

🧠 Lowkey important: keyboard accelerators in Qt are not application-global. They're bound to a certain top-level window instead. So for example, accelerators in QPopupMenu items only work for menus that are associated with a certain window. This holds true for popup menus that live in a menu bar, since their accelerators get installed in the menu bar itself. It also applies to stand-alone popup menus that have a top-level widget in their parentWidget() chain — the menu will then install its accelerator object on that top-level widget. For all other cases, use an independent QAccel object.

⚠️ Warning: Be careful when passing a literal 0 to insertItem() because some C++ compilers will choose the wrong overloaded function. Cast the 0 to what you actually mean, e.g. (QObject*)0.

⚠️ Warning: On Mac OS X, items that connect to a slot and are inserted into a menubar will not function, because 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 Qt version.

Returns the allocated menu identifier number (id if id >= 0).

See also removeItem(), changeItem(), setAccel(), connectItem(), QAccel, and qnamespace.h.

Examples:

🌈 `int QMenuData::insertItem ( const QIconSet & icon, const QString & text, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )`

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Inserts a menu item with icon icon, text text, accelerator accel, optional id id, and optional index position. The menu item gets connected to the receiver's member slot. The icon shows up to the left of the text in the item — its designated spot, we respect it. ✨

Returns the allocated menu identifier number (id if id >= 0).

See also removeItem(), changeItem(), setAccel(), connectItem(), QAccel, and qnamespace.h.

🎀 `int QMenuData::insertItem ( const QPixmap & pixmap, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )`

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Inserts a menu item with pixmap pixmap, accelerator accel, optional id id, and optional index position. The menu item gets connected to the receiver's member slot. The icon shows up to the left of the text in the item.

To look best when being highlighted as a menu item, the pixmap should provide a mask (see QPixmap::mask()). Glow-up tip, free of charge. 💅

Returns the allocated menu identifier number (id if id >= 0).

See also removeItem(), changeItem(), setAccel(), and connectItem().

🦋 `int QMenuData::insertItem ( const QIconSet & icon, const QPixmap & pixmap, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )`

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Inserts a menu item with icon icon, pixmap pixmap, accelerator accel, optional id id, and optional index position. The icon displays to the left of the pixmap in the item. The item is connected to the member slot in the receiver object.

Again: to look best when being highlighted as a menu item, the pixmap should provide a mask (see QPixmap::mask()).

Returns the allocated menu identifier number (id if id >= 0).

See also removeItem(), changeItem(), setAccel(), connectItem(), QAccel, and qnamespace.h.

💖 `int QMenuData::insertItem ( const QString & text, int id = -1, int index = -1 )`

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Inserts a menu item with text text, optional id id, and optional index position. No receiver, no slot, no drama — just a label chilling in a menu. 🍓

Returns the allocated menu identifier number (id if id >= 0).

See also removeItem(), changeItem(), setAccel(), and connectItem().

⭐ `int QMenuData::insertItem ( const QIconSet & icon, const QString & text, int id = -1, int index = -1 )`

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

Inserts a menu item with icon icon, text text, optional id id, and optional index position. The icon shows up to the left of the text in the item, right where it belongs.

Returns the allocated menu identifier number (id if id >= 0).

See also removeItem(), changeItem(), setAccel(), and connectItem().

int QMenuData::insertItem ( const QString & text, QPopupMenu * popup, int id =
       -1, int index = -1 )

okay so this one is another overloaded member function, provided for convenience, and it behaves essentially like the one above it 💖.

You're inserting a menu item with text text, a submenu popup, an optional id id, and an optional index position index.

⚠️ bestie listen — the popup must be deleted by the programmer or by its parent widget. It is not deleted when this menu item is removed, and it is not deleted when the menu is deleted. So don't just forget about it, ok?? 🫶

Returns the allocated menu identifier number (that's id if id >= 0).

See also removeItem(), changeItem(), setAccel(), and connectItem().

int QMenuData::insertItem ( const QIconSet & icon, const QString & text,
       QPopupMenu * popup, int id = -1, int index = -1 )

Another overloaded member function, provided for convenience, behaving essentially like the above function ✨.

Inserts a menu item with icon icon, text text, submenu popup, optional id id, and optional index position index. The icon gets displayed to the left of the text in the item. it's giving little picture, little words, so cute 🌸

⚠️ same deal, no cap: the popup 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.

Returns the allocated menu identifier number (id if id >= 0).

See also removeItem(), changeItem(), setAccel(), and connectItem().

int QMenuData::insertItem ( const QPixmap & pixmap, int id = -1, int index = -1
       )

Overloaded member function, provided for convenience, behaves essentially like the above function 💅.

Inserts a menu item with pixmap pixmap, optional id id, and optional index position index.

To look best when being highlighted as a menu item, the pixmap should provide a mask — see QPixmap::mask(). (lowkey it just wants to look good highlighted, relatable 🎀)

Returns the allocated menu identifier number (id if id >= 0).

See also removeItem(), changeItem(), setAccel(), and connectItem().

int QMenuData::insertItem ( const QIconSet & icon, const QPixmap & pixmap, int
       id = -1, int index = -1 )

Overloaded member function, provided for convenience, behaves essentially like the above function ⭐.

Inserts a menu item with icon icon, pixmap pixmap, optional id id, and optional index position index. The icon is displayed to the left of the pixmap in the item.

Returns the allocated menu identifier number (id if id >= 0).

See also removeItem(), changeItem(), setAccel(), and connectItem().

int QMenuData::insertItem ( const QPixmap & pixmap, QPopupMenu * popup, int id
       = -1, int index = -1 )

Overloaded member function, provided for convenience, behaves essentially like the above function 🦋.

Inserts a menu item with pixmap pixmap, submenu popup, optional id id, and optional index position index.

⚠️ yup, again: the popup 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.

Returns the allocated menu identifier number (id if id >= 0).

See also removeItem(), changeItem(), setAccel(), and connectItem().

int QMenuData::insertItem ( const QIconSet & icon, const QPixmap & pixmap,
       QPopupMenu * popup, int id = -1, int index = -1 )

Overloaded member function, provided for convenience, behaves essentially like the above function 🔥.

Inserts a menu item with icon icon, pixmap pixmap, submenu popup, optional id id, and optional index position index. The icon is displayed to the left of the pixmap in the item. (icon + pixmap + submenu?? the whole buffet, we love a maximalist moment 💜)

⚠️ one more time for the people in the back: the popup 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.

Returns the allocated menu identifier number (id if id >= 0).

See also removeItem(), changeItem(), setAccel(), and connectItem().

int QMenuData::insertItem ( QWidget * widget, int id = -1, int index = -1 )

Overloaded member function, provided for convenience, behaves essentially like the above function 👑

Inserts a menu item that consists of the widget widget, with optional id id, and optional index position index.

Ownership of widget is transferred to the popup menu or to the menu bar. (so it's yours no more, it's the menu's now, periodt 💅)

Theoretically, any widget can be inserted into a popup menu. In practice, this only makes sense with certain widgets. ngl that's such a shady sentence and yet so true 😭

If a widget is not focus-enabled (see QWidget::isFocusEnabled()), the menu treats it as a separator — which means the item is not selectable and will never get focus. So in this way you can, for example, simply insert a QLabel if you need a popup menu with a title. cute, iconic, no interaction required 🎀

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 ArrowUp and ArrowDown 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 QLineEdit, 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 QWidget::focusNextPrevChild(). Also — if the embedded widget closes the menu when the user made a selection, this can be done safely by calling:

if ( isVisible() &&
     parentWidget() &&
     parentWidget()->inherits("QPopupMenu") )
    parentWidget()->close();

Returns the allocated menu identifier number (id if id >= 0).

🎀 PROPERTY DOCUMENTATION 🎀

🌟 `bool checkable` 🌟

This property holds whether the display of check marks on menu items is enabled.

When TRUE, the display of check marks on menu items is enabled. And lowkey important: checking is always enabled when in Windows-style. 🪟✨

👀 SEE ALSO 👀

💖 COPYRIGHT 💖

✨ AUTHOR ✨

Generated automatically from the source code. (not me writing a whole essay, the machine did that 🙈)

💀 BUGS 💀

If you find a bug in Qt, please report it as described in http://doc.trolltech.com/bughowto.html. Good bug reports help us to help you. Thank you. 🫶

The definitive Qt documentation is provided in HTML format; it is located at $QTDIR/doc/html and can be read using Qt Assistant or with a web browser. This man page is provided as a convenience for those users who prefer man pages, although this format is not officially supported by Trolltech.

If you find errors in this manual page, please report them to qt-bugs@trolltech.com. Please include the name of the manual page (qpopupmenu.3qt) and the Qt version (3.3.8).

okay bestie that's the whole page!! 🎀 this one came from the Trolltech AS girlies, dated 2 February 2007, and it's the QPopupMenu(3qt) page — go forth and make the prettiest menus, mwah 💅💖✨

📦 where this page comes from

fedora 43: qt3-devel-docs 3.3.8b-102.fc43 · QPL-1.0 OR GPL-2.0-only OR GPL-3.0-only
fedora 44: qt3-devel-docs 3.3.8b-103.fc44 · QPL-1.0 OR GPL-2.0-only OR GPL-3.0-only
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-10-14: a language model's rewrite of the original, under its terms

QPopupMenu(3qt)

💖 QPopupMenu 💖

🌸 NAME 🌸

✨ SYNOPSIS ✨

🫶 Public Members 🫶

🦋 Signals 🦋

💜 Important Inherited Members 💜

⭐ Properties ⭐

🌈 Protected Members 🌈

💅 DESCRIPTION 💅

📖 MEMBER FUNCTION DOCUMENTATION 📖

QPopupMenu::QPopupMenu ( QWidget * parent = 0, const char * name = 0 )

QPopupMenu::~QPopupMenu ()

void QPopupMenu::aboutToHide () [signal]

void QPopupMenu::aboutToShow () [signal]

QKeySequence QMenuData::accel ( int id ) const

void QPopupMenu::activated ( int id ) [signal]

void QMenuData::changeItem ( int id, const QString & text )

void QMenuData::changeItem ( int id, const QPixmap & pixmap )

void QMenuData::changeItem ( int id, const QIconSet & icon, const QString & text )

void QMenuData::changeItem ( int id, const QIconSet & icon, const QPixmap & pixmap )

void QMenuData::clear ()

int QPopupMenu::columns () const [protected]

💫 bool QMenuData::connectItem ( int id, const QObject * receiver, const char * member )

🫶 bool QMenuData::disconnectItem ( int id, const QObject * receiver, const char * member )

🎨 void QPopupMenu::drawContents ( QPainter * p ) [virtual protected]

🖌️ void QPopupMenu::drawItem ( QPainter * p, int tab_, QMenuItem * mi, bool act, int x, int y, int w, int h ) [protected]

⚡ int QPopupMenu::exec ()

📍 int QPopupMenu::exec ( const QPoint & pos, int indexAtPoint = 0 )

🌟 void QPopupMenu::highlighted ( int id ) [signal]

🖼️ QIconSet * QMenuData::iconSet ( int id ) const

🔢 int QPopupMenu::idAt ( int index ) const

📌 int QPopupMenu::idAt ( const QPoint & pos ) const

🛠️ int QMenuData::insertItem ( const QString & text, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )

🌈 int QMenuData::insertItem ( const QIconSet & icon, const QString & text, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )

🎀 int QMenuData::insertItem ( const QPixmap & pixmap, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )

🦋 int QMenuData::insertItem ( const QIconSet & icon, const QPixmap & pixmap, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )

💖 int QMenuData::insertItem ( const QString & text, int id = -1, int index = -1 )

⭐ int QMenuData::insertItem ( const QIconSet & icon, const QString & text, int id = -1, int index = -1 )

🎀 PROPERTY DOCUMENTATION 🎀

🌟 bool checkable 🌟

👀 SEE ALSO 👀

💖 COPYRIGHT 💖

✨ AUTHOR ✨

💀 BUGS 💀

`QPopupMenu::QPopupMenu ( QWidget * parent = 0, const char * name = 0 )`

`QPopupMenu::~QPopupMenu ()`

`void QPopupMenu::aboutToHide ()` [signal]

`void QPopupMenu::aboutToShow ()` [signal]

`QKeySequence QMenuData::accel ( int id ) const`

`void QPopupMenu::activated ( int id )` [signal]

`void QMenuData::changeItem ( int id, const QString & text )`

`void QMenuData::changeItem ( int id, const QPixmap & pixmap )`

`void QMenuData::changeItem ( int id, const QIconSet & icon, const QString & text )`

`void QMenuData::changeItem ( int id, const QIconSet & icon, const QPixmap & pixmap )`

`void QMenuData::clear ()`

`int QPopupMenu::columns () const` [protected]

💫 `bool QMenuData::connectItem ( int id, const QObject * receiver, const char * member )`

🫶 `bool QMenuData::disconnectItem ( int id, const QObject * receiver, const char * member )`

🎨 `void QPopupMenu::drawContents ( QPainter * p ) [virtual protected]`

🖌️ `void QPopupMenu::drawItem ( QPainter * p, int tab_, QMenuItem * mi, bool act, int x, int y, int w, int h ) [protected]`

⚡ `int QPopupMenu::exec ()`

📍 `int QPopupMenu::exec ( const QPoint & pos, int indexAtPoint = 0 )`

🌟 `void QPopupMenu::highlighted ( int id ) [signal]`

🖼️ `QIconSet * QMenuData::iconSet ( int id ) const`

🔢 `int QPopupMenu::idAt ( int index ) const`

📌 `int QPopupMenu::idAt ( const QPoint & pos ) const`

🛠️ `int QMenuData::insertItem ( const QString & text, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )`

🌈 `int QMenuData::insertItem ( const QIconSet & icon, const QString & text, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )`

🎀 `int QMenuData::insertItem ( const QPixmap & pixmap, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )`

🦋 `int QMenuData::insertItem ( const QIconSet & icon, const QPixmap & pixmap, const QObject * receiver, const char * member, const QKeySequence & accel = 0, int id = -1, int index = -1 )`

💖 `int QMenuData::insertItem ( const QString & text, int id = -1, int index = -1 )`

⭐ `int QMenuData::insertItem ( const QIconSet & icon, const QString & text, int id = -1, int index = -1 )`

🌟 `bool checkable` 🌟