Sur cette page

State QML Type

Fournit un état polyvalent pour StateMachine. En savoir plus...

Import Statement: import QtQml.StateMachine 6.12
Inherits:

QAbstractState

Inherited By:

StateMachine

Propriétés

Signaux

Description détaillée

Les objets « état » peuvent avoir des états enfants ainsi que des transitions vers d'autres états. L'état fait partie de l'API QML deQt State Machine

États avec des états enfants

La propriété childMode détermine la manière dont les états enfants sont traités. Pour les groupes d’états non parallèles, la propriété initialState doit être utilisée pour définir l’état initial. Les états enfants sont des états mutuellement exclusifs, et la machine à états doit savoir dans quel état enfant entrer lorsque l’état parent est la cible d’une transition.

L'état émet le signal State::finished() lorsqu'un état enfant final (FinalState) est atteint.

La méthode errorState définit l’état d’erreur de l’état. L’état d’erreur est l’état vers lequel la machine à états effectuera une transition si une erreur est détectée lors de la tentative d’entrée dans l’état (par exemple, parce qu’aucun état initial n’a été défini).

Exemple d'utilisation

import QtQuick
import QtQml.StateMachine as DSM

Rectangle {
    DSM.StateMachine {
        id: stateMachine
        initialState: state
        running: true
        DSM.State {
            id: state
        }
    }
}

Voir également StateMachine et FinalState.

Documentation sur les propriétés

childMode : enumeration

Le mode enfant de cet état

La valeur par défaut de cette propriété est QState.ExclusiveStates.

Cette énumération spécifie comment les états enfants d'un état sont traités :

  • QState.ExclusiveStates Les états enfants s'excluent mutuellement et un état initial doit être défini en configurant la propriété initialState.
  • QState.ParallelStates : les états enfants sont parallèles. Lorsque l'état parent est activé, tous ses états enfants sont activés en parallèle.

errorState : QAbstractState

L'état d'erreur de cet état.

initialState : QAbstractState

L'état initial de cet état (l'un de ses états enfants).

Documentation sur les signaux

finished()

Ce signal est émis lorsqu'on entre dans un état fils final de cet état.

Remarque : le gestionnaire correspondant est onFinished.

Voir également QAbstractState::active, QAbstractState::entered et QAbstractState::exited.

© 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.