QMenu Class

Dokumentation der Mitgliedsfunktionen

[explicit] QMenu::QMenu(QWidget *parent = nullptr)

Konstruiert ein Menü mit übergeordnetem parent.

Obwohl ein Popup-Menü immer ein Widget der obersten Ebene ist, wird das Popup-Menü, wenn ein übergeordnetes Element übergeben wird, gelöscht, wenn dieses übergeordnete Element zerstört wird (wie bei jedem anderen QObject).

[explicit] QMenu::QMenu(const QString &title, QWidget *parent = nullptr)

Konstruiert ein Menü mit einem title und einem parent.

Obwohl ein Popup-Menü immer ein Widget der obersten Ebene ist, wird das Popup-Menü, wenn ein übergeordnetes Element übergeben wird, gelöscht, wenn dieses übergeordnete Element zerstört wird (wie bei jedem anderen QObject).

Siehe auch title.

[virtual noexcept] QMenu::~QMenu()

Zerstört das Menü.

[signal] void QMenu::aboutToHide()

Dieses Signal wird ausgegeben, kurz bevor das Menü vor dem Benutzer verborgen wird.

Siehe auch aboutToShow() und hide().

[signal] void QMenu::aboutToShow()

Dieses Signal wird ausgegeben, kurz bevor das Menü dem Benutzer angezeigt wird.

Siehe auch aboutToHide() und show().

QAction *QMenu::actionAt(const QPoint &pt) const

Gibt den Artikel unter pt zurück; gibt nullptr zurück, wenn sich dort kein Artikel befindet.

[override virtual protected] void QMenu::actionEvent(QActionEvent *e)

Reimplements: QWidget::actionEvent(QActionEvent *event).

QRect QMenu::actionGeometry(QAction *act) const

Gibt die Geometrie der Aktion act zurück.

QAction *QMenu::activeAction() const

Gibt die aktuell hervorgehobene Aktion zurück, oder nullptr, wenn keine Aktion hervorgehoben ist.

Siehe auch setActiveAction().

QAction *QMenu::addMenu(QMenu *menu)

Diese Komfortfunktion fügt menu als Untermenü zu diesem Menü hinzu. Sie gibt menu's menuAction() zurück. Dieses Menü übernimmt nicht den Besitz von menu.

Siehe auch QWidget::addAction() und QMenu::menuAction().

QMenu *QMenu::addMenu(const QString &title)

Hängt ein neues QMenu mit title an das Menü an. Das Menü übernimmt das Eigentum an dem Menü. Gibt das neue Menü zurück.

Siehe auch QWidget::addAction() und QMenu::menuAction().

QMenu *QMenu::addMenu(const QIcon &icon, const QString &title)

Hängt ein neues QMenu mit icon und title an das Menü an. Das Menü übernimmt das Eigentum an dem Menü. Gibt das neue Menü zurück.

Siehe auch QWidget::addAction() und QMenu::menuAction().

QAction *QMenu::addSection(const QString &text)

Diese Komfortfunktion erstellt eine neue Abschnittsaktion, d.h. eine Aktion mit QAction::isSeparator(), die true zurückgibt, aber auch einen text -Hinweis hat, und fügt die neue Aktion zur Liste der Aktionen dieses Menüs hinzu. Sie gibt die neu erstellte Aktion zurück.

Das Rendering des Hinweises ist stil- und plattformabhängig. Widgetstile können die Textinformationen bei der Darstellung von Abschnitten verwenden oder sie ignorieren und Abschnitte wie einfache Trennzeichen darstellen.

QMenu übernimmt das Eigentum an dem zurückgegebenen QAction.

Siehe auch QWidget::addAction().

QAction *QMenu::addSection(const QIcon &icon, const QString &text)

Diese Komfortfunktion erstellt eine neue Abschnittsaktion, d.h. eine Aktion mit QAction::isSeparator(), die true zurückgibt, aber auch text und icon Hinweise enthält, und fügt die neue Aktion der Liste der Aktionen in diesem Menü hinzu. Sie gibt die neu erstellte Aktion zurück.

Das Rendering der Hinweise ist stil- und plattformabhängig. Widgetstile können die Text- und Symbolinformationen bei der Darstellung von Abschnitten verwenden oder sie ignorieren und Abschnitte wie einfache Trennzeichen darstellen.

QMenu übernimmt das Eigentum an dem zurückgegebenen QAction.

Siehe auch QWidget::addAction().

QAction *QMenu::addSeparator()

Diese Komfortfunktion erstellt eine neue Trennaktion, d.h. eine Aktion mit QAction::isSeparator(), die true zurückgibt, und fügt die neue Aktion zur Liste der Aktionen dieses Menüs hinzu. Sie gibt die neu erstellte Aktion zurück.

