QStateMachine Class

QPushButton button;

QStateMachine machine;
QState *s1 = new QState();
s1->assignProperty(&button, "text", "Click me");

QFinalState *s2 = new QFinalState();
s1->addTransition(&button, &QPushButton::clicked, s2);

machine.addState(s1);
machine.addState(s2);
machine.setInitialState(s1);
machine.start();

Documentation des fonctions membres

[explicit] QStateMachine::QStateMachine(QObject *parent = nullptr)

Crée une nouvelle machine à états à partir de l'parent on fournie.

[virtual noexcept] QStateMachine::~QStateMachine()

Détruit cette machine à états.

void QStateMachine::addDefaultAnimation(QAbstractAnimation *animation)

Ajoute une règle par défaut « animation » à prendre en compte pour toute transition.

void QStateMachine::addState(QAbstractState *state)

Ajoute l'state on indiquée à cette machine à états. L'état devient un état de niveau supérieur et la machine à états en prend la propriété.

Si l'état se trouve déjà dans une autre machine, il sera d'abord supprimé de son ancienne machine, puis ajouté à cette machine.

Voir également ` removeState()` et ` setInitialState()`.

bool QStateMachine::cancelDelayedEvent(int id)

Annule l'événement différé identifié par l'id on fournie. L'identifiant doit être une valeur renvoyée par un appel à la fonction postDelayedEvent(). Renvoie true si l'événement a été annulé avec succès, sinon renvoie false.

Remarque : cette fonction est thread-safe.

Voir également postDelayedEvent().

void QStateMachine::clearError()

Efface la chaîne d'erreur et le code d'erreur de la machine à états.

QSet<QAbstractState *> QStateMachine::configuration() const

Renvoie l'ensemble maximal cohérent d'états (y compris les états parallèles et finaux) dans lesquels se trouve actuellement cette machine à états. Si un état s figure dans la configuration, le parent de s figure toujours également dans c. Notez toutefois que la machine elle-même ne fait pas explicitement partie de la configuration.

QList<QAbstractAnimation *> QStateMachine::defaultAnimations() const

Renvoie la liste des animations par défaut qui seront prises en compte pour toute transition.

QStateMachine::Error QStateMachine::error() const

Renvoie le code d'erreur de la dernière erreur survenue dans la machine à états.

QString QStateMachine::errorString() const

Renvoie la chaîne d'erreur correspondant à la dernière erreur survenue dans la machine à états.

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

Réimplémente : QState::event(QEvent *e).

[override virtual] bool QStateMachine::eventFilter(QObject *watched, QEvent *event)

Réimplémente : QObject::eventFilter(QObject *watched, QEvent *event).

QState::RestorePolicy QStateMachine::globalRestorePolicy() const

Renvoie la politique de restauration de la machine à états.

Voir aussi setGlobalRestorePolicy().

bool QStateMachine::isAnimated() const

Indique si les animations sont activées pour cette machine à états.

[override virtual protected] void QStateMachine::onEntry(QEvent *event)

Réimplémente : QState::onEntry(QEvent *event).

Cette fonction appelle start() pour démarrer la machine à états.

[override virtual protected] void QStateMachine::onExit(QEvent *event)

Réimplémente : ` QState::onExit(QEvent *event)`.

Cette fonction appelle stop() pour arrêter la machine à états, puis émet le signal stopped().

int QStateMachine::postDelayedEvent(QEvent *event, int delay)

Envoie l'event on fournie pour traitement par cette machine à états, avec le délai delay en millisecondes. Renvoie un identifiant associé à l'événement différé, ou -1 si l'événement n'a pas pu être envoyé.

Cette fonction renvoie immédiatement un résultat. Une fois le délai écoulé, l’événement sera ajouté à la file d’attente des événements de la machine à états en vue de son traitement. La machine à états prend possession de l’événement et le supprime une fois qu’il a été traité.

Vous ne pouvez envoyer des événements que lorsque la machine à états est en cours d’exécution.

Remarque : cette fonction est thread-safe.

Voir également cancelDelayedEvent() et postEvent().

int QStateMachine::postDelayedEvent(QEvent *event, std::chrono::milliseconds delay)

Envoie l'event on fournie pour traitement par cette machine à états, avec le délai delay en millisecondes. Renvoie un identifiant associé à l'événement différé, ou -1 si l'événement n'a pas pu être envoyé.

Cette fonction retourne immédiatement. Une fois le délai écoulé, l’événement sera ajouté à la file d’attente des événements de la machine à états pour y être traité. La machine à états prend possession de l’événement et le supprime une fois qu’il a été traité.

Vous ne pouvez envoyer des événements que lorsque la machine à états est en cours d’exécution.

Remarque : cette fonction est sûre pour les threads.

Voir également cancelDelayedEvent() et postEvent().

void QStateMachine::postEvent(QEvent *event, QStateMachine::EventPriority priority = NormalPriority)

Enregistre l'event on spécifiée de l'priority on spécifiée afin qu'elle soit traitée par cette machine à états.

Cette fonction renvoie immédiatement un résultat. L'événement est ajouté à la file d'attente des événements de la machine à états. Les événements sont traités dans l'ordre dans lequel ils ont été envoyés. La machine à états prend en charge l'événement et le supprime une fois qu'il a été traité.

Vous ne pouvez envoyer des événements que lorsque la machine à états est en cours d'exécution ou en phase de démarrage.

Remarque : cette fonction est thread-safe.

Voir également postDelayedEvent().

void QStateMachine::removeDefaultAnimation(QAbstractAnimation *animation)

Supprime « animation » de la liste des animations par défaut.

void QStateMachine::removeState(QAbstractState *state)

Supprime l'state on indiquée de cette machine à états. La machine à états libère la propriété de l'état.

Voir aussi ` addState()`.

[signal] void QStateMachine::runningChanged(bool running)

Ce signal est émis lorsque la propriété « running » est modifiée avec « running » comme argument.

Voir également « QStateMachine::running ».

void QStateMachine::setAnimated(bool enabled)

Détermine si les animations sont « enabled » pour cette machine à états.

Voir aussi ` isAnimated()`.

void QStateMachine::setGlobalRestorePolicy(QState::RestorePolicy restorePolicy)

Définit la politique de restauration de la machine à états sur « restorePolicy ». La politique de restauration par défaut est « QState::DontRestoreProperties ».

Voir également globalRestorePolicy().

[slot] void QStateMachine::start()

Lance cette machine à états. La machine réinitialise sa configuration et passe à l'état initial. Lorsqu'un état final de niveau supérieur (QFinalState) est atteint, la machine émet le signal finished().

Voir également started(), finished(), stop(), initialState() et setRunning().

[private signal] void QStateMachine::started()

Ce signal est émis lorsque la machine à états est entrée dans son état initial (QStateMachine::initialState).

Voir également QStateMachine::finished() et QStateMachine::start().

[slot] void QStateMachine::stop()

Arrête cette machine à états. La machine à états cessera de traiter les événements, puis émettra le signal stopped().

Voir également stopped(), start() et setRunning().

[private signal] void QStateMachine::stopped()

Ce signal est émis lorsque la machine à états s'est arrêtée.

Voir également QStateMachine::stop() et QStateMachine::finished().