PropertyChanges QML Type

Décrit les nouvelles liaisons ou valeurs de propriétés pour un état. Plus d'informations...

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

Propriétés

• explicit : bool
• restoreEntryValues : bool
• target : QtObject

Description détaillée

PropertyChanges est utilisé pour définir les valeurs des propriétés ou les liaisons dans un site State. Cela permet de modifier les valeurs des propriétés d'un élément lorsqu'il passe d'un état à un autre.

Pour créer un objet PropertyChanges, liez les propriétés de l'élément cible comme vous le feriez avec des propriétés locales. Vous pouvez ainsi définir les nouvelles valeurs des propriétés ou les nouvelles liaisons. Par exemple, lorsque la souris est enfoncée, l'objet

import QtQuick

Item {
    id: container
    width: 300; height: 300

    Rectangle {
        id: rect
        width: 100; height: 100
        color: "red"

        MouseArea {
           id: mouseArea
           anchors.fill: parent
        }

        states: State {
           name: "resized"; when: mouseArea.pressed
           PropertyChanges {
               rect {
                   color: "blue"
                   height: container.height
               }
           }
        }
    }
}

Lorsque l'on appuie sur la souris, le site Rectangle passe à l'état redimensionné. Dans cet état, l'objet PropertyChanges définit la couleur du rectangle en bleu et la valeur de height en container.height.

Notez que cela lie automatiquement rect.height à container.height dans l'état redimensionné. Si une liaison de propriété ne doit pas être établie et que la hauteur doit simplement être fixée à la valeur de container.height au moment du changement d'état, définissez la propriété explicit à true.

Un objet PropertyChanges peut également remplacer le gestionnaire de signal par défaut d'un objet pour mettre en œuvre un gestionnaire de signal spécifique au nouvel état :

PropertyChanges {
    myMouseArea.onClicked: doSomethingDifferent()
}

Réinitialisation des valeurs des propriétés

La valeur undefined peut être utilisée pour réinitialiser la valeur de la propriété d'un état. Dans l'exemple suivant, lorsque myText passe à l'état widerText, sa propriété width est réinitialisée, ce qui donne au texte sa largeur naturelle et permet d'afficher toute la chaîne sur une seule ligne.

Rectangle {
    width: 300; height: 200

    Text {
        id: myText
        width: 50
        wrapMode: Text.WordWrap
        text: "a text string that is longer than 50 pixels"

        states: State {
            name: "widerText"
            PropertyChanges { myText.width: undefined }
        }
    }

    MouseArea {
        anchors.fill: parent
        onClicked: myText.state = "widerText"
    }
}

Modifications immédiates des propriétés dans les transitions

Lorsque les transitions sont utilisées pour animer les changements d'état, elles font passer les propriétés de leurs valeurs dans l'état actuel à celles définies dans le nouvel état (telles que définies par les objets PropertyChanges). Cependant, il est parfois souhaitable de définir la valeur d'une propriété immédiatement au cours d'un Transition, sans animation ; dans ce cas, le type PropertyAction peut être utilisé pour forcer un changement de propriété immédiat.

Voir la documentation PropertyAction pour plus de détails.

Voir aussi l 'exemple des États, Qt Quick États, et Qt Qml.

Documentation sur les propriétés

explicit : bool

Si la valeur explicite est fixée à true, les liaisons seront interprétées comme des affectations. L'expression ne sera évaluée qu'une seule fois et aucune mise à jour n'aura lieu, même si les dépendances changent.

Dans l'exemple suivant, l'ajout d'explicite empêche myItem.width d'être lié à parent.width et lui attribue la valeur de parent.width au moment du changement d'état.

PropertyChanges {
    target: myItem
    explicit: true
    width: parent.width
}

Par défaut, explicit est faux.

restoreEntryValues : bool

Cette propriété indique si les valeurs précédentes doivent être rétablies lorsque l'on quitte l'état.

La valeur par défaut est true. En fixant cette valeur à false, on crée un état temporaire qui a des effets permanents sur les valeurs des propriétés.

target : QtObject

Cette propriété contient l'objet qui contient les propriétés à modifier.