RotationAnimation QML Type

回転値の変化をアニメーション化する。詳細...

Import Statement: import QtQuick
Inherits:

PropertyAnimation

プロパティ

詳細説明

RotationAnimation はPropertyAnimation に特化したもので、アニメーション中の回転方向を制御します。

デフォルトでは、数値の変化方向に回転します。0から240への回転は時計回りに240度回転し、240から0への回転は反時計回りに240度回転します。回転の方向を指定するには、direction プロパティを設定します。

次の例では、RotationAnimationを使って、最短経路で状態間の回転をアニメートしている:

import QtQuick

Item {
    width: 300; height: 300

    Rectangle {
        id: rect
        width: 150; height: 100; anchors.centerIn: parent
        color: "red"
        antialiasing: true

        states: State {
            name: "rotated"
            PropertyChanges { target: rect; rotation: 180 }
        }

        transitions: Transition {
            RotationAnimation { duration: 1000; direction: RotationAnimation.Counterclockwise }
        }
    }

    MouseArea { anchors.fill: parent; onClicked: rect.state = "rotated" }
}

RotationAnimationはtarget 。便利なことに、RotationAnimationをトランジションで使うと、"rotation "や "angle "という名前のプロパティがすべて回転する。これをオーバーライドするには、properties またはproperty を使って独自のプロパティを指定します。

また、Rectangle は、デフォルトのtransformOriginItem.Center )を中心に回転することに注意してください。異なるトランスフォームの原点を使用するには、PropertyChanges オブジェクトで原点を設定し、PropertyAction を使用してアニメーションの開始時に変更を適用します。詳細はPropertyAction のドキュメントを参照してください。

他のアニメーションタイプと同様に、RotationAnimationは、トランジション、ビヘイビア、プロパティ値のソースなど、さまざまな方法で適用することができます。Animation and Transitions in Qt Quickドキュメントでは、アニメーションを作成するための様々な方法を紹介しています。

Animation and Transitions in Qt QuickおよびQt Quick Examples - Animationも参照してください

プロパティの説明

direction : enumeration

このプロパティは、回転の方向を保持します。

指定できる値は以下の通りです:

定数説明
RotationAnimation.Numerical(デフォルト) 2つの数値の間を線形補間して回転する。10 から350 への回転は、時計回りに 340 度回転する。
RotationAnimation.Clockwise2つの値の間を時計回りに回転
RotationAnimation.Counterclockwise2つの値の間を反時計回りに回転
RotationAnimation.Shortest最短のアニメーションパスを生成する方向に回転する。10 から350 への回転は、20 度を反時計回りに回転する。

from : real

このプロパティは、アニメーションの開始値を保持します。

例えば、angle の値が 100 に達するまで、次のアニメーションは適用されません:

Item {
    states: [
        // ...
    ]

    transitions: Transition {
        RotationAnimation { properties: "angle"; from: 100; duration: 2000 }
    }
}

RotationAnimationTransition またはBehavior 内で定義されている場合、この値のデフォルトはTransition の開始状態で定義された値、またはBehavior がトリガーされた時点でのプロパティの現在値になります。

Qt Quick の「アニメーションとトランジション」も参照してください


to : real

このプロパティは、アニメーションの終了値を保持します。

RotationAnimationTransition またはBehavior 内で定義されている場合、この値のデフォルトはTransition の終了状態で定義されている値、またはBehavior をトリガーしたプロパティ変更の値です。

Qt Quick の「アニメーションとトランジション」も参照してください


本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。