C

Timeline QML Type

Import Statement:	`import QtQuick.Timeline`
Since:	Qt Quick Ultralite 1.3
Inherits:	QtObject

継承されたメンバーを含む全メンバーの一覧

プロパティ

animations : list
currentFrame : real
enabled : bool
endFrame : real
startFrame : real

詳細な説明

startFrame とendFrame の間のフレームのタイムラインを指定します。そのキーフレームは、currentFrame が変化した際に、影響を受けるプロパティがどのように変化するかを記述します。

Timeline {
    startFrame: 0
    currentFrame: 50
    endFrame: 100
}

タイムラインにキーフレームを追加するには、KeyframeGroup タイプの子要素を追加します。各KeyframeGroup には、特定のプロパティがどのように変化するかを記述するKeyframes が含まれます。

Timeline {
    // ...

    KeyframeGroup {
        target: myitem
        property: "x"
        Keyframe {
            frame: 20
            value: 50
        }
    }
}

タイムラインは、アニメーションに使用することも、アイテムの挙動を制御するために使用することもできます。たとえば、currentFrame にバインドすることで、現在のフレームが進行状況を反映するプログレスバーを作成することが可能です。あるいは、animations プロパティ内のTimelineAnimations を使用して、currentFrame を直接アニメーションさせることもできます。

次の例では、タイムラインを使用して、Rectangle のwidth およびheight プロパティをアニメーション化しています：

Rectangle {
    color: "white"
    Rectangle {
        id: rect
        color: "red"
        width: 100
        height: 100
    }

    Timeline {
        startFrame: 0
        endFrame: 100

        KeyframeGroup {
            target: rect
            property: "width"
            Keyframe {
                frame: 50
                value: 150
            }
            Keyframe {
                frame: 100
                value: 25
                easing.type: Easing.InOutQuad
            }
        }

        KeyframeGroup {
            target: rect
            property: "height"
            Keyframe {
                frame: 0
                value: 50
            }
            Keyframe {
                frame: 70
                value: 150
            }
        }

        animations: [
            TimelineAnimation {
                running: true
                pingPong: true
                // ???
            }
        ]
    }
}

注： Qt Quick のUltraliteタイムラインでは、keyframes プロパティはサポートされていません。

「 KeyframeGroup 」および「TimelineAnimation 」も参照してください 。

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

animations : list

タイムラインに添付されたアニメーションの一覧です。アニメーションはTimelineAnimation 型である必要があり、currentFrame プロパティに自動的に適用されます。

currentFrame : real

タイムライン上の現在のキーフレーム。現在のキーフレームにはアニメーションを設定したり、バインディングを割り当てたりすることができます。バインディングを使用することで、コンポーネントの挙動を制御することができます。

enabled : bool

タイムラインが有効かどうか。

タイムラインが無効になっている場合、タイムラインの影響を受けるすべてのプロパティは通常の値になります。タイムラインが有効になっている場合、プロパティの値は現在のフレームとキーフレームによって決定されます。

1つのプロパティに対して、一度に有効にできるタイムラインは1つだけです。

endFrame : real

タイムラインの終わり。この値は効果を持ちません。

startFrame : real

タイムラインの開始時点。各KeyframeGroup には、startFrameに暗黙のKeyframe が設定されており、その値はタイムラインが最初に有効化された時点でのtargetプロパティの値となります。

特定の Qt ライセンスの下で利用可能です。
詳細はこちら。