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

このプロパティは、アニメートするアイテムを保持します。


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