QActionGroup Class

Dokumentation der Mitgliedsfunktionen

[explicit] QActionGroup::QActionGroup(QObject *parent)

Erstellt eine Aktionsgruppe für das Objekt „ parent “.

Die Aktionsgruppe ist standardmäßig exklusiv. Rufen Sie „ setExclusive(false)“ auf, um die Aktionsgruppe nicht-exklusiv zu machen. Um die Gruppe exklusiv zu machen, aber das Deaktivieren der aktiven Aktion zuzulassen, rufen Sie stattdessen „ setExclusionPolicy(QActionGroup::ExclusionPolicy::ExclusiveOptional)“ auf.

[virtual noexcept] QActionGroup::~QActionGroup()

Löscht die Aktionsgruppe.

QList<QAction *> QActionGroup::actions() const

Gibt die Liste der Aktionen dieser Gruppe zurück. Diese Liste kann leer sein.

QAction *QActionGroup::addAction(QAction *action)

Fügt die „ action “ zu dieser Gruppe hinzu und gibt sie zurück.

Normalerweise wird eine Aktion zu einer Gruppe hinzugefügt, indem sie mit dieser Gruppe als übergeordneter Gruppe erstellt wird; daher wird diese Funktion in der Regel nicht verwendet.

Siehe auch ` QAction::setActionGroup()`.

QAction *QActionGroup::addAction(const QString &text)

Erstellt eine Aktion mit der Eigenschaft „ text “ und gibt diese zurück. Die neu erstellte Aktion ist ein untergeordnetes Element dieser Aktionsgruppe.

Normalerweise wird eine Aktion zu einer Gruppe hinzugefügt, indem sie mit der Gruppe als übergeordneter Aktion erstellt wird; daher wird diese Funktion in der Regel nicht verwendet.

Siehe auch ` QAction::setActionGroup()`.

QAction *QActionGroup::addAction(const QIcon &icon, const QString &text)

Erstellt eine Aktion mit den Parametern „ text “ und „ icon “ und gibt diese zurück. Die neu erstellte Aktion ist ein untergeordnetes Element dieser Aktionsgruppe.

Normalerweise wird eine Aktion einer Gruppe hinzugefügt, indem sie mit der Gruppe als übergeordneter Aktion erstellt wird; daher wird diese Funktion in der Regel nicht verwendet.

Siehe auch ` QAction::setActionGroup()`.

QAction *QActionGroup::checkedAction() const

Gibt die aktuell markierte Aktion in der Gruppe zurück oder „ nullptr “, falls keine markiert ist.

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

Dieses Signal wird ausgelöst, wenn das angegebene Element „ action “ in der Aktionsgruppe vom Benutzer markiert wird; beispielsweise wenn der Benutzer mit dem Cursor über einer Menüoption oder einer Schaltfläche in der Symbolleiste verweilt oder die Tastenkombination für eine Aktion drückt.

Siehe auch ` QAction::activate()`.

bool QActionGroup::isExclusive() const

Gibt „true“ zurück, wenn die Gruppe exklusiv ist

Die Gruppe ist exklusiv, wenn der Parameter „ ExclusionPolicy “ entweder auf „Exclusive“ oder „ExclusionOptional“ gesetzt ist.

void QActionGroup::removeAction(QAction *action)

Entfernt den „ action “ aus dieser Gruppe. Die Aktion hat dadurch kein übergeordnetes Element mehr.

Siehe auch „ QAction::setActionGroup()“.

[slot] void QActionGroup::setDisabled(bool b)

Dies ist eine Hilfsfunktion für die Eigenschaft „ enabled “, die bei der Verbindung von Signalen und Slots nützlich ist. Ist „ b “ wahr, ist die Aktionsgruppe deaktiviert; andernfalls ist sie aktiviert.

[slot] void QActionGroup::setExclusive(bool b)

Überprüfung auf Gruppenausschluss aktivieren oder deaktivieren

Dies ist eine Komfortmethode, die „ setExclusionPolicy “ (ExclusionPolicy::Exclusive) aufruft, wenn „ b “ auf „true“ gesetzt ist, andernfalls „ setExclusionPolicy “ (QActionGroup::ExclusionPolicy::None).

Siehe auch isExclusive() und QActionGroup::exclusionPolicy.

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

Dieses Signal wird ausgelöst, wenn die angegebene „ action “ in der Aktionsgruppe vom Benutzer aktiviert wird; beispielsweise wenn der Benutzer auf einen Menüpunkt oder eine Schaltfläche in der Symbolleiste klickt oder die Tastenkombination einer Aktion drückt.

Binden Sie sich an dieses Signal für Befehlsaktionen.

Siehe auch ` QAction::activate()`.