QHistoryState Class
La clase QHistoryState permite volver a un subestado que haya estado activo anteriormente. Más información...
| Encabezado: | #include <QHistoryState> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS StateMachine) target_link_libraries(mytarget PRIVATE Qt6::StateMachine) |
| qmake: | QT += statemachine |
| Heredan: | QAbstractState |
Tipos públicos
| enum | HistoryType { ShallowHistory, DeepHistory } |
Propiedades
- defaultState : QAbstractState*
- defaultTransition : QAbstractTransition*
- historyType : HistoryType
Funciones públicas
| QHistoryState(QState *parent = nullptr) | |
| QHistoryState(QHistoryState::HistoryType type, QState *parent = nullptr) | |
| virtual | ~QHistoryState() |
| QBindable<QAbstractTransition *> | bindableDefaultTransition() |
| QBindable<QHistoryState::HistoryType> | bindableHistoryType() |
| QAbstractState * | defaultState() const |
| QAbstractTransition * | defaultTransition() const |
| QHistoryState::HistoryType | historyType() const |
| void | setDefaultState(QAbstractState *state) |
| void | setDefaultTransition(QAbstractTransition *transition) |
| void | setHistoryType(QHistoryState::HistoryType type) |
Señales
| void | defaultStateChanged() |
| void | defaultTransitionChanged() |
| void | historyTypeChanged() |
Funciones protegidas reimplementadas
| virtual bool | event(QEvent *e) override |
| virtual void | onEntry(QEvent *event) override |
| virtual void | onExit(QEvent *event) override |
Descripción detallada
Un estado de historial es un pseudoestado que representa el estado hijo en el que se encontraba el estado padre la última vez que se salió de este. Una transición cuyo destino sea un estado de historial es, de hecho, una transición a uno o varios estados hijos del estado padre. QHistoryState forma parte del marco de trabajo «Qt State Machine ».
Utiliza la función setDefaultState() para establecer el estado al que se debe acceder si nunca se ha accedido al estado padre. Ejemplo:
QStateMachine machine;
QState *s1 = new QState();
QState *s11 = new QState(s1);
QState *s12 = new QState(s1);
QHistoryState *s1h = new QHistoryState(s1);
s1h->setDefaultState(s11);
machine.addState(s1);
QState *s2 = new QState();
machine.addState(s2);
QPushButton *button = new QPushButton();
// Clicking the button will cause the state machine to enter the child state
// that s1 was in the last time s1 was exited, or the history state's default
// state if s1 has never been entered.
s1->addTransition(button, SIGNAL(clicked()), s1h);Si hay que entrar en más de un estado por defecto, o si hay que realizar alguna acción en la transición hacia el estado o estados por defecto, se debe establecer en su lugar la propiedad defaultTransition. Ten en cuenta que el método eventTest() de esa transición nunca se llamará: la selección y ejecución de la transición se realizan automáticamente al entrar en el estado del historial.
Por defecto, un estado del historial es superficial, lo que significa que no recordará los estados anidados. Esto se puede configurar mediante la propiedad historyType.
Documentación sobre los tipos de miembros
enum QHistoryState::HistoryType
Esta enumeración especifica el tipo de historial que registra un objeto ` QHistoryState `.
| Constante | Valor | Descripción |
|---|---|---|
QHistoryState::ShallowHistory | 0 | Solo se registran los estados hijos inmediatos del estado padre. En este caso, una transición que tenga como destino el estado del historial terminará en el estado hijo inmediato en el que se encontraba el estado padre la última vez que se salió de él. Este es el valor por defecto. |
QHistoryState::DeepHistory | 1 | Se registran los estados anidados. En este caso, una transición que tenga como destino el estado del historial terminará en el estado descendiente más profundamente anidado en el que se encontraba el estado padre la última vez que se salió de él. |
Documentación de la propiedad
defaultState : QAbstractState*
Esta propiedad contiene el estado predeterminado de este estado del historial
Funciones de acceso:
| QAbstractState * | defaultState() const |
| void | setDefaultState(QAbstractState *state) |
Señal de notificación:
| void | defaultStateChanged() | [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] defaultTransition : QAbstractTransition*
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Esta propiedad contiene la transición predeterminada de este estado del historial
Funciones de acceso:
| QAbstractTransition * | defaultTransition() const |
| void | setDefaultTransition(QAbstractTransition *transition) |
Señal de notificación:
| void | defaultTransitionChanged() | [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] historyType : HistoryType
Nota: Esta propiedad admite enlaces de tipo « QProperty ».
Esta propiedad contiene el tipo de historial que registra este estado de historial
El valor predeterminado de esta propiedad es « QHistoryState::ShallowHistory ».
Funciones de acceso:
| QHistoryState::HistoryType | historyType() const |
| void | setHistoryType(QHistoryState::HistoryType type) |
Señal de notificador:
| void | historyTypeChanged() | [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
QHistoryState::QHistoryState(QState *parent = nullptr)
Crea un nuevo estado de historial superficial a partir del estado « parent » proporcionado.
QHistoryState::QHistoryState(QHistoryState::HistoryType type, QState *parent = nullptr)
Crea un nuevo estado de historial del type especificado, con el estado parent indicado.
[virtual noexcept] QHistoryState::~QHistoryState()
Elimina este estado del historial.
QAbstractState *QHistoryState::defaultState() const
Devuelve el estado predeterminado de este estado del historial. El estado predeterminado indica el estado al que se debe realizar la transición si nunca antes se ha accedido al estado padre.
Nota: Funcióngetter para la propiedad defaultState.
Véase también ` setDefaultState()`.
[private signal] void QHistoryState::defaultStateChanged()
Esta señal se emite cuando se modifica la propiedad ` defaultState `.
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 ` defaultState`.
Véase también QHistoryState::defaultState.
QAbstractTransition *QHistoryState::defaultTransition() const
Devuelve la transición predeterminada de este estado del historial. La transición predeterminada se aplica cuando nunca antes se ha accedido a ese estado del historial. Por lo tanto, los estados de destino de la transición predeterminada conforman el estado predeterminado.
Nota: Funcióngetter para la propiedad defaultTransition.
Véase también setDefaultTransition().
[private signal] void QHistoryState::defaultTransitionChanged()
Esta señal se emite cuando se modifica la propiedad « defaultTransition ».
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 ` defaultTransition`.
Véase también QHistoryState::defaultTransition.
[override virtual protected] bool QHistoryState::event(QEvent *e)
Reimplementa: QAbstractState::event(QEvent *e).
QHistoryState::HistoryType QHistoryState::historyType() const
Devuelve el tipo de historial que registra este estado del historial.
Nota: Funcióngetter para la propiedad historyType.
Véase también setHistoryType().
[private signal] void QHistoryState::historyTypeChanged()
Esta señal se emite cuando se modifica la propiedad « historyType ».
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 ` historyType`.
Véase también QHistoryState::historyType.
[override virtual protected] void QHistoryState::onEntry(QEvent *event)
Reimplementa: ` QAbstractState::onEntry(QEvent *event)`.
[override virtual protected] void QHistoryState::onExit(QEvent *event)
Reimplementa: ` QAbstractState::onExit(QEvent *event)`.
void QHistoryState::setDefaultState(QAbstractState *state)
Establece el estado por defecto de este estado del historial en el estado state especificado. state debe ser un estado hermano de este estado del historial.
Ten en cuenta que esta función no establece state como estado inicial de su padre.
Nota: Funciónde asignación para la propiedad defaultState.
Véase también defaultState().
void QHistoryState::setDefaultTransition(QAbstractTransition *transition)
Establece la transición predeterminada de este estado del historial como la indicada en transition. Esto configurará el estado de origen de transition como el estado del historial.
Ten en cuenta que el método `eventTest` del ` transition ` nunca se llamará.
Nota: Funciónsetter para la propiedad defaultTransition.
Véase también defaultTransition().
void QHistoryState::setHistoryType(QHistoryState::HistoryType type)
Establece el valor de la propiedad « type » del historial que registra este estado del historial.
Nota: Funciónde asignación para la propiedad historyType.
Véase también historyType().
© 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.