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: |
Tipos públicos
| enum | TransitionType { ExternalTransition, InternalTransition } |
Propiedades
- sourceState : QState*
- targetState : QAbstractState*
- targetStates : QList<QAbstractState*>
- transitionType : TransitionType
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
| void | targetStateChanged() |
| void | targetStatesChanged() |
| void | triggered() |
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.
| Constante | Valor | Descripción |
|---|---|---|
QAbstractTransition::ExternalTransition | 0 | Cualquier 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::InternalTransition | 1 | Si 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.