En esta página

RotationAnimator QML Type

El tipo RotationAnimator anima la rotación de un objeto. Más...

Import Statement: import QtQuick
Inherits:

Animator

Propiedades

Descripción detallada

Animator son diferentes de los tipos de Animación normales. Cuando se utiliza un Animator, la animación se puede ejecutar en el hilo de renderizado y el valor de la propiedad saltará al final cuando la animación haya terminado.

El valor de Item::rotation se actualiza después de que la animación ha terminado.

El siguiente fragmento muestra cómo utilizar un RotationAnimator junto con un elemento Rectangle.

Rectangle {
    id: rotatingBox
    width: 50
    height: 50
    color: "lightsteelblue"
    RotationAnimator {
        target: rotatingBox;
        from: 0;
        to: 360;
        duration: 1000
        running: true
    }
}

También es posible utilizar la palabra clave on para vincular el RotationAnimator directamente a la propiedad rotation de una instancia de Item.

Rectangle {
    width: 50
    height: 50
    color: "lightsteelblue"
    RotationAnimator on rotation {
        from: 0;
        to: 360;
        duration: 1000
    }
}

Nota: Los tipos de Animador no tienen ningún beneficio cuando se utiliza un bucle de renderizado no hilado.

Nota: Se recomienda que las aplicaciones consideren diseños basados en principios multihilo y asíncronos, en lugar de confiar en Animators para mostrar contenido animado mientras se realiza un trabajo costoso y bloqueante en el hilo principal (GUI). En lugar de operaciones largas y bloqueantes, prefiera utilizar WorkerScript y asynchronous image loading en QML, e hilos de trabajo, algoritmos paralelos, Qt Concurrenty coroutines en C++, manteniendo así toda la aplicación y la interfaz de usuario receptiva todo el tiempo.

Véase también Item::transformOrigin y ScaleAnimator.

Documentación de propiedades

direction : enumeration

Esta propiedad contiene la dirección de la rotación.

Los valores posibles son:

ConstanteDescripción
RotationAnimator.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.
RotationAnimator.ClockwiseGira en el sentido de las agujas del reloj entre los dos valores
RotationAnimator.CounterclockwiseGira en sentido contrario a las agujas del reloj entre los dos valores
RotationAnimator.ShortestGire en la dirección que produzca la trayectoria de animación más corta. Una rotación de 10 a 350 girará 20 grados en sentido antihorario.

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