Path QML Type

Définit un chemin à utiliser par PathView et Shape. Plus...

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

Propriétés

• asynchronous : bool (since 6.9)
• closed : bool
• pathElements : list<PathElement>
• scale : size (since QtQuick 2.14)
• simplify : bool (since 6.6)
• startX : real
• startY : real

Méthodes

• point pointAtPercent(real t) (since QtQuick 2.14)

Description détaillée

Un chemin est composé d'un ou plusieurs segments de chemin - PathLine, PathPolyline, PathQuad, PathCubic, PathArc, PathAngleArc, PathCurve, PathSvg.

L'espacement des éléments le long du chemin peut être ajusté à l'aide d'un objet PathPercent.

PathAttribute permet de définir des attributs nommés avec des valeurs le long du chemin.

Le chemin et les autres types permettant de spécifier les éléments du chemin sont partagés entre PathView et Shape. Le tableau suivant donne un aperçu de l'applicabilité des différents éléments de chemin :

Voir aussi PathView, Shape, PathAttribute, PathPercent, PathLine, PathPolyline, PathMove, PathQuad, PathCubic, PathArc, PathAngleArc, PathCurve, PathSvg, et PathRectangle.

Documentation sur les biens

asynchronous : bool [since 6.9]

Lorsqu'il vaut true, le chemin sera traité de manière asynchrone. Il s'agit d'une optimisation permettant de ne traiter le chemin qu'une seule fois, après toutes les méthodes susceptibles de l'affecter. Cela signifie que lorsque la valeur est true, le chemin mis à jour n'est pas disponible immédiatement après, par exemple, l'ajustement de startX, scale ou l'ajout d'un élément, mais seulement après que la boucle d'événement Qt a été traitée. La valeur par défaut est false.

Cette propriété a été introduite dans Qt 6.9.

closed : bool [read-only]

Cette propriété indique si le début et la fin du chemin sont identiques.

pathElements : list<PathElement> [default read-only]

Cette propriété contient les objets composant le chemin.

Un chemin peut contenir les objets suivants

• PathLine - une ligne droite jusqu'à une position donnée.
• PathPolyline - une polyligne spécifiée sous la forme d'une liste de coordonnées.
• PathMultiline - une liste de polylignes spécifiée comme une liste de listes de coordonnées.
• PathQuad - une courbe de Bézier quadratique vers une position donnée avec un point de contrôle.
• PathCubic - une courbe de Bézier cubique à une position donnée avec deux points de contrôle.
• PathArc - un arc à une position donnée avec un rayon.
• PathAngleArc - un arc spécifié par le point central, les rayons et les angles.
• PathSvg - un chemin spécifié en tant que chaîne de données de chemin SVG.
• PathRectangle - un rectangle avec une position et une taille données
• PathCurve - un point sur une courbe de Catmull-Rom.
• PathAttribute - un attribut à une position donnée dans le chemin.
• PathPercent - un moyen de répartir les éléments sur différents segments du chemin.

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

scale : size [since QtQuick 2.14]

Cette propriété contient le facteur d'échelle du chemin. La largeur et la hauteur de scale peuvent être différentes pour obtenir une mise à l'échelle anisotropique.

Cette propriété a été introduite dans QtQuick 2.14.

simplify : bool [since 6.6]

Lorsqu'il vaut true, le chemin sera simplifié. Cela implique la fusion de tous les sous-chemins qui se croisent, créant ainsi un chemin où il n'y a pas d'auto-intersections. Les lignes parallèles consécutives seront également fusionnées. La trajectoire simplifiée est destinée à être utilisée avec ShapePath.OddEvenFill. Les courbes de Bézier peuvent être aplaties en segments de ligne en raison de l'instabilité numérique des intersections de courbes de Bézier.

Cette propriété a été introduite dans Qt 6.6.

Ces propriétés contiennent la position de départ du chemin.

Documentation de la méthode

[since QtQuick 2.14] point pointAtPercent(real t)

Renvoie le point au pourcentage t du chemin actuel. L'argument t doit être compris entre 0 et 1.

Cette méthode a été introduite dans QtQuick 2.14.

Voir aussi QPainterPath::pointAtPercent().