En esta página

QAbstractTransition Class

La clase `QAbstractTransition` es la clase base de las transiciones entre objetos ` QAbstractState `. Más información...

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

QEventTransition y QSignalTransition

Tipos públicos

enum TransitionType { ExternalTransition, InternalTransition }

Propiedades

Funciones públicas

QAbstractTransition(QState *sourceState = nullptr)
virtual ~QAbstractTransition()
void addAnimation(QAbstractAnimation *animation)
QList<QAbstractAnimation *> animations() const
QBindable<QAbstractTransition::TransitionType> bindableTransitionType()
QStateMachine *machine() const
void removeAnimation(QAbstractAnimation *animation)
void setTargetState(QAbstractState *target)
void setTargetStates(const QList<QAbstractState *> &targets)
void setTransitionType(QAbstractTransition::TransitionType type)
QState *sourceState() const
QAbstractState *targetState() const
QList<QAbstractState *> targetStates() const
QAbstractTransition::TransitionType transitionType() const

Señales

Funciones protegidas

virtual bool eventTest(QEvent *event) = 0
virtual void onTransition(QEvent *event) = 0

Funciones protegidas reimplementadas

virtual bool event(QEvent *e) override

Descripción detallada

La clase `QAbstractTransition` es la clase base abstracta de las transiciones entre estados (objetos `QAbstractState `) de un ` QStateMachine`. `QAbstractTransition` forma parte del marco de trabajo «Qt State Machine ».

La función sourceState() devuelve el origen de la transición. La función targetStates() devuelve los destinos de la transición. La función machine() devuelve la máquina de estados de la que forma parte la transición.

La señal triggered() se emite cuando se ha activado la transición.

Las transiciones pueden provocar la reproducción de animaciones. Utiliza la función addAnimation() para añadir una animación a la transición.

Subclasificación

La máquina de estados llama a la función eventTest() para determinar si un evento debe activar la transición. En la reimplementación, lo habitual es comprobar el tipo de evento, convertir el objeto del evento al tipo adecuado y verificar que una o varias propiedades del evento cumplan los criterios establecidos.

La función onTransition() se invoca cuando se activa la transición; reimplementa esta función para realizar un procesamiento personalizado de la transición.

Documentación sobre los tipos de miembros

enum QAbstractTransition::TransitionType

Esta enumeración especifica el tipo de transición. Por defecto, el tipo es una transición externa.

ConstanteValorDescripción
QAbstractTransition::ExternalTransition0Cualquier estado que sea el estado de origen de una transición (que no sea una transición sin destino) se abandona y se vuelve a entrar en él cuando sea necesario.
QAbstractTransition::InternalTransition1Si el estado de destino de una transición es un subestado de un estado compuesto, y ese estado compuesto es el estado de origen, una transición interna no abandonará el estado de origen.

Véase también « QAbstractTransition::transitionType ».

Documentación de propiedades

[read-only] sourceState : QState*

Esta propiedad contiene el estado de origen (padre) de esta transición

Funciones de acceso:

QState *sourceState() const

targetState : QAbstractState*

Esta propiedad contiene el estado de destino de esta transición

Si una transición no tiene estado de destino, la transición puede activarse de todos modos, pero esto no provocará que cambie la configuración de la máquina de estados (es decir, no se saldrá del estado actual ni se volverá a entrar en él).

Funciones de acceso:

QAbstractState *targetState() const
void setTargetState(QAbstractState *target)

Señal de notificación:

