En esta página

QState Class

La clase QState proporciona un estado de uso general para QStateMachine. Más información...

Encabezado: #include <QState>
CMake: find_package(Qt6 REQUIRED COMPONENTS StateMachine)
target_link_libraries(mytarget PRIVATE Qt6::StateMachine)
qmake: QT += statemachine
Heredado de: QAbstractState
Heredado por:

QStateMachine

Tipos públicos

enum ChildMode { ExclusiveStates, ParallelStates }
enum RestorePolicy { DontRestoreProperties, RestoreProperties }

Propiedades

Funciones públicas

QState(QState *parent = nullptr)
QState(QState::ChildMode childMode, QState *parent = nullptr)
virtual ~QState()
QAbstractTransition *addTransition(QAbstractState *target)
void addTransition(QAbstractTransition *transition)
QSignalTransition *addTransition(const QObject *sender, const char *signal, QAbstractState *target)
QSignalTransition *addTransition(const QObject *sender, PointerToMemberFunction signal, QAbstractState *target)
void assignProperty(QObject *object, const char *name, const QVariant &value)
QBindable<QState::ChildMode> bindableChildMode()
QBindable<QAbstractState *> bindableErrorState()
QBindable<QAbstractState *> bindableInitialState()
QState::ChildMode childMode() const
QAbstractState *errorState() const
QAbstractState *initialState() const
void removeTransition(QAbstractTransition *transition)
void setChildMode(QState::ChildMode mode)
void setErrorState(QAbstractState *state)
void setInitialState(QAbstractState *state)
QList<QAbstractTransition *> transitions() const

Señales

Funciones protegidas reimplementadas

virtual bool event(QEvent *e) override
virtual void onEntry(QEvent *event) override
virtual void onExit(QEvent *event) override

Descripción detallada

Los objetos QState pueden tener estados secundarios y pueden tener transiciones a otros estados. QState forma parte del marco de trabajo «Qt State Machine ».

La función ` addTransition()` añade una transición. La función ` removeTransition()` elimina una transición. La función ` transitions()` devuelve las transiciones salientes del estado.

La función ` assignProperty()` se utiliza para definir las asignaciones de propiedades que deben realizarse al entrar en un estado.

A los estados de nivel superior se les debe pasar un objeto ` QStateMachine ` como estado padre, o bien añadirse a una máquina de estados mediante ` QStateMachine::addState()`.

Estados con estados hijos

La propiedad ` childMode ` determina cómo se tratan los estados hijos. Para grupos de estados no paralelos, se debe llamar a la función ` setInitialState()` para establecer el estado inicial. Los estados hijos son estados mutuamente excluyentes, y la máquina de estados necesita saber a qué estado hijo debe entrar cuando el estado padre es el destino de una transición.

El estado emite la señal « QState::finished()» cuando se accede a un estado hijo final (QFinalState).

La función ` setErrorState()` establece el estado de error del estado. El estado de error es aquel al que pasará la máquina de estados si se detecta un error al intentar entrar en el estado (por ejemplo, porque no se ha establecido ningún estado inicial).

Documentación sobre los tipos de miembros

enum QState::ChildMode

Esta enumeración especifica cómo se tratan los estados secundarios de un estado.

ConstanteValorDescripción
QState::ExclusiveStates0Los estados secundarios son mutuamente excluyentes y se debe establecer un estado inicial llamando a ` QState::setInitialState()`.
QState::ParallelStates1Los estados secundarios son paralelos. Cuando se entra en el estado principal, se entra en todos sus estados secundarios de forma paralela.

enum QState::RestorePolicy

Esta enumeración especifica el tipo de política de restauración. La política de restauración entra en vigor cuando la máquina pasa a un estado en el que se establecen una o más propiedades. Si la política de restauración se establece en «RestoreProperties», la máquina de estados guardará el valor original de la propiedad antes de que se establezca el nuevo valor.

Posteriormente, cuando la máquina entre en un estado en el que no se establezca un valor para la propiedad en cuestión, esta se restaurará automáticamente a su valor inicial.

Solo se guardará un valor inicial para cada propiedad. Si la máquina de estados ya ha guardado un valor para una propiedad, este no se sobrescribirá hasta que la propiedad se haya restaurado correctamente.

ConstanteValorDescripción
QState::DontRestoreProperties0La máquina de estados no debe guardar los valores iniciales de las propiedades ni restaurarlos posteriormente.
QState::RestoreProperties1La máquina de estados debe guardar los valores iniciales de las propiedades y restaurarlos posteriormente.

Véase también QStateMachine::globalRestorePolicy y QState::assignProperty().

Documentación de las propiedades

[bindable] childMode : ChildMode

Nota: Esta propiedad admite enlaces de tipo « QProperty ».

Esta propiedad contiene el modo secundario de este estado

El valor por defecto de esta propiedad es « QState::ExclusiveStates ».

Funciones de acceso:

QState::ChildMode childMode() const
void setChildMode(QState::ChildMode mode)

Señal de notificador:

void childModeChanged()[see note below]

Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.

[bindable] errorState : QAbstractState*

Nota: Esta propiedad admite enlaces de tipo « QProperty ».

Esta propiedad contiene el estado de error de este estado

Funciones de acceso:

QAbstractState *errorState() const
void setErrorState(QAbstractState *state)

Señal de notificación:

void errorStateChanged()[see note below]

Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.

[bindable] initialState : QAbstractState*

