このページでは

PathAnimation QML Type

アイテムをパスに沿ってアニメーションさせます。詳細...

Import Statement: import QtQuick
Inherits:

Animation

プロパティ

詳細な説明

遷移で使用する場合、パスは開始点や終了点を指定せずに指定することができます。例えば:

PathAnimation {
    path: Path {
        //no startX, startY
        PathCurve { x: 100; y: 100}
        PathCurve {}    //last element is empty with no end point specified
    }
}

上記のケースでは、パスの開始点はアイテムの現在の位置となり、パスの終了点はターゲット状態におけるアイテムの目標位置となります。

関連項目 : Qt QuickおよびPathInterpolatorの「アニメーションとトランジション」を参照してください 。

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

anchorPoint : point

このプロパティは、アニメーションが適用されている項目のアンカーポイントを保持します。

デフォルトでは、ターゲットの左上隅(0,0 点)がパスにアンカーされ(またはパスに沿って移動します)。 anchorPoint プロパティを使用すると、アンカーとなる点を別の点に指定できます。たとえば、10×10 のアイテムに対して anchorPoint を 5,5 に指定すると、そのアイテムの中心がパスに沿って移動することになります。

duration : int

このプロパティには、アニメーションの継続時間がミリ秒単位で格納されます。

デフォルト値は 250 です。

easing group

easing.amplitude : real

easing.bezierCurve : list<real>

easing.overshoot : real

easing.period : real

easing.type : enumeration

アニメーションに使用されるイージングカーブ。

イージングカーブを指定するには、少なくともそのタイプを指定する必要があります。一部のカーブでは、振幅、周期、オーバーシュート、またはカスタムのbezierCurveデータを指定することもできます。デフォルトのイージングカーブはEasing.Linear です。

さまざまな種類のイージングカーブに関する詳細については、『PropertyAnimation::easing.type 』のドキュメントを参照してください。

endRotation : real

このプロパティは、ターゲットの終了時の回転角度を保持します。

PathAnimation に向きが指定されており、パスがアイテムを所望の回転角度で終了しない場合、endRotation プロパティを使用して終了時の回転角度を手動で指定することができます。

このプロパティは通常、orientationExitDuration と一緒に使用されます。orientationExitDuration を指定せずに endRotation を指定すると、スムーズな遷移ではなく、最終的な回転位置へジャンプしてしまう可能性があるためです。

orientation : enumeration

このプロパティは、パスに沿ってアニメーションされるアイテムの回転を制御します。

Fixed 以外の値が指定された場合、PathAnimation は、パスに沿って移動する際に、指定された向きになるようアイテムを回転させます。

  • PathAnimation.Fixed (デフォルト) -PathAnimation はアイテムの回転を制御しません。
  • PathAnimation.RightFirst - アイテムの右側がパスに沿って先頭を進みます。
  • PathAnimation.LeftFirst - アイテムの左側がパスに沿って先頭になります。
  • PathAnimation.BottomFirst - アイテムの下側がパスに沿って先頭になります。
  • PathAnimation.TopFirst - アイテムの上端がパスに沿って先頭を進みます。

orientationEntryDuration : real

このプロパティは、その向きへの遷移にかかる時間(ミリ秒単位)を保持します。

PathAnimation に方位が指定されており、アイテムの初期回転がその方位で指定された回転と一致しない場合、orientationEntryDurationを使用することで、アイテムの初期回転からパスの方位で指定された回転へと滑らかに遷移させることができます。

orientationExitDuration : real

このプロパティは、オリエンテーションからの遷移にかかる時間(ミリ秒単位)を保持します。

PathAnimation に対してオリエンテーションとendRotation が指定されている場合、orientationExitDurationを使用することで、パスオリエンテーションで指定された回転から、指定されたendRotation へとスムーズに移行させることができます。

path : Path

このプロパティには、アニメーションを実行するパスが格納されます。

パスの定義に関する詳細については、Path のドキュメントを参照してください。

target : Item

このプロパティには、アニメーションの対象となるアイテムが格納されます。

© 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.