Sur cette page

RotationAnimator QML Type

Le type RotationAnimator permet d'animer la rotation d'un élément. En savoir plus...

Import Statement: import QtQuick
Inherits:

Animator

Propriétés

Description détaillée

Animator Ces types diffèrent des types d’animation normaux. Lorsque vous utilisez un animateur, l’animation peut être exécutée dans le thread de rendu et la valeur de la propriété passe directement à la fin une fois l’animation terminée.

La valeur de ` Item::rotation ` est mise à jour une fois l'animation terminée.

L'extrait de code suivant montre comment utiliser un RotationAnimator avec un élément Rectangle.

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

Il est également possible d’utiliser le mot-clé ` on ` pour lier directement le `RotationAnimator` à la propriété ` rotation ` d’une instance `Item`.

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

Remarque : les typesd’animateurs ne présentent aucun avantage lorsqu’une boucle de rendu non multithread est utilisée.

Remarque : il est recommandé aux applications d’envisager des conceptions basées sur des principes multithread et asynchrones, plutôt que de s’appuyer sur des animateurs pour afficher du contenu animé tout en effectuant des tâches coûteuses et bloquantes sur le thread principal (GUI). Au lieu d’opérations longues et bloquantes, privilégiez l’utilisation de ` WorkerScript ` et ` asynchronous image loading ` en QML, ainsi que des threads de travail, des algorithmes parallèles Qt Concurrentet les coroutines en C++, afin de garantir à tout moment la réactivité de l’application et de l’interface utilisateur.

Voir également Item::transformOrigin et ScaleAnimator.

Documentation sur les propriétés

direction : enumeration

Cette propriété contient le sens de la rotation.

Les valeurs possibles sont :

ConstanteDescription
RotationAnimator.Numerical(par défaut) Effectue une rotation par interpolation linéaire entre les deux nombres. Une rotation de 10 à 350 correspond à une rotation de 340 degrés dans le sens des aiguilles d'une montre.
RotationAnimator.ClockwiseRotation dans le sens des aiguilles d'une montre entre les deux valeurs
RotationAnimator.CounterclockwiseRotation dans le sens inverse des aiguilles d'une montre entre les deux valeurs
RotationAnimator.ShortestEffectuer une rotation dans la direction qui produit le chemin d'animation le plus court. Une rotation de 10 à 350 correspondra à une rotation de 20 degrés dans le sens inverse des aiguilles d'une montre.

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