QMenu übernimmt das Eigentum an der zurückgegebenen QAction.

Siehe auch QWidget::addAction().

[override virtual protected] void QMenu::changeEvent(QEvent *e)

Reimplements: QWidget::changeEvent(QEvent *Event).

void QMenu::clear()

Entfernt alle Aktionen des Menüs. Aktionen, die dem Menü gehören und in keinem anderen Widget angezeigt werden, werden gelöscht.

Siehe auch removeAction().

[protected] int QMenu::columnCount() const

Wenn ein Menü nicht auf den Bildschirm passt, ordnet es sich selbst so an, dass es passt. Es ist stilabhängig, was Layout bedeutet (unter Windows werden zum Beispiel mehrere Spalten verwendet).

Diese Funktion gibt die Anzahl der erforderlichen Spalten zurück.

QAction *QMenu::defaultAction() const

Gibt die aktuelle Standardaktion zurück.

Siehe auch setDefaultAction().

[override virtual protected] void QMenu::enterEvent(QEnterEvent *)

Reimplements: QWidget::enterEvent(QEnterEvent *event).

[override virtual protected] bool QMenu::event(QEvent *e)

Reimplements: QWidget::event(QEvent *Event).

QAction *QMenu::exec()

Führt dieses Menü synchron aus.

Dies ist äquivalent zu exec(pos()).

Dies gibt den ausgelösten Eintrag QAction entweder im Popup-Menü oder in einem seiner Untermenüs zurück, oder nullptr, wenn kein Eintrag ausgelöst wurde (normalerweise weil der Benutzer Esc gedrückt hat).

In den meisten Situationen werden Sie die Position selbst angeben wollen, zum Beispiel die aktuelle Mausposition:

exec(QCursor::pos());

oder auf ein Widget ausgerichtet:

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

oder in Reaktion auf ein QMouseEvent *e:

exec(e->globalPosition().toPoint());

QAction *QMenu::exec(const QPoint &p, QAction *action = nullptr)

Dies ist eine überladene Funktion.

Führt dieses Menü synchron aus.

Öffnet das Menü so, dass sich die Aktion action an der angegebenen globalen Position p befindet. Um die lokalen Koordinaten eines Widgets in globale Koordinaten zu übersetzen, verwenden Sie QWidget::mapToGlobal().

Dies gibt das ausgelöste QAction entweder im Popup-Menü oder in einem seiner Untermenüs zurück, oder nullptr, wenn kein Element ausgelöst wurde (normalerweise weil der Benutzer Esc gedrückt hat).

Beachten Sie, dass alle Signale wie üblich ausgegeben werden. Wenn Sie QAction mit einem Slot verbinden und die Funktion exec() des Menüs aufrufen, erhalten Sie das Ergebnis sowohl über die Signal-Slot-Verbindung als auch im Rückgabewert von exec().

Eine übliche Anwendung ist die Positionierung des Menüs an der aktuellen Mausposition:

exec(QCursor::pos());

oder auf ein Widget ausgerichtet:

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

oder in Reaktion auf eine QMouseEvent *e:

exec(e->globalPosition().toPoint());

Wenn Sie ein Menü mit exec() oder popup() positionieren, denken Sie daran, dass Sie sich nicht auf die aktuelle size() des Menüs verlassen können. Aus Performance-Gründen passt das Menü seine Größe nur bei Bedarf an. Daher ist in vielen Fällen die Größe vor und nach der Show unterschiedlich. Verwenden Sie stattdessen sizeHint(), das die richtige Größe in Abhängigkeit vom aktuellen Inhalt des Menüs berechnet.

Siehe auch popup() und QWidget::mapToGlobal().

[static] QAction *QMenu::exec(const QList<QAction *> &actions, const QPoint &pos, QAction *at = nullptr, QWidget *parent = nullptr)

Dies ist eine überladene Funktion.

Führt ein Menü synchron aus.

Die Aktionen des Menüs werden durch die Liste actions spezifiziert. Das Menü wird so eingeblendet, dass die angegebene Aktion at an der globalen Position pos erscheint. Wenn at nicht angegeben wird, erscheint das Menü an der Position pos. parent ist das übergeordnete Widget des Menüs; die Angabe des übergeordneten Widgets liefert Kontext, wenn pos allein nicht ausreicht, um zu entscheiden, wo das Menü erscheinen soll (z. B. bei mehreren Desktops oder wenn das übergeordnete Widget in QGraphicsView eingebettet ist).

Die Funktion gibt das ausgelöste QAction entweder im Popup-Menü oder in einem seiner Untermenüs zurück, oder nullptr, wenn kein Element ausgelöst wurde (normalerweise, weil der Benutzer Esc gedrückt hat).

Dies ist äquivalent zu:

