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: |
Tipos públicos
| enum | ChildMode { ExclusiveStates, ParallelStates } |
| enum | RestorePolicy { DontRestoreProperties, RestoreProperties } |
Propiedades
- childMode : ChildMode
- errorState : QAbstractState*
- initialState : QAbstractState*
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
| void | childModeChanged() |
| void | errorStateChanged() |
| void | finished() |
| void | initialStateChanged() |
| void | propertiesAssigned() |
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.
| Constante | Valor | Descripción |
|---|---|---|
QState::ExclusiveStates | 0 | Los estados secundarios son mutuamente excluyentes y se debe establecer un estado inicial llamando a ` QState::setInitialState()`. |
QState::ParallelStates | 1 | Los 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.
| Constante | Valor | Descripción |
|---|---|---|
QState::DontRestoreProperties | 0 | La máquina de estados no debe guardar los valores iniciales de las propiedades ni restaurarlos posteriormente. |
QState::RestoreProperties | 1 | La 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.