En esta página

RotationAnimator QML Type

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

Import Statement: import QtQuick
Inherits:

Animator

Propiedades

Descripción detallada

Animator Los tipos de animación son diferentes de los tipos de animación normales. Al utilizar 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 finalizado.

El valor de « Item::rotation » se actualiza una vez finalizada la animación.

El siguiente fragmento de código 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 tiposde animador no aportan ninguna ventaja cuando se utiliza un bucle de renderizado no multihilo.

Nota: Se recomienda que las aplicaciones adopten diseños basados en principios multihilo y asíncronos, en lugar de depender de los animadores para mostrar contenido animado mientras se realizan tareas costosas y bloqueantes en el hilo principal (GUI). En lugar de operaciones largas y bloqueantes, es preferible utilizar WorkerScript y asynchronous image loading en QML, así como hilos de trabajo, algoritmos paralelos Qt Concurrenty las corrutinas en C++, manteniendo así la capacidad de respuesta de toda la aplicación y la interfaz de usuario en todo momento.

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) 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.
RotationAnimator.ClockwiseGirar en sentido horario entre los dos valores
RotationAnimator.CounterclockwiseGirar en sentido antihorario entre los dos valores
RotationAnimator.ShortestGirar en la dirección que produzca la trayectoria de animación más corta. Una rotación de 10 a 350 supondrá un giro de 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.