En esta página

State QML Type

Proporciona un estado de propósito general para StateMachine. Más...

Import Statement: import QtQml.StateMachine 6.11
Inherits:

QAbstractState

Inherited By:

StateMachine

Propiedades

Señales

Descripción detallada

Los objetos State pueden tener estados hijos así como transiciones a otros estados. State forma parte de Qt State Machine QML API

Estados con estados hijo

La propiedad childMode determina cómo se tratan los estados hijos. Para grupos de estados no paralelos, debe utilizarse la propiedad initialState para establecer el estado inicial. Los estados hijos son estados mutuamente excluyentes, y la máquina de estados necesita saber en qué estado hijo entrar cuando el estado padre es el objetivo de una transición.

El estado emite la señal State::finished() cuando se entra en un estado hijo final (FinalState).

errorState establece el estado de error del estado. El estado de error es el estado al que la máquina de estados realizará la transición si se detecta un error al intentar entrar en el estado (por ejemplo, porque no se ha establecido un estado inicial).

Ejemplo de uso

import QtQuick
import QtQml.StateMachine as DSM

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

Véase también StateMachine y FinalState.

Documentación de propiedades

childMode : enumeration

El modo hijo de este estado

El valor por defecto de esta propiedad es QState.ExclusiveStates.

Este enum especifica cómo se tratan los estados hijos de un estado:

  • QState.ExclusiveStates Los estados hijos son mutuamente excluyentes y debe establecerse un estado inicial configurando la propiedad initialState.
  • QStateParallelStates Los estados hijos son paralelos. Cuando se entra en el estado padre, se entra en todos sus estados hijos en paralelo.

errorState : QAbstractState

El estado de error de este estado.

initialState : QAbstractState

El estado inicial de este estado (uno de sus estados hijos).

Documentación de señales

finished()

Esta señal se emite cuando se introduce un estado hijo final de este estado.

Nota: El manejador correspondiente es onFinished.

Véase también QAbstractState::active, QAbstractState::entered, y 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.