RotationAnimation QML Type
Anima los cambios en los valores de rotación. Más...
| Import Statement: | import QtQuick |
| Inherits: |
Propiedades
Descripción detallada
RotationAnimation es un PropertyAnimation especializado que da control sobre la dirección de rotación durante una animación.
Por defecto, rota en la dirección del cambio numérico; una rotación de 0 a 240 rotará 240 grados en el sentido de las agujas del reloj, mientras que una rotación de 240 a 0 rotará 240 grados en sentido contrario a las agujas del reloj. La propiedad direction puede establecerse para especificar la dirección en la que debe producirse la rotación.
En el siguiente ejemplo usamos RotationAnimation para animar la rotación entre estados a través del camino más corto:
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" } }
Observa que la RotationAnimation no necesita establecer un valor target. Por conveniencia, cuando se usa en una transición, RotationAnimation rotará todas las propiedades llamadas "rotation" o "angle". Puedes anular esto proporcionando tus propias propiedades a través de properties o property.
Además, tenga en cuenta que Rectangle girará alrededor de su origen por defecto transformOrigin (que es Item.Center). Para utilizar un origen de transformación diferente, establezca el origen en el objeto PropertyChanges y aplique el cambio al inicio de la animación utilizando PropertyAction. Consulte la documentación de PropertyAction para más detalles.
Como cualquier otro tipo de animación, una RotationAnimation puede ser aplicada de varias maneras, incluyendo transiciones, comportamientos y fuentes de valores de propiedades. La documentación Animación y Transiciones en Qt Quick muestra una variedad de métodos para crear animaciones.
Véase también Animación y Transiciones en Qt Quick y Qt Quick Ejemplos - Animación.
Documentación de Propiedades
direction : enumeration
Esta propiedad contiene la dirección de la rotación.
Los valores posibles son:
| Constante | Descripción |
|---|---|
RotationAnimation.Numerical | (por defecto) Rota interpolando linealmente entre los dos números. Una rotación de 10 a 350 rotará 340 grados en el sentido de las agujas del reloj. |
RotationAnimation.Clockwise | Gira en el sentido de las agujas del reloj entre los dos valores |
RotationAnimation.Counterclockwise | Gira en sentido contrario a las agujas del reloj entre los dos valores |
RotationAnimation.Shortest | Gire en la dirección que produzca la trayectoria de animación más corta. Una rotación de 10 a 350 rotará 20 grados en sentido antihorario. |
from : real
Esta propiedad contiene el valor inicial de la animación.
Por ejemplo, la siguiente animación no se aplica hasta que el valor de angle haya alcanzado 100:
Item { states: [ // ... ] transitions: Transition { RotationAnimation { properties: "angle"; from: 100; duration: 2000 } } }
Si RotationAnimation se define dentro de Transition o Behavior, este valor es por defecto el valor definido en el estado inicial de Transition, o el valor actual de la propiedad en el momento en que se activa Behavior.
Véase también Animación y transiciones en Qt Quick.
to : real
Esta propiedad contiene el valor final de la animación..
Si RotationAnimation se define dentro de Transition o Behavior, este valor es por defecto el valor definido en el estado final de Transition, o el valor del cambio de propiedad que desencadenó Behavior.
Véase también Animación y transiciones en Qt Quick.
© 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.