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 objeto « PropertyAnimation » especializado que permite controlar la dirección de rotación durante una animación.
Por defecto, gira en la dirección del cambio numérico; una rotación de 0 a 240 girará 240 grados en el sentido de las agujas del reloj, mientras que una rotación de 240 a 0 girará 240 grados en sentido contrario a las agujas del reloj. La propiedad « direction » se puede configurar para especificar la dirección en la que debe producirse la rotación.
En el siguiente ejemplo utilizamos RotationAnimation para animar la rotación entre estados por la ruta más corta:
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 RotationAnimation no ha necesitado establecer un valor de target. Para mayor comodidad, cuando se utiliza en una transición, RotationAnimation girará todas las propiedades denominadas «rotation» o «angle». Puedes anular este comportamiento proporcionando tus propias propiedades mediante properties o property.
Además, ten en cuenta que la propiedad « Rectangle » girará en torno a su « transformOrigin » predeterminado (que es « Item.Center »). Para utilizar un origen de transformación diferente, establece el origen en el objeto « PropertyChanges » y aplica el cambio al inicio de la animación mediante « PropertyAction ». Consulta la documentación de « PropertyAction » para obtener más detalles.
Al igual que cualquier otro tipo de animación, una RotationAnimation se puede aplicar de diversas formas, incluyendo transiciones, comportamientos y fuentes de valores de propiedad. La documentación «Animación y transiciones» en Qt Quick muestra diversos métodos para crear animaciones.
Véase también «Animación y transiciones en Qt Quick » y «Ejemplos deQt Quick: 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) Gira mediante interpolación lineal entre los dos números. Una rotación de 10 a 350 girará 340 grados en el sentido de las agujas del reloj. |
RotationAnimation.Clockwise | Girar en el sentido de las agujas del reloj entre los dos valores |
RotationAnimation.Counterclockwise | Girar en sentido antihorario entre los dos valores |
RotationAnimation.Shortest | Girar en la dirección que produzca la trayectoria de animación más corta. Una rotación desde 10 a 350 girará 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 la propiedad « RotationAnimation » se define dentro de un « Transition » o un « Behavior », este valor toma por defecto el valor definido en el estado inicial del « Transition », o el valor actual de la propiedad en el momento en que se activa el « 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 la propiedad « RotationAnimation » se define dentro de un « Transition » o un « Behavior », este valor se establece por defecto en el valor definido en el estado final de la « Transition », o en el valor del cambio de propiedad que desencadenó la « Behavior ».
Véase también «Animaciones 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.