QMenu menu;
QAction *at = actions[0]; // Assumes actions is not empty
for (QAction *a : std::as_const(actions))
    menu.addAction(a);
menu.exec(pos, at);

Siehe auch popup() und QWidget::mapToGlobal().

[override virtual protected] bool QMenu::focusNextPrevChild(bool next)

Reimplements: QWidget::focusNextPrevChild(bool next).

[override virtual protected] void QMenu::hideEvent(QHideEvent *)

Reimplements: QWidget::hideEvent(QHideEvent *event).

void QMenu::hideTearOffMenu()

Diese Funktion blendet das abgerissene Menü zwangsweise aus und lässt es vom Desktop des Benutzers verschwinden.

Siehe auch showTearOffMenu(), isTearOffMenuVisible(), und isTearOffEnabled().

[signal] void QMenu::hovered(QAction *action)

Dieses Signal wird ausgegeben, wenn eine Menüaktion hervorgehoben wird; action ist die Aktion, die die Ausgabe des Signals verursacht hat.

Häufig wird dies zur Aktualisierung von Statusinformationen verwendet.

Siehe auch triggered() und QAction::hovered().

[virtual protected] void QMenu::initStyleOption(QStyleOptionMenuItem *option, const QAction *action) const

Initialisieren Sie option mit den Werten aus diesem Menü und den Informationen aus action. Diese Methode ist nützlich für Unterklassen, die ein QStyleOptionMenuItem benötigen, aber nicht alle Informationen selbst eingeben wollen.

Siehe auch QStyleOption::initFrom() und QMenuBar::initStyleOption().

QAction *QMenu::insertMenu(QAction *before, QMenu *menu)

Diese Komfortfunktion fügt menu vor der Aktion before ein und gibt die Menüs menuAction() zurück.

Siehe auch QWidget::insertAction() und addMenu().

QAction *QMenu::insertSection(QAction *before, const QString &text)

Diese Komfortfunktion erstellt eine neue Titelaktion, d.h. eine Aktion mit QAction::isSeparator(), die true zurückgibt, aber auch einen text -Hinweis hat. Die Funktion fügt die neu erstellte Aktion in die Liste der Aktionen in diesem Menü vor der Aktion before ein und gibt sie zurück.

Die Darstellung des Hinweises ist stil- und plattformabhängig. Widgetstile können die Textinformationen bei der Darstellung von Abschnitten verwenden oder sie ignorieren und Abschnitte wie einfache Trennzeichen darstellen.

QMenu übernimmt das Eigentum an dem zurückgegebenen QAction.

Siehe auch QWidget::insertAction() und addSection().

QAction *QMenu::insertSection(QAction *before, const QIcon &icon, const QString &text)

Diese Komfortfunktion erstellt eine neue Titelaktion, d.h. eine Aktion mit QAction::isSeparator(), die true zurückgibt, aber auch mit text und icon Hinweisen. Die Funktion fügt die neu erstellte Aktion in die Liste der Aktionen in diesem Menü vor der Aktion before ein und gibt sie zurück.

Das Rendering der Hinweise ist stil- und plattformabhängig. Widgetstile können die Text- und Symbolinformationen bei der Darstellung von Abschnitten verwenden oder sie ignorieren und Abschnitte wie einfache Trennzeichen darstellen.

QMenu übernimmt das Eigentum an dem zurückgegebenen QAction.

Siehe auch QWidget::insertAction() und addSection().

QAction *QMenu::insertSeparator(QAction *before)

Diese Komfortfunktion erstellt eine neue Trennaktion, d.h. eine Aktion mit QAction::isSeparator(), die true zurückgibt. Die Funktion fügt die neu erstellte Aktion in die Liste der Aktionen in diesem Menü vor der Aktion before ein und gibt sie zurück.

QMenu übernimmt das Eigentum an der zurückgegebenen Aktion QAction.

Siehe auch QWidget::insertAction() und addSeparator().

bool QMenu::isEmpty() const

Gibt true zurück, wenn keine sichtbaren Aktionen in das Menü eingefügt sind, andernfalls false.

Siehe auch QWidget::actions().

bool QMenu::isTearOffMenuVisible() const

Wenn ein Menü abgerissen wird, wird ein zweites Menü angezeigt, um den Inhalt des Menüs in einem neuen Fenster darzustellen. Wenn sich das Menü in diesem Modus befindet und das Menü sichtbar ist, wird true zurückgegeben; andernfalls false.

Siehe auch showTearOffMenu(), hideTearOffMenu(), und isTearOffEnabled().

[override virtual protected] void QMenu::keyPressEvent(QKeyEvent *e)

Reimplements: QWidget::keyPressEvent(QKeyEvent *event).

[override virtual protected] void QMenu::leaveEvent(QEvent *)

