RotationAnimation QML Type

Anime les changements de valeurs de rotation. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• direction : enumeration
• from : real
• to : real

Description détaillée

RotationAnimation est un site spécialisé PropertyAnimation qui permet de contrôler le sens de rotation au cours d'une animation.

Par défaut, la rotation s'effectue dans le sens de la variation numérique ; une rotation de 0 à 240 s'effectuera dans le sens des aiguilles d'une montre, tandis qu'une rotation de 240 à 0 s'effectuera dans le sens inverse des aiguilles d'une montre. La propriété direction peut être définie pour spécifier la direction dans laquelle la rotation doit se produire.

Dans l'exemple suivant, nous utilisons RotationAnimation pour animer la rotation entre les états par le chemin le plus court :

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" }
}

Remarquez que RotationAnimation n'a pas besoin de définir une valeur target. Par commodité, lorsqu'elle est utilisée dans une transition, RotationAnimation fait pivoter toutes les propriétés nommées "rotation" ou "angle". Vous pouvez passer outre en fournissant vos propres propriétés via properties ou property.

Notez également que Rectangle subira une rotation autour de sa valeur par défaut transformOrigin (qui est Item.Center). Pour utiliser une origine de transformation différente, définissez l'origine dans l'objet PropertyChanges et appliquez la modification au début de l'animation à l'aide de PropertyAction. Voir la documentation de PropertyAction pour plus de détails.

Comme tout autre type d'animation, une RotationAnimation peut être appliquée de différentes manières, notamment par des transitions, des comportements et des sources de valeurs de propriétés. La documentation Animation et transitions sur Qt Quick présente diverses méthodes de création d'animations.

Voir également Animation et transitions sur Qt Quick et Qt Quick Exemples - Animation.

Documentation sur les propriétés

direction : enumeration

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

Les valeurs possibles sont les suivantes :

from : real

Cette propriété contient la valeur de départ de l'animation.

Par exemple, l'animation suivante n'est pas appliquée tant que la valeur de angle n'a pas atteint 100 :

Item {
    states: [
        // ...
    ]

    transitions: Transition {
        RotationAnimation { properties: "angle"; from: 100; duration: 2000 }
    }
}

Si RotationAnimation est défini à l'intérieur de Transition ou Behavior, cette valeur prend par défaut la valeur définie dans l'état initial de Transition, ou la valeur actuelle de la propriété au moment où Behavior est déclenché.

Voir également Animation et transitions à l'adresse Qt Quick.

to : real

Cette propriété contient la valeur finale de l'animation....

Si l'adresse RotationAnimation est définie dans une adresse Transition ou Behavior, cette valeur prend par défaut la valeur définie dans l'état final de l'adresse Transition, ou la valeur du changement de propriété qui a déclenché l'adresse Behavior.

Voir également Animation et transitions à l'adresse Qt Quick.