Sur cette page

QAbstractState Class

La classe QAbstractState est la classe de base des états d'un site QStateMachine. 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 : QObject
Hérités par :

QFinalState, QHistoryState, et QState

Propriétés

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 site QStateMachine. Elle définit l'interface que tous les objets d'état ont en commun. QAbstractState fait partie du cadreQt State Machine .

Le signal entered() est émis lorsque l'état a été saisi. Le signal exited() est émis lorsque l'état a été quitté.

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 à l'entrée de l'état ; réimplémentez cette fonction pour effectuer un traitement personnalisé à l'entrée de l'état.

La fonction onExit() est appelée lorsque l'état est quitté ; réimplémentez cette fonction pour effectuer un traitement personnalisé lorsque l'état est quitté.

Documentation sur les propriétés

[bindable read-only] active : bool

Note : Cette propriété prend en charge les liaisons 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 Notificateur :

void activeChanged(bool active)

Member Function Documentation

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

Construit un nouvel état avec l'état parent donné.

[virtual noexcept] QAbstractState::~QAbstractState()

Détruit cet état.

bool QAbstractState::active() const

Retourne si cet état est actif.

Remarque : fonction Getter pour la propriété active.

Voir aussi 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.

Note : Signal de notification pour la propriété active.

Voir aussi QAbstractState::active, entered(), et exited().

[private signal] void QAbstractState::entered()

Ce signal est émis lorsque l'état a été saisi (après que onEntry() a été appelé).

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 que onExit() a été appelé).

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 lorsque l'état est entré. L'adresse event donnée est ce qui a provoqué l'entrée dans l'état. Réimplémentez cette fonction pour effectuer un traitement personnalisé lors de l'entrée dans l'état.

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

Cette fonction est appelée lorsque l'état est quitté. L'adresse event donnée est celle qui a provoqué 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.