QMenu Class

Dokumentation zu Mitgliedsfunktionen

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

Erstellt ein Menü mit dem übergeordneten Element „ parent “.

Obwohl ein Popup-Menü immer ein Widget der obersten Ebene ist, wird es – sofern 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)

Erstellt ein Menü mit einem „ title “ und einem „ parent “.

Obwohl ein Popup-Menü immer ein Widget der obersten Ebene ist, wird es – sofern 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()

Löscht das Menü.

[signal] void QMenu::aboutToHide()

Dieses Signal wird ausgelöst, kurz bevor das Menü für den Benutzer ausgeblendet wird.

Siehe auch aboutToShow() und hide().

[signal] void QMenu::aboutToShow()

Dieses Signal wird unmittelbar vor der Anzeige des Menüs für den Benutzer ausgesendet.

Siehe auch aboutToHide() und show().

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

Gibt das Element unter pt zurück; gibt nullptr zurück, wenn dort kein Element vorhanden ist.

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

Implementiert: ` 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 markierte Aktion zurück oder „ nullptr “, falls derzeit keine Aktion markiert ist.

Siehe auch ` setActiveAction()`.

QAction *QMenu::addMenu(QMenu *menu)

Diese Hilfsfunktion fügt „ menu “ als Untermenü zu diesem Menü hinzu. Sie gibt die Funktion „ menuAction()“ von „ menu “ zurück. Dieses Menü übernimmt nicht die Eigentumsrechte an „ menu “.

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

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

Fügt dem Menü ein neues Element „ QMenu “ mit dem Wert „ title “ hinzu. Das Menü übernimmt die Verantwortung für dieses Element. Gibt das neue Menü zurück.

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

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

Fügt dem Menü ein neues „ QMenu “ mit den Einträgen „ icon “ und „ title “ hinzu. Das Menü übernimmt die Eigentumsrechte an diesem Menü. Gibt das neue Menü zurück.

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

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

Diese Hilfsfunktion erstellt eine neue Abschnittsaktion, d. h. eine Aktion, bei der die Funktion „ QAction::isSeparator()“ den Wert „true“ zurückgibt, die aber auch den Hinweis „ text “ enthält, und fügt die neue Aktion zur Aktionsliste dieses Menüs hinzu. Sie gibt die neu erstellte Aktion zurück.

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

QMenu Übernimmt die Verantwortung für das zurückgegebene ` QAction`.

Siehe auch ` QWidget::addAction()`.

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

Diese Hilfsfunktion erstellt eine neue Abschnittsaktion, d. h. eine Aktion, bei der ` QAction::isSeparator()` den Wert `true` zurückgibt, die aber auch die Hinweise ` text ` und ` icon ` enthält, und fügt die neue Aktion zur Aktionsliste dieses Menüs hinzu. Sie gibt die neu erstellte Aktion zurück.

Die Darstellung der Hinweise ist stil- und plattformabhängig. Widget-Stile können die Text- und Symbolinformationen bei der Darstellung von Abschnitten verwenden oder diese ignorieren und Abschnitte wie einfache Trennzeichen darstellen.

QMenu Übernimmt die Eigentümerschaft des zurückgegebenen ` QAction`.

Siehe auch ` QWidget::addAction()`.

QAction *QMenu::addSeparator()

Diese Hilfsfunktion erstellt eine neue Trennaktion, d. h. eine Aktion, bei der ` QAction::isSeparator()` den Wert „true“ zurückgibt, und fügt die neue Aktion zur Aktionsliste dieses Menüs hinzu. Sie gibt die neu erstellte Aktion zurück.

QMenu Übernimmt die Verantwortung für das zurückgegebene ` QAction`.

Siehe auch ` QWidget::addAction()`.

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

Umsetzt: ` QWidget::changeEvent(QEvent *event)`.

void QMenu::clear()

Entfernt alle Aktionen des Menüs. Aktionen, die zu diesem 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, passt es sich so an, dass es Platz findet. Was unter „Anpassung“ genau zu verstehen ist, hängt vom jeweiligen System ab (unter Windows werden beispielsweise 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 *)

Umsetzt: ` QWidget::enterEvent` (`QEnterEvent *event`).

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

Umsetzt: QWidget::event(QEvent *event).

QAction *QMenu::exec()

Führt dieses Menü synchron aus.

Dies entspricht ` exec(pos())`.

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

In den meisten Fällen werden Sie die Position selbst festlegen wollen, zum Beispiel die aktuelle Mausposition:

exec(QCursor::pos());

oder ausgerichtet auf ein Widget:

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

oder als Reaktion auf ein „ QMouseEvent “ *e:

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

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

Führt dieses Menü synchron aus.

Öffnet das Menü so, dass sich die Aktions action an der angegebenen globalen Position p befindet. Um die lokalen Koordinaten eines Widgets in globale Koordinaten umzuwandeln, 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 Eintrag ausgelöst wurde (normalerweise, weil der Benutzer die Esc-Taste gedrückt hat).

Beachten Sie, dass alle Signale wie gewohnt ausgesendet werden. Wenn Sie ein „ 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()`.

Üblicherweise wird das Menü an der aktuellen Mausposition positioniert:

exec(QCursor::pos());

oder an einem Widget ausgerichtet:

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

oder als Reaktion auf ein ` QMouseEvent *e`:

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

Beachten Sie beim Positionieren eines Menüs mit `exec()` oder ` popup()` (), dass Sie sich nicht auf die aktuelle Größe des Menüs (` size()`) verlassen können. Aus Leistungsgründen passt das Menü seine Größe nur bei Bedarf an. Daher ist die Größe in vielen Fällen vor und nach der Anzeige 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)

