QStateMachine Class

QPushButton button;

QStateMachine machine;
QState *s1 = new QState();
s1->assignProperty(&button, "text", "Click me");

QFinalState *s2 = new QFinalState();
s1->addTransition(&button, &QPushButton::clicked, s2);

machine.addState(s1);
machine.addState(s2);
machine.setInitialState(s1);
machine.start();

Documentación de las funciones miembro

[explicit] QStateMachine::QStateMachine(QObject *parent = nullptr)

Construye una nueva máquina de estados con la dirección parent.

[virtual noexcept] QStateMachine::~QStateMachine()

Destruye esta máquina de estado.

void QStateMachine::addDefaultAnimation(QAbstractAnimation *animation)

Añade un animation por defecto que se tendrá en cuenta para cualquier transición.

void QStateMachine::addState(QAbstractState *state)

Añade el state dado a esta máquina de estados. El estado se convierte en un estado de nivel superior y la máquina de estados toma posesión del estado.

Si el estado ya está en una máquina diferente, primero será eliminado de su antigua máquina, y luego añadido a esta máquina.

Véase también removeState() y setInitialState().

bool QStateMachine::cancelDelayedEvent(int id)

Cancela el evento diferido identificado por el identificador id. El id debe ser un valor devuelto por una llamada a postDelayedEvent(). Devuelve true si el evento ha sido cancelado con éxito, en caso contrario devuelve false.

Nota: Esta función es thread-safe.

Véase también postDelayedEvent().

void QStateMachine::clearError()

Borra la cadena de error y el código de error de la máquina de estado.

QSet<QAbstractState *> QStateMachine::configuration() const

Devuelve el conjunto máximo consistente de estados (incluyendo estados paralelos y finales) en el que se encuentra actualmente esta máquina de estados. Si un estado s está en la configuración, siempre se da el caso de que el padre de s también está en c. Tenga en cuenta, sin embargo, que la propia máquina no es un miembro explícito de la configuración.

QList<QAbstractAnimation *> QStateMachine::defaultAnimations() const

Devuelve la lista de animaciones predeterminadas que se tendrán en cuenta para cualquier transición.

QStateMachine::Error QStateMachine::error() const

Devuelve el código de error del último error que se ha producido en la máquina de estados.

QString QStateMachine::errorString() const

Devuelve la cadena de error del último error ocurrido en la máquina de estado.

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

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

[override virtual] bool QStateMachine::eventFilter(QObject *watched, QEvent *event)

Reimplementa: QObject::eventFilter(QObject *watched, QEvent *event).

QState::RestorePolicy QStateMachine::globalRestorePolicy() const

Devuelve la política de restauración de la máquina de estado.

Véase también setGlobalRestorePolicy().

bool QStateMachine::isAnimated() const

Devuelve si las animaciones están habilitadas para esta máquina de estados.

[override virtual protected] void QStateMachine::onEntry(QEvent *event)

Reimplementa: QState::onEntry(QEvent *event).

Esta función llamará a start() para iniciar la máquina de estados.

[override virtual protected] void QStateMachine::onExit(QEvent *event)

Reimplementa: QState::onExit(QEvent *event).

Esta función llamará a stop() para detener la máquina de estados y posteriormente emitirá la señal stopped().

int QStateMachine::postDelayedEvent(QEvent *event, int delay)

Publica el evento event para ser procesado por esta máquina de estado, con el valor delay en milisegundos. Devuelve un identificador asociado con el evento retrasado, o -1 si el evento no pudo ser enviado.

Esta función devuelve inmediatamente. Cuando el retraso haya expirado, el evento se añadirá a la cola de eventos de la máquina de estado para su procesamiento. La máquina de estados toma posesión del evento y lo borra una vez que ha sido procesado.

Sólo se pueden enviar eventos cuando la máquina de estados está en ejecución.

Nota: Esta función es thread-safe.

Véase también cancelDelayedEvent() y postEvent().

int QStateMachine::postDelayedEvent(QEvent *event, std::chrono::milliseconds delay)

Publica el evento event para que sea procesado por esta máquina de estado, con el valor delay en milisegundos. Devuelve un identificador asociado con el evento retrasado, o -1 si el evento no pudo ser enviado.

Esta función devuelve inmediatamente. Cuando el retraso haya expirado, el evento se añadirá a la cola de eventos de la máquina de estado para su procesamiento. La máquina de estados toma posesión del evento y lo borra una vez que ha sido procesado.

Sólo se pueden enviar eventos cuando la máquina de estados está en ejecución.

Nota: Esta función es thread-safe.

Véase también cancelDelayedEvent() y postEvent().

void QStateMachine::postEvent(QEvent *event, QStateMachine::EventPriority priority = NormalPriority)

Publica el event dado del priority dado para ser procesado por esta máquina de estado.

Esta función retorna inmediatamente. El evento se añade a la cola de eventos de la máquina de estado. Los eventos se procesan en el orden de publicación. La máquina de estados toma posesión del evento y lo borra una vez que ha sido procesado.

Sólo se pueden enviar eventos cuando la máquina de estados está en ejecución o cuando se está iniciando.

Nota: Esta función es thread-safe.

Véase también postDelayedEvent().

void QStateMachine::removeDefaultAnimation(QAbstractAnimation *animation)

Elimina animation de la lista de animaciones por defecto.

void QStateMachine::removeState(QAbstractState *state)

Elimina el state dado de esta máquina de estados. La máquina de estados libera la propiedad del estado.

Véase también addState().

[signal] void QStateMachine::runningChanged(bool running)

Esta señal se emite cuando se cambia la propiedad en ejecución con running como argumento.

Véase también QStateMachine::running.

void QStateMachine::setAnimated(bool enabled)

Establece si las animaciones son enabled para esta máquina de estados.

Ver también isAnimated().

void QStateMachine::setGlobalRestorePolicy(QState::RestorePolicy restorePolicy)

Establece la política de restauración de la máquina de estados en restorePolicy. La política de restauración por defecto es QState::DontRestoreProperties.

Véase también globalRestorePolicy().

[slot] void QStateMachine::start()

Inicia esta máquina de estados. La máquina restablecerá su configuración y pasará al estado inicial. Cuando se entra en un estado final de nivel superior (QFinalState), la máquina emitirá la señal finished().

Ver también started(), finished(), stop(), initialState(), y setRunning().

[private signal] void QStateMachine::started()

Esta señal se emite cuando la máquina de estado ha entrado en su estado inicial (QStateMachine::initialState).

Ver también QStateMachine::finished() y QStateMachine::start().

[slot] void QStateMachine::stop()

Detiene esta máquina de estados. La máquina de estado dejará de procesar eventos y emitirá la señal stopped().

Véase también stopped(), start(), y setRunning().

[private signal] void QStateMachine::stopped()

Esta señal se emite cuando la máquina de estados se ha detenido.

Véase también QStateMachine::stop() y QStateMachine::finished().