QActionGroup Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert 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 Aufheben der Markierung der aktiven Aktion zu erlauben, rufen Sie stattdessen setExclusionPolicy(QActionGroup::ExclusionPolicy::ExclusiveOptional)

[virtual noexcept] QActionGroup::~QActionGroup()

Zerstört die Aktionsgruppe.

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

Gibt die Liste der Aktionen dieser Gruppe zurück. Diese 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 der Gruppe als Elternteil erstellt wird, daher wird diese Funktion normalerweise nicht verwendet.

Siehe auch QAction::setActionGroup().

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

Erzeugt eine Aktion mit text und gibt sie zurück. Die neu erstellte Aktion ist ein Kind dieser Aktionsgruppe.

Normalerweise wird eine Aktion zu einer Gruppe hinzugefügt, indem sie mit der Gruppe als Elternteil erstellt wird, daher wird diese Funktion normalerweise nicht verwendet.

Siehe auch QAction::setActionGroup().

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

Erstellt eine Aktion mit text und einer icon und gibt diese zurück. Die neu erstellte Aktion ist ein Kind dieser Aktionsgruppe.

Normalerweise wird eine Aktion zu einer Gruppe hinzugefügt, indem sie mit der Gruppe als Elternteil erstellt wird, daher wird diese Funktion normalerweise nicht verwendet.

Siehe auch QAction::setActionGroup().

QAction *QActionGroup::checkedAction() const

Gibt die aktuell angekreuzte Aktion in der Gruppe zurück, oder nullptr, wenn keine angekreuzt ist.

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

Dieses Signal wird ausgegeben, wenn die angegebene action in der Aktionsgruppe vom Benutzer hervorgehoben wird, z. B. wenn der Benutzer mit dem Cursor über einer Menüoption oder einer Symbolleistenschaltfläche pausiert oder die Tastenkombination einer 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 ExclusionPolicy entweder Exclusive oder ExclusionOptional ist.

void QActionGroup::removeAction(QAction *action)

Entfernt die action aus dieser Gruppe. Die Aktion hat keinen Elternteil als Ergebnis.

Siehe auch QAction::setActionGroup().

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

Dies ist eine Komfortfunktion für die Eigenschaft enabled, die für Signal-Slot-Verbindungen nützlich ist. Wenn b wahr ist, ist die Aktionsgruppe deaktiviert; andernfalls ist sie aktiviert.

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

Aktivieren oder Deaktivieren der Gruppenausschlussprüfung

Dies ist eine bequeme Methode, die setExclusionPolicy(ExclusionPolicy::Exclusive) aufruft, wenn b wahr ist, ansonsten setExclusionPolicy(QActionGroup::ExclusionPolicy::None).

Siehe auch isExclusive() und QActionGroup::exclusionPolicy.

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

Dieses Signal wird ausgegeben, wenn die angegebene action in der Aktionsgruppe vom Benutzer aktiviert wird, z. B. wenn der Benutzer auf eine Menüoption oder eine Schaltfläche in der Symbolleiste klickt oder eine Tastenkombination für eine Aktion drückt.

Verbinden Sie sich mit diesem Signal für Befehlsaktionen.

Siehe auch QAction::activate().