RotationAnimation QML Type

Anime les modifications des valeurs de rotation. En savoir plus…

• 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 une PropertyAnimation spécialisée qui permet de contrôler le sens de rotation pendant une animation.

Par défaut, la rotation s’effectue dans le sens de la variation numérique ; une rotation de 0 à 240 entraînera une rotation de 240 degrés dans le sens des aiguilles d’une montre, tandis qu’une rotation de 240 à 0 entraînera une rotation de 240 degrés dans le sens inverse des aiguilles d’une montre. La propriété « direction » peut être définie pour spécifier le sens dans lequel la rotation doit s’effectuer.

Dans l’exemple suivant, nous utilisons RotationAnimation pour animer la rotation entre les états en suivant 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" }
}

Notez que RotationAnimation n’a pas nécessité la définition d’une valeur pour target. Par souci de commodité, lorsqu’elle est utilisée dans une transition, RotationAnimation fait pivoter toutes les propriétés nommées « rotation » ou « angle ». Vous pouvez remplacer ce comportement en fournissant vos propres propriétés via properties ou property.

Notez également que l’ Rectangle sera pivotée autour de son transformOrigin par défaut (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. Consultez la documentation PropertyAction pour plus de détails.

Comme tout autre type d’animation, une RotationAnimation peut être appliquée de différentes manières, notamment via des transitions, des comportements et des sources de valeurs de propriété. La documentation « Animation et transitions » disponible à l’adresse Qt Quick présente diverses méthodes de création d’animations.

Voir également «Animation et transitions dans Qt Quick » et « Exemples d’Qt Quick: Animation ».

Documentation sur les propriétés

direction : enumeration

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

Les valeurs possibles sont :

from : real

Cette propriété contient la valeur initiale 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 l'RotationAnimation est définie au sein d'un Transition ou d'un Behavior, cette valeur prend par défaut la valeur définie dans l'état initial de l'Transition, ou la valeur actuelle de la propriété au moment où l'Behavior est déclenchée.

Voir également «Animation et transitions » dans Qt Quick.

to : real

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

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

Voir également «Animation et transitions » dans Qt Quick.