State QML Type
StateMachine 用の汎用ステートを用意します。詳細...
| Import Statement: | import QtQml.StateMachine 6.12 |
| Inherits: | |
| Inherited By: |
プロパティ
- childMode : enumeration
- errorState : QAbstractState
- initialState : QAbstractState
信号
- finished()
詳細な説明
状態オブジェクトは、子状態を持つことができるほか、他の状態への遷移を持つこともできます。状態は、Qt State Machine のQML APIの一部です
子状態を持つ状態
childMode プロパティは、子状態の扱いを決定します。並列でない状態グループの場合、初期状態を設定するにはinitialState プロパティを使用する必要があります。子状態は相互に排他的な状態であり、親状態が遷移のターゲットとなった際に、ステートマシンはどの子状態に入るべきかを把握しておく必要があります。
状態は、最終子状態(FinalState )に入ったときに、State::finished() シグナルをエミットします。
errorState は、状態のエラー状態を設定します。エラー状態とは、その状態への移行を試みた際にエラーが検出された場合(例:初期状態が設定されていない場合など)、ステートマシンが遷移する状態のことです。
使用例
import QtQuick
import QtQml.StateMachine as DSM
Rectangle {
DSM.StateMachine {
id: stateMachine
initialState: state
running: true
DSM.State {
id: state
}
}
}StateMachine およびFinalStateも参照してください 。
プロパティのドキュメント
childMode : enumeration
この状態のチャイルドモード
このプロパティのデフォルト値は `QState.ExclusiveStates` です。
この列挙型は、状態の子状態がどのように扱われるかを指定します:
- QState.ExclusiveStates 子状態は互いに排他的であり、initialState プロパティを設定して初期状態を指定する必要があります。
- QState.ParallelStates 子状態は並列です。親状態に入ると、そのすべての子状態に並列で移行します。
errorState : QAbstractState
この状態のエラー状態。
initialState : QAbstractState
この状態の初期状態(その子状態の1つ)。
シグナルのドキュメント
finished()
このシグナルは、この状態の最終子状態に入ったときに発せられます。
注: 対応するハンドラは onFinished です。
関連項目: QAbstractState::active 、QAbstractState::entered 、およびQAbstractState::exited 。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.