Reimplements: QWidget::leaveEvent(QEvent *Event).

QAction *QMenu::menuAction() const

Gibt die mit diesem Menü verbundene Aktion zurück.

[static] QMenu *QMenu::menuInAction(const QAction *action)

Gibt das Menü zurück, das in action enthalten ist, oder nullptr, wenn action kein Menü enthält.

In Widget-Anwendungen können Aktionen, die Menüs enthalten, verwendet werden, um Menüpunkte mit Untermenüs zu erstellen, oder in Symbolleisten eingefügt werden, um Schaltflächen mit Popup-Menüs zu erstellen.

[override virtual protected] void QMenu::mouseMoveEvent(QMouseEvent *e)

Reimplements: QWidget::mouseMoveEvent(QMouseEvent *event).

[override virtual protected] void QMenu::mousePressEvent(QMouseEvent *e)

Reimplements: QWidget::mousePressEvent(QMouseEvent *event).

[override virtual protected] void QMenu::mouseReleaseEvent(QMouseEvent *e)

Reimplements: QWidget::mouseReleaseEvent(QMouseEvent *event).

[override virtual protected] void QMenu::paintEvent(QPaintEvent *e)

Reimplements: QWidget::paintEvent(QPaintEvent *event).

void QMenu::popup(const QPoint &p, QAction *atAction = nullptr)

Zeigt das Menü so an, dass sich die Aktion atAction an der angegebenen globalen Position p befindet. Um die lokalen Koordinaten eines Widgets in globale Koordinaten zu übersetzen, verwenden Sie QWidget::mapToGlobal().

Wenn Sie ein Menü mit exec() oder popup() positionieren, sollten Sie bedenken, dass Sie sich nicht auf die aktuelle size() des Menüs verlassen können. Aus Leistungsgründen passt das Menü seine Größe nur bei Bedarf an, so dass in vielen Fällen die Größe vor und nach der Anzeige unterschiedlich ist. Verwenden Sie stattdessen sizeHint(), das die richtige Größe in Abhängigkeit vom aktuellen Inhalt des Menüs berechnet.

Siehe auch QWidget::mapToGlobal() und exec().

void QMenu::setActiveAction(QAction *act)

Setzt die aktuell markierte Aktion auf act.

Siehe auch activeAction().

void QMenu::setAsDockMenu()

Legen Sie dieses Menü als das Dock-Menü fest, das durch einen Optionsklick auf das Dock-Symbol der Anwendung verfügbar ist. Nur unter macOS verfügbar.

void QMenu::setDefaultAction(QAction *act)

Damit wird die Standardaktion auf act gesetzt. Die Standardaktion kann je nach der aktuellen QStyle einen visuellen Hinweis enthalten. Eine Standardaktion gibt in der Regel an, was standardmäßig passiert, wenn ein Drop auftritt.

Siehe auch defaultAction().

void QMenu::showTearOffMenu(const QPoint &pos)

Diese Funktion zeigt das abgerissene Menü zwangsweise an und lässt es auf dem Desktop des Benutzers an der angegebenen globalen Position pos erscheinen.

Siehe auch hideTearOffMenu(), isTearOffMenuVisible(), und isTearOffEnabled().

void QMenu::showTearOffMenu()

Dies ist eine überladene Funktion.

Diese Funktion zeigt das abgerissene Menü zwangsweise an, so dass es auf dem Desktop des Benutzers unter dem Mauszeiger erscheint.

Siehe auch hideTearOffMenu(), isTearOffMenuVisible(), und isTearOffEnabled().

[override virtual] QSize QMenu::sizeHint() const

Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QWidget::sizeHint.

[override virtual protected] void QMenu::timerEvent(QTimerEvent *e)

Reimplements: QObject::timerEvent(QTimerEvent *event).

NSMenu *QMenu::toNSMenu()

Gibt das native NSMenu für dieses Menü zurück. Nur unter macOS verfügbar.

[signal] void QMenu::triggered(QAction *action)

Dieses Signal wird ausgelöst, wenn eine Aktion in diesem Menü ausgelöst wird.

action ist die Aktion, die die Ausgabe des Signals verursacht hat.

Normalerweise verbinden Sie das Signal triggered() jeder Menüaktion mit ihrem eigenen benutzerdefinierten Slot, aber manchmal werden Sie mehrere Aktionen mit einem einzigen Slot verbinden wollen, zum Beispiel, wenn Sie eine Gruppe von eng zusammenhängenden Aktionen haben, wie "links ausrichten", "zentrieren", "rechts ausrichten".

Siehe auch hovered() und QAction::triggered().

[override virtual protected] void QMenu::wheelEvent(QWheelEvent *e)

Reimplements: QWidget::wheelEvent(QWheelEvent *event).