Sur cette page

State QML Type

Fournit un état général pour StateMachine. Plus d'informations...

Import Statement: import QtQml.StateMachine 6.11
Inherits:

QAbstractState

Inherited By:

StateMachine

Propriétés

Signaux

Description détaillée

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

États avec é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 entré.

Le signal errorState définit l'état d'erreur de l'état. L'état d'erreur est l'état vers lequel la machine à états passe si une erreur est détectée lors d'une 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 la manière dont les états enfants d'un état sont traités :

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

errorState : QAbstractState

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

initialState : QAbstractState

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

Documentation sur les signaux

finished()

Ce signal est émis lorsqu'un état enfant final de cet état est entré.

Remarque : le gestionnaire correspondant est onFinished.

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