このページでは

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 プロパティを使用すると、別のアンカーポイントを指定できます。例えば、10x10のアイテムに5,5のanchorPointを指定すると、アイテムの中心がパスに従うことになる。

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 を指定せずに endRotation を指定すると、スムーズな遷移ではなく、最終回転へのジャンプが発生する可能性があるため、このプロパティは通常orientationExitDuration と共に使用されます。

orientation : enumeration

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

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

  • PathAnimation.Fixed(デフォルト) -PathAnimation はアイテムの回転を制御しません。
  • PathAnimation.RightFirst - アイテムの右側がパスに沿って移動します。
  • PathAnimation.LeftFirst - アイテムの左側がパスに沿って進みます。
  • PathAnimation.BottomFirst - アイテムの下部がパスに沿って移動します。
  • PathAnimation.TopFirst - アイテムの上側がパスに沿ってリードされます。

orientationEntryDuration : real

このプロパティは、オリエンテーションへの遷移の持続時間(ミリ秒)を保持する。

オリエンテーションがPathAnimation に指定され、アイテムの開始回転がオリエンテーションで指定された回転と一致しない場合、OrientationEntryDuration を使用して、アイテムの開始回転からパスのオリエンテーションで指定された回転にスムーズに遷移することができます。

orientationExitDuration : real

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

オリエンテーションとendRotationPathAnimation に指定されている場合、 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.