Path QML Type

Définit un chemin d'accès utilisé par PathView et Shape. En savoir 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 Cela permet de définir des attributs nommés avec des valeurs le long du chemin.

Le type « Path » et les autres types permettant de spécifier des éléments de chemin sont communs à PathView et à Shape. Le tableau suivant présente un aperçu de l’applicabilité des différents éléments de chemin :

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

Documentation relative aux propriétés

asynchronous : bool [since 6.9]

Lorsque cette option est définie sur « true », le chemin sera traité de manière asynchrone. Il s'agit d'une optimisation visant à ne traiter le chemin qu'une seule fois, après l'exécution de toutes les méthodes susceptibles d'affecter ce chemin. Cela signifie que lorsque cette option est définie sur « true », le chemin mis à jour n'est pas disponible immédiatement après, par exemple, la modification de ` startX`, ` scale ` ou l'ajout d'un élément, mais seulement une fois que la boucle d'événements 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é s'applique que le début et la fin du chemin soient identiques ou non.

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

Cette propriété contient les objets qui composent le chemin.

Un tracé peut contenir les objets de tracé suivants :

• PathLine - une ligne droite vers 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ées sous la forme d'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 vers une position donnée avec deux points de contrôle.
• PathArc - un arc vers une position donnée avec un rayon.
• PathAngleArc - un arc défini par un point central, des rayons et des angles.
• PathSvg - un tracé spécifié sous la forme d'une chaîne de données de tracé SVG.
• PathRectangle - un rectangle dont la position et la taille sont données
• PathCurve - un point sur une courbe de Catmull-Rom.
• PathAttribute - un attribut situé à une position donnée sur le tracé.
• PathPercent - un moyen de répartir des éléments le long de différents segments du tracé.

    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é définit le facteur d'échelle du chemin. La largeur et la hauteur d’ scale s peuvent être différentes, ce qui permet d’obtenir une mise à l’échelle anisotrope.

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

simplify : bool [since 6.6]

Lorsque cette option est définie sur « true », le tracé sera simplifié. Cela implique la fusion de tous les sous-tracés qui se croisent, afin de créer un tracé ne comportant aucune auto-intersection. Les lignes parallèles consécutives seront également fusionnées. Le tracé simplifié est destiné à être utilisé avec ` ShapePath.OddEvenFill`. Les courbes de Bézier peuvent être aplaties en segments de droite en raison de l'instabilité numérique liée au calcul des intersections de courbes de Bézier.

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

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

Documentation de la méthode

[since QtQuick 2.14] point pointAtPercent(real t)

Renvoie le point situé 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 également QPainterPath::pointAtPercent().