PathAnimation QML Type
항목을 경로를 따라 움직이게 합니다. 더 보기...
| Import Statement: | import QtQuick |
| Inherits: |
속성
- anchorPoint : point
- duration : int
- easing
- easing.amplitude : real
- easing.bezierCurve : list<real>
- easing.overshoot : real
- easing.period : real
- easing.type : enumeration
- endRotation : real
- orientation : enumeration
- orientationEntryDuration : real
- orientationExitDuration : real
- path : Path
- target : Item
상세 설명
전환에 사용될 때, 경로는 시작점이나 끝점 없이 지정할 수 있습니다. 예를 들어:
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 크기의 항목에 대해 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 에 방향(orientation)과 경로 방향( 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.