Nota: Esta propiedad admite enlaces de tipo « QProperty ».

Esta propiedad contiene el estado inicial de este estado (uno de sus estados secundarios)

Funciones de acceso:

QAbstractState *initialState() const
void setInitialState(QAbstractState *state)

Señal de notificador:

void initialStateChanged()[see note below]

Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.

Documentación de las funciones miembro

QState::QState(QState *parent = nullptr)

Crea un nuevo estado a partir del estado « parent » proporcionado.

QState::QState(QState::ChildMode childMode, QState *parent = nullptr)

Crea un nuevo estado a partir del « childMode » y del estado « parent » indicados.

[virtual noexcept] QState::~QState()

Elimina este estado.

QAbstractTransition *QState::addTransition(QAbstractState *target)

Añade una transición incondicional desde este estado al estado target especificado y devuelve el nuevo objeto de transición.

void QState::addTransition(QAbstractTransition *transition)

Añade la « transition » indicada. La transición tiene este estado como origen. Este estado asume la responsabilidad de la transición.

QSignalTransition *QState::addTransition(const QObject *sender, const char *signal, QAbstractState *target)

Añade una transición asociada al objeto « signal » especificado del objeto « sender » indicado, y devuelve el nuevo objeto « QSignalTransition ». La transición tiene este estado como origen y el objeto « target » especificado como estado de destino.

template <typename PointerToMemberFunction> QSignalTransition *QState::addTransition(const QObject *sender, PointerToMemberFunction signal, QAbstractState *target)

Añade una transición asociada al objeto « signal » especificado del objeto « sender » indicado y devuelve el nuevo objeto « QSignalTransition ». La transición tiene este estado como origen y el estado « target » especificado como destino.

Esta es una función sobrecargada.

void QState::assignProperty(QObject *object, const char *name, const QVariant &value)

Indica a este estado que establezca la propiedad con el name especificado del object especificado en el value especificado al entrar en dicho estado.

Véase también propertiesAssigned().

QState::ChildMode QState::childMode() const

Devuelve el modo secundario de este estado.

Nota: Funcióngetter para la propiedad childMode.

Véase también setChildMode().

[private signal] void QState::childModeChanged()

Esta señal se emite cuando se modifica la propiedad « childMode ».

Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.

Nota: Señalde notificación para la propiedad childMode.

Véase también QState::childMode.

QAbstractState *QState::errorState() const

Devuelve el estado de error de este estado.

Nota: Funcióngetter para la propiedad errorState.

Véase también setErrorState() y QStateMachine::error().

[private signal] void QState::errorStateChanged()

Esta señal se emite cuando se modifica la propiedad « errorState ».

Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.

Nota: Señalde notificación para la propiedad ` errorState`.

Véase también QState::errorState.

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

Reimplementa: QAbstractState::event(QEvent *e).

[private signal] void QState::finished()

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

Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.

Véase también « QFinalState ».

QAbstractState *QState::initialState() const

Devuelve el estado inicial de este estado o ` nullptr ` si el estado no tiene estado inicial.

Nota: Funcióngetter para la propiedad initialState.

Véase también setInitialState().

[private signal] void QState::initialStateChanged()

Esta señal se emite cuando se modifica la propiedad « initialState ».

Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.

Nota: Señalde notificación para la propiedad ` initialState`.

Véase también QState::initialState.

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

Reimplementa: QAbstractState::onEntry(QEvent *event).

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

Reimplementa: ` QAbstractState::onExit(QEvent *event)`.

[private signal] void QState::propertiesAssigned()

Esta señal se emite cuando se ha asignado el valor definitivo a todas las propiedades. Si el estado asigna un valor a una o varias propiedades para las que existe una animación (ya sea configurada en la transición o como animación predeterminada en la máquina de estados), la señal no se emitirá hasta que todas esas animaciones hayan finalizado.

Si no hay animaciones relevantes o no se han definido asignaciones de propiedades para el estado, la señal se emitirá inmediatamente antes de entrar en el estado.

Véase también QState::assignProperty() y QAbstractTransition::addAnimation()

Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.

void QState::removeTransition(QAbstractTransition *transition)

Elimina la transición transition especificada de este estado. El estado libera la propiedad de la transición.

Véase también addTransition().

void QState::setChildMode(QState::ChildMode mode)

Establece la propiedad secundaria ` mode ` de este estado.

Nota: Funciónde asignación para la propiedad childMode.

Véase también ` childMode()`.

void QState::setErrorState(QAbstractState *state)

Establece el estado de error de este estado en el valor dado state. Si el estado de error no está establecido, o si se ha establecido en nullptr, el estado heredará el estado de error de su padre de forma recursiva. Si no se ha establecido ningún estado de error para el propio estado ni para ninguno de sus antecesores, un error provocará que la máquina deje de ejecutarse y se mostrará un mensaje de error en la consola.

Nota: Funciónde asignación para la propiedad errorState.

Véase también ` errorState()`.

void QState::setInitialState(QAbstractState *state)

Establece el estado inicial de este estado en el valor dado state. state debe ser un elemento secundario de este estado.

Nota: Funciónde asignación para la propiedad « initialState ».

Véase también initialState().

QList<QAbstractTransition *> QState::transitions() const

Devuelve las transiciones salientes de este estado (es decir, aquellas en las que este estado es el « source state »), o una lista vacía si este estado no tiene transiciones salientes.

Véase también addTransition().

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