En esta página

RotationAnimation QML Type

Anima los cambios en los valores de rotación. Más...

Import Statement: import QtQuick
Inherits:

PropertyAnimation

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:

ConstanteDescripció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.ClockwiseGirar en el sentido de las agujas del reloj entre los dos valores
RotationAnimation.CounterclockwiseGirar en sentido antihorario entre los dos valores
RotationAnimation.ShortestGirar 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.