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 作为参数来更改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()。