PathAttribute QML Type

Indique comment définir un attribut à une position donnée dans un chemin. En savoir plus…

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

Propriétés

• name : string
• value : real

Description détaillée

L'objet PathAttribute permet de spécifier des attributs composés d'un nom et d'une valeur pour différents points situés le long d'un tracé. Ces attributs sont exposés au délégué sous forme de propriétés associées. La valeur d'un attribut en un point donné du tracé est interpolée à partir des PathAttributes délimitant ce point.

L'exemple ci-dessous montre un chemin dont les éléments sont mis à l'échelle à 30 % avec une opacité de 50 % en haut du chemin, et à 100 % avec une opacité de 100 % en bas. Notez l'utilisation des propriétés associées ` PathView.iconScale` et ` PathView.iconOpacity` pour définir l'échelle et l'opacité du délégué.

import QtQuick

Rectangle {
    width: 240; height: 200

    Component {
        id: delegate
        Item {
            width: 80; height: 80
            scale: PathView.iconScale
            opacity: PathView.iconOpacity
            Column {
                Image { anchors.horizontalCenter: nameText.horizontalCenter; width: 64; height: 64; source: icon }
                Text { id: nameText; text: name; font.pointSize: 16 }
            }
        }
    }

    PathView {
        anchors.fill: parent
        model: ContactModel {}
        delegate: delegate
        path: Path {
            startX: 120; startY: 100
            PathAttribute { name: "iconScale"; value: 1.0 }
            PathAttribute { name: "iconOpacity"; value: 1.0 }
            PathQuad { x: 120; y: 25; controlX: 260; controlY: 75 }
            PathAttribute { name: "iconScale"; value: 0.3 }
            PathAttribute { name: "iconOpacity"; value: 0.5 }
            PathQuad { x: 120; y: 100; controlX: -20; controlY: 75 }
        }
    }
}

Voir également Path.

Documentation sur les propriétés

name : string

Cette propriété contient le nom de l'attribut à modifier.

Cet attribut sera accessible au délégué sous la forme PathView.<nom>

Notez qu’il est possible d’utiliser comme attribut le nom d’une propriété d’élément existante, telle que « opacity ». En effet, les attributs de chemin ajoutent une nouvelle propriété associée qui n’entre en aucun cas en conflit avec les propriétés existantes.

value : real

Cette propriété contient la valeur de l'attribut.

La valeur spécifiée peut être utilisée pour modifier l'apparence visuelle d'un élément le long du chemin. Par exemple, le chemin suivant spécifie un attribut nommé itemRotation, dont la valeur est 0 au début du chemin et 90 à la fin de celui-ci.

Path {
    startX: 0
    startY: 0
    PathAttribute { name: "itemRotation"; value: 0 }
    PathLine { x: 100; y: 100 }
    PathAttribute { name: "itemRotation"; value: 90 }
}

Dans notre délégué, nous pouvons alors lier la propriété de rotation à la propriété attachée PathView.itemRotation créée pour cet attribut.

Rectangle {
    width: 10; height: 10
    rotation: PathView.itemRotation
}

À mesure que chaque élément est positionné le long du chemin, il sera pivoté en conséquence : un élément situé au début du chemin ne sera pas pivoté, un élément situé à la fin du chemin sera pivoté de 90 degrés, et un élément situé à mi-chemin sera pivoté de 45 degrés.