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 ` が構成 `c` に含まれている場合、`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()。