void targetStateChanged()[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.

targetStates : QList<QAbstractState*>

Esta propiedad contiene los estados de destino de esta transición

Si se especifican varios estados, todos deben ser descendientes del mismo estado de grupo paralelo.

Funciones de acceso:

QList<QAbstractState *> targetStates() const
void setTargetStates(const QList<QAbstractState *> &targets)

Señal de notificación:

void targetStatesChanged()[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] transitionType : TransitionType

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

Indica si esta transición es una transición interna o una transición externa.

Las transiciones internas y externas se comportan de la misma manera, salvo en el caso de una transición cuyo estado de origen sea un estado compuesto y cuyo destino o destinos sean descendientes del estado de origen. En tal caso, una transición interna no saldrá ni volverá a entrar en su estado de origen, mientras que una externa sí lo hará.

Por defecto, el tipo es una transición externa.

Funciones de acceso:

QAbstractTransition::TransitionType transitionType() const
void setTransitionType(QAbstractTransition::TransitionType type)

Documentación de funciones miembro

QAbstractTransition::QAbstractTransition(QState *sourceState = nullptr)

Crea un nuevo objeto `QAbstractTransition` con el ` sourceState` indicado.

[virtual noexcept] QAbstractTransition::~QAbstractTransition()

Elimina esta transición.

void QAbstractTransition::addAnimation(QAbstractAnimation *animation)

Añade la animación « animation » indicada a esta transición. La transición no asume la propiedad de la animación.

Véase también removeAnimation() y animations().

QList<QAbstractAnimation *> QAbstractTransition::animations() const

Devuelve la lista de animaciones asociadas a esta transición, o una lista vacía si no tiene ninguna animación.

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

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

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

[pure virtual protected] bool QAbstractTransition::eventTest(QEvent *event)

Esta función se invoca para determinar si el evento « event » dado debe provocar que se active esta transición. Reimplementa esta función y devuelve «true» si el evento debe activar la transición; en caso contrario, devuelve «false».

QStateMachine *QAbstractTransition::machine() const

Devuelve la máquina de estados de la que forma parte esta transición, o ` nullptr ` si la transición no forma parte de ninguna máquina de estados.

[pure virtual protected] void QAbstractTransition::onTransition(QEvent *event)

Esta función se invoca cuando se activa la transición. El objeto ` event ` proporcionado es el que ha provocado que se active la transición. Reimplementa esta función para realizar un procesamiento personalizado cuando se active la transición.

void QAbstractTransition::removeAnimation(QAbstractAnimation *animation)

Elimina el « animation » indicado de esta transición.

Véase también addAnimation().

void QAbstractTransition::setTargetState(QAbstractState *target)

Establece el estado « target » de esta transición.

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

Véase también targetState().

void QAbstractTransition::setTargetStates(const QList<QAbstractState *> &targets)

Establece los estados de destino de esta transición como el valor dado targets.

Nota: Funciónde configuración para la propiedad targetStates.

Véase también targetStates().

void QAbstractTransition::setTransitionType(QAbstractTransition::TransitionType type)

Establece el tipo de transición en « type ».

Nota: Funciónde asignación para la propiedad ` transitionType`.

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

QState *QAbstractTransition::sourceState() const

Devuelve el estado de origen de esta transición, o ` nullptr ` si esta transición no tiene estado de origen.

Nota: Funcióngetter para la propiedad sourceState.

QAbstractState *QAbstractTransition::targetState() const

Devuelve el estado de destino de esta transición, o ` nullptr ` si la transición no tiene destino.

Nota: Funcióngetter para la propiedad targetState.

Véase también setTargetState().

[private signal] void QAbstractTransition::targetStateChanged()

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

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

Véase también QAbstractTransition::targetState.

QList<QAbstractState *> QAbstractTransition::targetStates() const

Devuelve los estados de destino de esta transición, o una lista vacía si esta transición no tiene estados de destino.

Nota: Funcióngetter para la propiedad targetStates.

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

[private signal] void QAbstractTransition::targetStatesChanged()

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

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

Véase también QAbstractTransition::targetStates.

QAbstractTransition::TransitionType QAbstractTransition::transitionType() const

Devuelve el tipo de la transición.

Nota: Funcióngetter para la propiedad transitionType.

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

[private signal] void QAbstractTransition::triggered()

Esta señal se emite cuando se ha activado la transición (tras llamar a ` onTransition()`).

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

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