このページでは

C

StateGroup QML Type

Item型以外の型に対して、状態のサポートを提供します。詳細...

Import Statement: import QtQuick
Since: Qt Quick Ultralite 2.10
Inherits:

QtObject

プロパティ

詳細な説明

Item を継承するビジュアル型には、statestatestransitions といったプロパティがすでに組み込まれていますが、非ビジュアル型にはこの機能がありません。StateGroup は、非ビジュアル型において状態と遷移をサポートする方法を提供します。

さらに、StateGroup を使用することで、状態をグループに構造化でき、異なる状態のセットを個別に制御できるようになります。これにより、Itemstates プロパティや他のStateGroup インスタンスとは別に、状態の変化を管理することが可能になります。

MyCustomObject {
    StateGroup {
        id: myStateGroup
        states: State {
            name: "state1"
            // ...
        }
        transitions: Transition {
            // ...
        }
    }

    onSomethingHappened: myStateGroup.state = "state1";
}

注: StateGroup 、ドキュメント内でトップレベルオブジェクトとして宣言された場合にのみ有効です。ツリー構造内の他の場所に配置された場合、qmltocppはエラーを報告します。

状態の使用」および「アニメーションと遷移も参照してください

プロパティのドキュメント

state : string

このプロパティには、ステートグループの現在のステート名が格納されます。

ステートグループがベース状態(つまり、明示的なステートが設定されていない状態)にある場合、このプロパティには空の文字列が格納されます。また、ステートグループの現在のステートを空の文字列に設定することで、ステートグループをベース状態に戻すこともできます。

状態の使用も参照してください

states : list<State>

このプロパティには、ステートグループによって定義された可能なステートのリストが格納されます。

StateGroup {
    states: [
        State {
            // State definition...
        },
        State {
            // ...
        }
        // Other states...
    ]
}

状態の使用も参照してください

transitions : list<Transition>

このプロパティには、ステートグループによって定義されたトランジションのリストが格納されます。

StateGroup {
    transitions: [
        Transition {
          // ...
        },
        Transition {
          // ...
        }
        // ...
    ]
}

アニメーションと遷移も参照してください

特定の Qt ライセンスの下で利用可能です。
詳細はこちらをご覧ください。