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();

成员函数文档

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

用给定的parent 构建一个新的状态机。

[virtual noexcept] QStateMachine::~QStateMachine()

销毁该状态机。

void QStateMachine::addDefaultAnimation(QAbstractAnimation *animation)

添加一个默认的animation ，任何过渡都要考虑该默认值。

void QStateMachine::addState(QAbstractState *state)

将给定的state 添加到此状态机。该状态将成为顶层状态，状态机将拥有该状态的所有权。

如果该状态已存在于其他机器中，则会先从旧机器中删除，然后再添加到本机器中。

另请参见 removeState() 和setInitialState()。

bool QStateMachine::cancelDelayedEvent(int id)

取消由给定的id 标识的延迟事件。id 应该是调用postDelayedEvent() 返回的值。如果事件成功取消，则返回true ，否则返回false 。

注意：此函数是线程安全的。

另请参阅 postDelayedEvent() 。

void QStateMachine::clearError()

清除状态机的错误字符串和错误代码。

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

返回此状态机当前所处的最大一致状态集（包括并行状态和最终状态）。如果配置中有一个状态s ，则s 的父状态也总是在 c 中。但请注意，状态机本身不是配置的显式成员。

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

返回任何过渡都会考虑的默认动画列表。

QStateMachine::Error QStateMachine::error() const

返回状态机中发生的最后一次错误的错误代码。

QString QStateMachine::errorString() const

返回状态机中发生的最后一次错误的错误字符串。

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

重实现：QState::event(QEvent *e)。

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

重实现：QObject::eventFilter(QObject *watched, QEvent *event).

QState::RestorePolicy QStateMachine::globalRestorePolicy() const

返回状态机的还原策略。

另请参阅 setGlobalRestorePolicy().

bool QStateMachine::isAnimated() const

返回此状态机是否启用了动画。

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

重实现：QState::onEntry(QEvent *event)。

该函数将调用start() 来启动状态机。

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

重实现：QState::onExit(QEvent *event)。

该函数将调用stop() 停止状态机，随后发出stopped() 信号。

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

将给定的event 发送给本状态机处理，给定的delay 的毫秒数。返回与延迟事件相关的标识符，如果事件无法发布，则返回-1。

此函数立即返回。延迟结束后，事件将被添加到状态机的事件队列中进行处理。状态机拥有事件的所有权，并在处理完毕后将其删除。

只有在状态机运行时，才能发布事件。

注意：该函数是线程安全的。

另请参阅 cancelDelayedEvent() 和postEvent()。

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

这是一个重载函数。

发布给定的event 供本状态机处理，发布时间为delay （毫秒）。返回与延迟事件相关的标识符，如果事件无法发布，则返回-1。

此函数立即返回。延迟结束后，事件将被添加到状态机的事件队列中进行处理。状态机拥有事件的所有权，并在处理完毕后将其删除。

只有在状态机运行时，才能发布事件。

注意：该函数是线程安全的。

另请参阅 cancelDelayedEvent() 和postEvent()。

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

发布给定priority 的给定event ，供该状态机处理。

此函数立即返回。事件将被添加到状态机的事件队列中。事件将按照发布的顺序进行处理。状态机拥有事件的所有权，并在处理完毕后将其删除。

只有在状态机运行或启动时，才能发布事件。

注意：该函数是线程安全的。

另请参见 postDelayedEvent().

void QStateMachine::removeDefaultAnimation(QAbstractAnimation *animation)

从默认动画列表中删除animation 。

void QStateMachine::removeState(QAbstractState *state)

从状态机中删除给定的state 。状态机将释放对该状态的所有权。

另请参见 addState().

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

当以running 作为参数的运行属性发生变化时，会发出该信号。

另请参阅 QStateMachine::running 。

void QStateMachine::setAnimated(bool enabled)

设置此状态机的动画是否为enabled 。

另请参阅 isAnimated().

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

将状态机的还原策略设置为restorePolicy 。默认还原策略为QState::DontRestoreProperties 。

另请参阅 globalRestorePolicy() 。

[slot] void QStateMachine::start()

启动该状态机。机器将重置配置并过渡到初始状态。当进入最终顶层状态（QFinalState ）时，机器将发出finished() 信号。

另请参阅 started(),finished(),stop(),initialState() 和setRunning().

[private signal] void QStateMachine::started()

当状态机进入初始状态（QStateMachine::initialState）时发出该信号。

另请参阅 QStateMachine::finished() 和QStateMachine::start()。

[slot] void QStateMachine::stop()

停止该状态机。状态机将停止处理事件，然后发出stopped() 信号。

另请参见 stopped()、start() 和setRunning()。

[private signal] void QStateMachine::stopped()

状态机停止时发出该信号。

另请参见 QStateMachine::stop() 和QStateMachine::finished()。