QAbstractState Class
Die Klasse „QAbstractState“ ist die Basisklasse für Zustände eines „ QStateMachine “. Mehr...
| Header: | #include <QAbstractState> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS StateMachine) target_link_libraries(mytarget PRIVATE Qt6::StateMachine) |
| qmake: | QT += statemachine |
| Erbt von: | QObject |
| Vererbt an: | QFinalState, QHistoryState sowie QState |
Eigenschaften
- active : bool
Ö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 |
Neu implementierte geschützte Funktionen
| virtual bool | event(QEvent *e) override |
Ausführliche 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 ausgelöst, wenn der Zustand erreicht wurde. Das Signal „ exited()“ wird ausgelöst, wenn der Zustand verlassen wurde.
Die Funktion „ parentState()“ gibt den übergeordneten Zustand zurück. Die Funktion „ machine()“ gibt die Zustandsmaschine zurück, zu der der Zustand gehört.
Unterklassenbildung
Die Funktion ` onEntry()` wird aufgerufen, wenn der Zustand betreten wird; implementieren Sie diese Funktion neu, um beim Betreten des Zustands benutzerdefinierte Verarbeitungsschritte auszuführen.
Die Funktion ` onExit()` wird aufgerufen, wenn der Zustand verlassen wird; implementieren Sie diese Funktion neu, um beim Verlassen des Zustands benutzerdefinierte Verarbeitungsschritte durchzuführen.
Dokumentation zu den Eigenschaften
[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.
Zugriffsfunktionen:
| bool | active() const |
Notifier-Signal:
| void | activeChanged(bool active) |
Dokumentation zu den Member-Funktionen
[protected] QAbstractState::QAbstractState(QState *parent = nullptr)
Erstellt einen neuen Zustand auf der Grundlage des angegebenen Zustands „ parent “.
[virtual noexcept] QAbstractState::~QAbstractState()
Löst diesen Zustand auf.
bool QAbstractState::active() const
Gibt zurück, ob dieser Status 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 ausgelöst, wenn die aktive Eigenschaft mit dem Argument „ active “ geändert wird.
Hinweis: Notifier -Signal für die Eigenschaft „ active “.
Siehe auch „ QAbstractState::active“ , „ entered()“ und „ exited()“.
[private signal] void QAbstractState::entered()
Dieses Signal wird ausgelöst, wenn der Zustand erreicht wurde (nach dem Aufruf von ` onEntry()`).
Hinweis: Dies ist ein privates Signal. Es kann in Signalverbindungen verwendet werden, kann jedoch nicht vom Benutzer ausgelöst werden.
[override virtual protected] bool QAbstractState::event(QEvent *e)
Implementiert: QObject::event(QEvent *e).
[private signal] void QAbstractState::exited()
Dieses Signal wird ausgelöst, wenn der Zustand verlassen wurde (nach dem Aufruf von ` onExit()`).
Hinweis: Dies ist ein privates Signal. Es kann in Signalverbindungen verwendet werden, kann jedoch nicht vom Benutzer ausgelöst werden.
QStateMachine *QAbstractState::machine() const
Gibt die Zustandsmaschine zurück, zu der dieser Zustand gehört, oder „ nullptr “, falls der Zustand nicht zu einer Zustandsmaschine gehört.
[pure virtual protected] void QAbstractState::onEntry(QEvent *event)
Diese Funktion wird aufgerufen, wenn der Zustand erreicht wird. Der angegebene Parameter „ event “ gibt an, wodurch der Zustand ausgelöst wurde. Implementieren Sie diese Funktion neu, um beim Erreichen des Zustands eine benutzerdefinierte Verarbeitung durchzuführen.
[pure virtual protected] void QAbstractState::onExit(QEvent *event)
Diese Funktion wird aufgerufen, wenn der Zustand verlassen wird. Der angegebene Parameter „ event “ gibt an, was zum Verlassen des Zustands geführt hat. Implementieren Sie diese Funktion neu, um beim Verlassen des Zustands benutzerdefinierte Verarbeitungsschritte durchzuführen.
QState *QAbstractState::parentState() const
Gibt den übergeordneten Zustand dieses Zustands zurück oder „ nullptr “, falls der Zustand keinen übergeordneten Zustand hat.
© 2026 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.
