En esta página

QAbstractState Class

La clase `QAbstractState` es la clase base de los estados de un ` QStateMachine`. Más información...

Encabezado: #include <QAbstractState>
CMake: find_package(Qt6 REQUIRED COMPONENTS StateMachine)
target_link_libraries(mytarget PRIVATE Qt6::StateMachine)
qmake: QT += statemachine
Heredado de: 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 de estado tienen en común. `QAbstractState` forma parte del marco de trabajo `Qt State Machine `.

La señal « entered()» se emite cuando se entra en el estado. La señal « exited()» se emite cuando se sale del estado.

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

Subclasificación

La función onEntry() se invoca al entrar en el estado; reimplementa esta función para realizar un procesamiento personalizado al entrar en el estado.

La función onExit() se invoca al salir del estado; reimplementa esta función para realizar un procesamiento personalizado al salir del estado.

Documentación de propiedades

[bindable read-only] active : bool

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

Esta propiedad contiene la propiedad «active» de este estado. Un estado se considera activo entre las señales « entered()» y « exited()».

Funciones de acceso:

bool active() const

Señal del notificador:

void activeChanged(bool active)

Documentación de funciones de miembro

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

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

[virtual noexcept] QAbstractState::~QAbstractState()

Elimina este estado.

bool QAbstractState::active() const

Devuelve si este estado está activo.

Nota: Funcióngetter para la propiedad active.

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

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

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

Nota: Señalde notificador 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 (tras llamar a onEntry()).

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

[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 (tras llamar a ` onExit()`).

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

QStateMachine *QAbstractState::machine() const

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

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

Esta función se invoca al entrar en el estado. El objeto ` event ` proporcionado es el que ha provocado la entrada en el estado. Reimplementa esta función para realizar un procesamiento personalizado al entrar en el estado.

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

Esta función se invoca al salir del estado. El objeto ` event ` proporcionado es el que ha provocado la salida del estado. Reimplementa esta función para realizar un procesamiento personalizado al salir 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.