Führt ein Menü synchron aus.

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

Die Funktion gibt das ausgelöste Element ` 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 die Esc-Taste gedrückt hat).

Dies entspricht:

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)

Implementiert erneut: ` QWidget::focusNextPrevChild` (bool next).

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

Implementiert: ` QWidget::hideEvent(QHideEvent *event)`.

void QMenu::hideTearOffMenu()

Diese Funktion blendet das abgetrennte Menü zwangsweise aus, sodass es vom Desktop des Benutzers verschwindet.

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

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

Dieses Signal wird ausgelöst, wenn eine Menüaktion markiert ist; „ action “ ist die Aktion, die zur Auslösung des Signals geführt 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 unter action. Diese Methode ist für Unterklassen nützlich, wenn diese ein ` QStyleOptionMenuItem` benötigen, aber nicht alle Informationen selbst eingeben möchten.

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

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

Diese Hilfsfunktion fügt „ menu “ vor „action 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, bei der ` QAction::isSeparator()` den Wert „true“ zurückgibt, die aber auch den Hinweis ` text ` enthält. Die Funktion fügt die neu erstellte Aktion in die Aktionsliste dieses Menüs vor der Aktion ` before ` ein und gibt sie zurück.

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

QMenu Übernimmt die Eigentümerschaft an dem zurückgegebenen ` QAction`.

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

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

Diese Hilfsfunktion erstellt eine neue Titelaktion, d. h. eine Aktion, bei der ` QAction::isSeparator()` den Wert „true“ zurückgibt, die aber auch die Hinweise ` text ` und ` icon ` enthält. Die Funktion fügt die neu erstellte Aktion in die Aktionsliste dieses Menüs vor der Aktion ` before ` ein und gibt sie zurück.

Die Darstellung der Hinweise ist stil- und plattformabhängig. Widget-Stile können die Text- und Symbolinformationen bei der Darstellung von Abschnitten verwenden oder diese ignorieren und Abschnitte wie einfache Trennzeichen darstellen.

QMenu Übernimmt die Verantwortung für das zurückgegebene ` QAction`.

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

QAction *QMenu::insertSeparator(QAction *before)

Diese Hilfsfunktion erstellt eine neue Trennaktion, d. h. eine Aktion, bei der „ QAction::isSeparator()“ den Wert „true“ zurückgibt. Die Funktion fügt die neu erstellte Aktion in die Aktionsliste dieses Menüs vor der Aktion „ before “ ein und gibt sie zurück.

QMenu Übernimmt die Verantwortung für die zurückgegebene ` QAction`.

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

bool QMenu::isEmpty() const

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

Siehe auch QWidget::actions().

bool QMenu::isTearOffMenuVisible() const

Wenn ein Menü abgetrennt wird, wird ein zweites Menü angezeigt, um den Menüinhalt in einem neuen Fenster darzustellen. Befindet sich das Menü in diesem Modus und ist es sichtbar, gibt die Funktion „ true “ zurück; andernfalls „false“.

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

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

Implementiert: ` QWidget::keyPressEvent(QKeyEvent *event)`.

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

Umsetzt: ` QWidget::leaveEvent(QEvent *event)`.

QAction *QMenu::menuAction() const

Gibt die mit diesem Menü verknüpfte Aktion zurück.

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

Gibt das in ` action` enthaltene Menü zurück oder ` nullptr `, falls ` action ` kein Menü enthält.

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

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

Implementiert neu: ` QWidget::mouseMoveEvent` (`QMouseEvent *event`).

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

Implementiert: ` QWidget::mousePressEvent` (`QMouseEvent *event`).

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

Implementiert: ` QWidget::mouseReleaseEvent` (`QMouseEvent *event`).

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

Implementiert: ` 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 umzuwandeln, verwenden Sie die Funktion „ QWidget::mapToGlobal()“.

Beachten Sie beim Positionieren eines Menüs mit ` exec()` oder `popup()`, dass Sie sich nicht auf die aktuelle Position ` size()` des Menüs verlassen können. Aus Leistungsgründen passt das Menü seine Größe nur bei Bedarf an, sodass in vielen Fällen die Größe vor und nach dem Einblenden 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 Dock-Menü fest, das durch einen Option-Klick auf das Dock-Symbol der Anwendung aufgerufen werden kann. Nur unter macOS verfügbar.

void QMenu::setDefaultAction(QAction *act)

Dadurch wird die Standardaktion auf „ act “ festgelegt. Die Standardaktion kann je nach der aktuellen Einstellung unter „ QStyle “ visuell hervorgehoben werden. Eine Standardaktion gibt in der Regel an, was standardmäßig geschieht, wenn ein Drag-and-Drop-Vorgang stattfindet.

Siehe auch defaultAction().

void QMenu::showTearOffMenu(const QPoint &pos)

Diese Funktion zeigt das abgetrennte Menü zwangsweise an, sodass es an der angegebenen globalen Position pos auf dem Desktop des Benutzers erscheint.

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

void QMenu::showTearOffMenu()

Diese Funktion zeigt das abgetrennte Menü zwangsweise an, sodass es auf dem Desktop des Benutzers unter dem Mauszeiger erscheint.

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

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

Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::sizeHint “ neu.

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

Implementiert: ` 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 ausgegeben, 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 einem eigenen benutzerdefinierten Slot, aber manchmal möchten Sie mehrere Aktionen mit einem einzigen Slot verbinden, zum Beispiel, wenn Sie eine Gruppe eng miteinander verbundener Aktionen haben, wie „Linksbündig“, „Zentrieren“, „Rechtsbündig“.

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

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

Implementiert: ` QWidget::wheelEvent` (`QWheelEvent *event`).