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)

このステートマシンが処理するために、ミリ秒単位で指定されたdelay で、指定されたevent をポストする。遅延イベントに関連付けられた識別子を返すか、イベントがポストできなかった場合は-1を返す。

この関数はすぐに戻ります。遅延時間が経過すると、イベントは、処理のためにステートマシンのイベントキューに追加されます。ステートマシンはイベントの所有権を取得し、処理が完了すると削除します。

イベントをポストできるのは、ステートマシンが動作しているときだけです。

注:この関数はスレッドセーフです。

cancelDelayedEvent() およびpostEvent()も参照してください 。

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

これはオーバーロードされた関数である。

このステートマシンによる処理のために、ミリ秒単位で与えられたdelay で、与えられたevent をポストします。遅延イベントに関連付けられた識別子を返すか、イベントがポストできなかった場合は-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()も参照のこと 。