Sur cette page

PathArc QML Type

Définit un arc de rayon donné. En savoir plus…

Import Statement: import QtQuick

Propriétés

Description détaillée

PathArc permet de définir facilement un arc qui se termine à une position donnée et utilise le rayon spécifié. Il s'inspire de la commande d'arc elliptique SVG.

Le code QML suivant génère le tracé illustré ci-dessous :

Arc de cercle presque complet tracé entre le point de départ et le point d'arrivée

Path {
    startX: 100; startY: 0

    PathArc {
        x: 0; y: 100
        radiusX: 100; radiusY: 100
        useLargeArc: true
    }
}

Notez qu'un seul élément PathArc ne permet pas de définir un cercle. Vous pouvez en revanche utiliser deux éléments PathArc, chacun définissant la moitié du cercle.

Voir également Path, PathLine, PathQuad, PathCubic, PathAngleArc, PathCurve et PathSvg.

Documentation relative aux biens immobiliers

direction : enumeration

Définit le sens de l'arc. Les valeurs possibles sont PathArc.Clockwise (par défaut) et PathArc.Counterclockwise.

Le code QML suivant permet de générer l'un ou l'autre des deux arcs illustrés ci-dessous en modifiant la valeur de direction.

Deux arcs ayant les mêmes extrémités : l'un s'incurvant dans le sens des aiguilles d'une montre, l'autre dans le sens inverse des aiguilles d'une montre

Path {
    startX: 50; startY: 50

    PathArc {
        x: 150; y: 50
        radiusX: 75; radiusY: 50
    }
}

Voir également useLargeArc.

radiusX : real

radiusY : real

Définit le rayon de l'arc.

Le code QML suivant montre comment différentes valeurs de rayon peuvent être utilisées pour modifier la forme de l'arc :

Quatre variétés d'arcs de rayons différents disposées les unes à la suite des autres

Path {
    startX: 0; startY: 100

    PathArc {
        relativeX: 50; y: 100
        radiusX: 25; radiusY: 15
    }
    PathArc {
        relativeX: 50; y: 100
        radiusX: 25; radiusY: 25
    }
    PathArc {
        relativeX: 50; y: 100
        radiusX: 25; radiusY: 50
    }
    PathArc {
        relativeX: 50; y: 100
        radiusX: 50; radiusY: 100
    }
}

relativeX : real

relativeY : real

Définit le point d'arrivée de l'arc par rapport à son point de départ.

Si une position de fin relative et une position de fin absolue sont toutes deux spécifiées pour un même axe, c'est la position relative qui sera utilisée.

Les positions relatives et absolues peuvent être combinées ; par exemple, il est possible de définir une position x relative et une position y absolue.

Voir également x et y.

useLargeArc : bool

Indique s'il faut utiliser un grand arc tel que défini par les points d'arc.

Étant donné des positions de départ et d'arrivée, un rayon et une direction fixes, deux arcs différents peuvent correspondre aux données. Le paramètre useLargeArc permet de faire la distinction entre ces deux arcs. Par exemple, le code QML suivant permet de générer l'un ou l'autre des deux arcs illustrés ci-dessous en modifiant la valeur de useLargeArc.

Deux arcs ayant les mêmes extrémités : un petit arc lorsque useLargeArc est à « false », un grand arc lorsque cette option est à « true »

Path {
    startX: 0; startY: 100
    PathArc {
        x: 100; y: 200
        radiusX: 100; radiusY: 100
        direction: PathArc.Clockwise
    }
}

La valeur par défaut est « false ».

x : real

y : real

Définit le point d'extrémité de l'arc.

Voir également relativeX et relativeY.

xAxisRotation : real

Définit la rotation de l'arc, en degrés. La valeur par défaut est 0.

Un arc est une section de cercle ou d'ellipse. Étant donné le rayon ainsi que les points de départ et d’arrivée, il existe deux ellipses qui relient ces points. Cette propriété définit la rotation autour de l’axe X de ces ellipses.

Remarque : cette valeur n'est utile que lorsque les rayons x et y sont différents, ce qui signifie que l'arc est une section d'ellipses.

Le code QML suivant montre comment différentes valeurs de rayon peuvent être utilisées pour modifier la forme de l'arc :

Deux arcs elliptiques : l'un sans rotation, l'autre tourné de 45 degrés

Path {
    startX: 50; startY: 100

    PathArc {
        x: 150; y: 100
        radiusX: 50; radiusY: 20
        xAxisRotation: 45
    }
}

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.