QAbstractState Class

Die Klasse QAbstractState ist die Basisklasse der Zustände eines QStateMachine. Mehr...

Kopfzeile: #include <QAbstractState>
CMake: find_package(Qt6 REQUIRED COMPONENTS StateMachine)
target_link_libraries(mytarget PRIVATE Qt6::StateMachine)
qmake: QT += statemachine
Vererbt: QObject
Vererbt von:

QFinalState, QHistoryState, und QState

Eigenschaften

Öffentliche Funktionen

virtual ~QAbstractState()
bool active() const
QBindable<bool> bindableActive()
QStateMachine *machine() const
QState *parentState() const

Signale

void activeChanged(bool active)
void entered()
void exited()

Geschützte Funktionen

QAbstractState(QState *parent = nullptr)
virtual void onEntry(QEvent *event) = 0
virtual void onExit(QEvent *event) = 0

Reimplementierte geschützte Funktionen

virtual bool event(QEvent *e) override

Detaillierte Beschreibung

Die Klasse QAbstractState ist die abstrakte Basisklasse für Zustände, die Teil eines QStateMachine sind. Sie definiert die Schnittstelle, die alle Zustandsobjekte gemeinsam haben. QAbstractState ist Teil des Qt State Machine Frameworks.

Das Signal entered() wird ausgegeben, wenn der Zustand betreten wurde. Das Signal exited() wird ausgegeben, wenn der Zustand verlassen wurde.

Die Funktion parentState() gibt den übergeordneten Zustand des Zustands zurück. Die Funktion machine() gibt den Zustandsautomaten zurück, zu dem der Zustand gehört.

Unterklassenbildung

Die Funktion onEntry() wird aufgerufen, wenn der Zustand betreten wird; implementieren Sie diese Funktion neu, um eine benutzerdefinierte Verarbeitung durchzuführen, wenn der Zustand betreten wird.

Die Funktion onExit() wird aufgerufen, wenn der Zustand verlassen wird; implementieren Sie diese Funktion neu, um eine benutzerdefinierte Verarbeitung durchzuführen, wenn der Zustand verlassen wird.

Dokumentation der Eigenschaft

[bindable read-only] active : bool

Hinweis: Diese Eigenschaft unterstützt QProperty Bindungen.

Diese Eigenschaft enthält die aktive Eigenschaft dieses Zustands. Ein Zustand ist zwischen den Signalen entered() und exited() aktiv.

Dokumentation der Mitgliedsfunktionen

[protected] QAbstractState::QAbstractState(QState *parent = nullptr)

Konstruiert einen neuen Zustand mit dem angegebenen parent Zustand.

[virtual noexcept] QAbstractState::~QAbstractState()

Zerstört diesen Zustand.

bool QAbstractState::active() const

Gibt zurück, ob dieser Zustand aktiv ist.

Hinweis: Getter-Funktion für die Eigenschaft active.

Siehe auch activeChanged(bool), entered(), und exited().

[signal] void QAbstractState::activeChanged(bool active)

Dieses Signal wird ausgesendet, wenn die aktive Eigenschaft mit active als Argument geändert wird.

Hinweis: Benachrichtigungssignal für die Eigenschaft active.

Siehe auch QAbstractState::active, entered(), und exited().

[private signal] void QAbstractState::entered()

Dieses Signal wird ausgesendet, wenn der Zustand betreten wurde (nachdem onEntry() aufgerufen wurde).

Hinweis: Dies ist ein privates Signal. Es kann in Signalverbindungen verwendet werden, aber nicht vom Benutzer ausgegeben werden.

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

Reimplements: QObject::event(QEvent *e).

[private signal] void QAbstractState::exited()

Dieses Signal wird ausgesendet, wenn der Zustand verlassen wurde (nachdem onExit() aufgerufen wurde).

Hinweis: Dies ist ein privates Signal. Es kann in Signalverbindungen verwendet werden, aber nicht vom Benutzer ausgegeben werden.

QStateMachine *QAbstractState::machine() const

Gibt den Zustandsautomaten zurück, zu dem dieser Zustand gehört, oder nullptr, wenn der Zustand nicht Teil eines Zustandsautomaten ist.

[pure virtual protected] void QAbstractState::onEntry(QEvent *event)

Diese Funktion wird aufgerufen, wenn der Zustand eingetreten ist. Die angegebene event ist das, was den Eintritt in den Zustand verursacht hat. Reimplementieren Sie diese Funktion, um eine benutzerdefinierte Verarbeitung durchzuführen, wenn der Status eingegeben wird.

[pure virtual protected] void QAbstractState::onExit(QEvent *event)

Diese Funktion wird aufgerufen, wenn der Zustand verlassen wird. Die angegebene event ist die Ursache für das Beenden des Zustands. Reimplementieren Sie diese Funktion, um eine benutzerdefinierte Verarbeitung durchzuführen, wenn der Zustand verlassen wird.

QState *QAbstractState::parentState() const

Gibt den übergeordneten Zustand dieses Zustands zurück, oder nullptr, wenn der Zustand keinen übergeordneten Zustand hat.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.