QAbstractState Class
La classe `QAbstractState` est la classe de base des états d'un ` QStateMachine`. En savoir plus...
| En-tête : | #include <QAbstractState> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS StateMachine) target_link_libraries(mytarget PRIVATE Qt6::StateMachine) |
| qmake : | QT += statemachine |
| Hérite de : | QObject |
| Hérité par : |
Propriétés
- active : bool
Fonctions publiques
| virtual | ~QAbstractState() |
| bool | active() const |
| QBindable<bool> | bindableActive() |
| QStateMachine * | machine() const |
| QState * | parentState() const |
Signaux
| void | activeChanged(bool active) |
| void | entered() |
| void | exited() |
Fonctions protégées
| QAbstractState(QState *parent = nullptr) | |
| virtual void | onEntry(QEvent *event) = 0 |
| virtual void | onExit(QEvent *event) = 0 |
Fonctions protégées réimplémentées
| virtual bool | event(QEvent *e) override |
Description détaillée
La classe QAbstractState est la classe de base abstraite des états qui font partie d'un QStateMachine. Elle définit l'interface commune à tous les objets d'état. QAbstractState fait partie du frameworkQt State Machine .
Le signal ` entered()` est émis lorsque l'état est activé. Le signal ` exited()` est émis lorsque l'état est désactivé.
La fonction parentState() renvoie l'état parent de l'état. La fonction machine() renvoie la machine à états dont l'état fait partie.
Sous-classement
La fonction onEntry() est appelée lorsque l'état est activé ; réimplémentez cette fonction pour effectuer un traitement personnalisé lors de l'activation de l'état.
La fonction ` onExit()` est appelée lorsque l’on quitte l’état ; réimplémentez cette fonction pour effectuer un traitement personnalisé lors de la sortie de l’état.
Documentation des propriétés
[bindable read-only] active : bool
Remarque : cette propriété prend en charge les liaisons de type « QProperty ».
Cette propriété contient la propriété « active » de cet état. Un état est actif entre les signaux « entered() » et « exited() ».
Fonctions d'accès :
| bool | active() const |
Signal de notification :
| void | activeChanged(bool active) |
Documentation des fonctions membres
[protected] QAbstractState::QAbstractState(QState *parent = nullptr)
Crée un nouvel état à partir de l'état « parent » donné.
[virtual noexcept] QAbstractState::~QAbstractState()
Supprime cet état.
bool QAbstractState::active() const
Indique si cet état est actif.
Remarque : fonctionde lecture de la propriété « active ».
Voir également activeChanged(bool), entered() et exited().
[signal] void QAbstractState::activeChanged(bool active)
Ce signal est émis lorsque la propriété active est modifiée avec « active » comme argument.
Remarque : signalde notification pour la propriété active.
Voir également QAbstractState::active, entered() et exited().
[private signal] void QAbstractState::entered()
Ce signal est émis lorsque l'état a été activé (après l'appel de la fonction ` onEntry()`).
Remarque : il s'agit d'un signal privé. Il peut être utilisé dans les connexions de signaux, mais ne peut pas être émis par l'utilisateur.
[override virtual protected] bool QAbstractState::event(QEvent *e)
Réimplémente : QObject::event(QEvent *e).
[private signal] void QAbstractState::exited()
Ce signal est émis lorsque l'état a été quitté (après l'appel de la fonction ` onExit()`).
Remarque : il s'agit d'un signal privé. Il peut être utilisé dans les connexions de signaux, mais ne peut pas être émis par l'utilisateur.
QStateMachine *QAbstractState::machine() const
Renvoie la machine à états dont cet état fait partie, ou ` nullptr ` si l'état ne fait pas partie d'une machine à états.
[pure virtual protected] void QAbstractState::onEntry(QEvent *event)
Cette fonction est appelée lors de l'entrée dans cet état. L'event on fournie correspond à l'événement ayant provoqué l'entrée dans cet état. Réimplémentez cette fonction pour effectuer un traitement personnalisé lors de l'entrée dans cet état.
[pure virtual protected] void QAbstractState::onExit(QEvent *event)
Cette fonction est appelée lorsque l'état est quitté. L'event, est la cause de la sortie de l'état. Réimplémentez cette fonction pour effectuer un traitement personnalisé lorsque l'état est quitté.
QState *QAbstractState::parentState() const
Renvoie l'état parent de cet état, ou ` nullptr ` si l'état n'a pas d'état parent.
© 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.
