Sur cette page

PathArc QML Type

Définit un arc avec le rayon donné. Plus d'informations...

Import Statement: import QtQuick

Propriétés

Description détaillée

PathArc est un moyen simple de spécifier un arc qui se termine à une position donnée et utilise le rayon spécifié. Il s'inspire de la commande SVG "arc elliptique".

Le QML suivant produit le chemin illustré ci-dessous :

Path {
    startX: 100; startY: 0

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

Notez qu'un seul PathArc ne peut pas être utilisé pour spécifier un cercle. Au lieu de cela, vous pouvez utiliser deux éléments PathArc, chacun spécifiant la moitié du cercle.

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

Documentation sur les propriétés

direction : enumeration

Définit la direction de l'arc. Les valeurs possibles sont PathArc.dans le sens des aiguilles d'une montre (valeur par défaut) et PathArc.dans le sens inverse des aiguilles d'une montre.

Le QML suivant peut produire l'un ou l'autre des deux arcs illustrés ci-dessous en modifiant la valeur de la direction.

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 QML suivant montre comment différentes valeurs de rayon peuvent être utilisées pour modifier la forme de l'arc :

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 final de l'arc par rapport à son début.

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

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

Voir également x et y.

useLargeArc : bool

Utilisation ou non d'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 possibles peuvent correspondre aux données. useLargeArc est utilisé pour les distinguer. Par exemple, le QML suivant peut produire l'un ou l'autre des deux arcs illustrés ci-dessous en modifiant la valeur de useLargeArc.

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 final 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 cercles ou d'ellipses. Compte tenu du rayon et des points de départ et d'arrivée, deux ellipses relient les points. Cette propriété définit la rotation de l'axe X de ces ellipses.

Remarque : la 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 QML suivant montre comment différentes valeurs de rayon peuvent être utilisées pour modifier la forme de l'arc :

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.