En esta página

QAbstractState Class

La clase QAbstractState es la clase base de los estados de un QStateMachine. Más...

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

QFinalState, QHistoryState, y QState

Propiedades

Funciones públicas

virtual ~QAbstractState()
bool active() const
QBindable<bool> bindableActive()
QStateMachine *machine() const
QState *parentState() const

Señales

void activeChanged(bool active)
void entered()
void exited()

Funciones protegidas

QAbstractState(QState *parent = nullptr)
virtual void onEntry(QEvent *event) = 0
virtual void onExit(QEvent *event) = 0

Funciones protegidas reimplementadas

virtual bool event(QEvent *e) override

Descripción detallada

La clase QAbstractState es la clase base abstracta de los estados que forman parte de un QStateMachine. Define la interfaz que todos los objetos estado tienen en común. QAbstractState es parte de Qt State Machine Framework.

La señal entered() se emite cuando se ha entrado en el estado. La señal exited() se emite cuando se sale del estado.

La función parentState() devuelve el estado padre del estado. La función machine() devuelve la máquina de estados de la que forma parte el estado.

Subclase

Se llama a la función onEntry() cuando se entra en el estado; reimplemente esta función para realizar un procesamiento personalizado cuando se entra en el estado.

Se llama a la función onExit() cuando se sale del estado; reimplemente esta función para realizar un procesamiento personalizado cuando se sale del estado.

Documentación de propiedades

[bindable read-only] active : bool

Nota: Esta propiedad admite enlaces QProperty.

Esta propiedad contiene la propiedad activa de este estado. Un estado está activo entre las señales entered() y exited().

Funciones de acceso:

bool active() const

Señal de notificador:

void activeChanged(bool active)

Documentación de la función miembro

[protected] QAbstractState::QAbstractState(QState *parent = nullptr)

Construye un nuevo estado con el estado parent dado.

[virtual noexcept] QAbstractState::~QAbstractState()

Destruye este estado.

bool QAbstractState::active() const

Devuelve si este estado está activo.

Nota: Función Getter para la propiedad active.

Ver también activeChanged(bool), entered(), y exited().

[signal] void QAbstractState::activeChanged(bool active)

Esta señal se emite cuando se cambia la propiedad activa con active como argumento.

Nota: Señal notificadora para la propiedad active.

Véase también QAbstractState::active, entered(), y exited().

[private signal] void QAbstractState::entered()

Esta señal se emite cuando se ha entrado en el estado (después de llamar a onEntry()).

Nota: Se trata de una señal privada. Puede ser utilizada en conexiones de señales pero no puede ser emitida por el usuario.

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

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

[private signal] void QAbstractState::exited()

Esta señal se emite cuando se ha salido del estado (después de llamar a onExit()).

Nota: Se trata de una señal privada. Puede ser utilizada en conexiones de señales pero no puede ser emitida por el usuario.

QStateMachine *QAbstractState::machine() const

Devuelve la máquina de estados de la que forma parte este estado, o nullptr si el estado no forma parte de ninguna máquina de estados.

[pure virtual protected] void QAbstractState::onEntry(QEvent *event)

Se llama a esta función cuando se introduce el estado. El event dado es lo que causó que se introdujera el estado. Reimplemente esta función para realizar un procesamiento personalizado cuando se introduzca el estado.

[pure virtual protected] void QAbstractState::onExit(QEvent *event)

Esta función es llamada cuando se sale del estado. El event dado es lo que causó la salida del estado. Reimplemente esta función para realizar un procesamiento personalizado cuando se sale del estado.

QState *QAbstractState::parentState() const

Devuelve el estado padre de este estado, o nullptr si el estado no tiene estado padre.

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