EllipseShape QML Type

Composant de forme permettant d'afficher une ellipse, un arc ou une part de cercle. En savoir plus...

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

Propriétés

• borderMode : enumeration
• capStyle : enumeration
• cornerRadius : real
• dashOffset : real
• dashPattern : list<real>
• fillColor : color
• fillGradient : ShapeGradient
• fillRule : enumeration
• innerArcRatio : real
• joinStyle : enumeration
• startAngle : real
• strokeColor : color
• strokeStyle : enumeration
• strokeWidth : real
• sweepAngle : real

Description détaillée

L'élément EllipseShape dessine une ellipse, qui peut être personnalisée pour apparaître sous la forme d'une ellipse complète, d'un arc ou d'une part de cercle remplie. Son apparence est contrôlée par les propriétés startAngle et sweepAngle.

Ellipse de base

Par défaut, l'élément affiche une ellipse complète. L'intérieur est rempli selon la propriété fillColor, et le contour est tracé selon les propriétés strokeColor, strokeWidth et strokeStyle.

Arcs et secteurs circulaires

Pour créer un arc ou une part de cercle, définissez les propriétés ` startAngle ` (0 à 360 degrés) et ` sweepAngle ` (0 à 360 degrés) afin de déterminer le segment de l’ellipse à dessiner.

Mode Arc: pour créer un simple arc (contour uniquement), définissez l’ fillColor sur "transparent". Le style de trait de l’arc peut être personnalisé à l’aide de dashPattern et dashOffset.

Mode « Pie »: pour créer une part de tarte remplie (un segment relié au centre), il suffit de définir l’ fillColor. Le contour de la part sera également tracé.

Mode « donut »: pour créer un anneau de type « donut » (une ellipse creuse), définissez la propriété ` innerArcRatio ` sur une valeur comprise entre 0,0 et 1,0. Cela définit le rapport entre le rayon de l’ellipse intérieure et celui de l’ellipse extérieure.

La zone à l’intérieur du trait est colorée soit avec une couleur de remplissage unie, spécifiée à l’aide de la propriété ` fillColor `, soit avec un dégradé, défini à l’aide de l’un des sous-types de ` ShapeGradient ` et configuré via la propriété ` fillGradient `. Si une couleur et un dégradé sont tous deux spécifiés, c’est le dégradé qui est utilisé.

Une bordure facultative peut être ajoutée à une ellipse avec sa propre couleur et son propre épaisseur en définissant les propriétés strokeColor et strokeWidth. Définir la couleur sur transparent crée une bordure sans couleur de remplissage.

Une ellipse peut être dessinée avec des coins arrondis à l’aide de la propriété ` cornerRadius `. La valeur par défaut de ` cornerRadius ` est de 10 degrés.

La valeur par défaut de la propriété « QtQuick.Shapes::Shape::preferredRendererType » de EllipseShape est « Shape.CurveRenderer ».

Exemple d’utilisation

    EllipseShape {
        id: ellipseShape
        anchors.fill: parent
        width: 90
        height: 90
        startAngle: 0
        sweepAngle: 270
    }

Documentation de la propriété

borderMode : enumeration

La propriété borderMode détermine l'emplacement où la bordure est tracée le long du contour de l'ellipse.

Il s'agit de la valeur par défaut.

Voir également strokeWidth.

capStyle : enumeration

Cette propriété définit la manière dont les extrémités des lignes sont dessinées. La valeur par défaut est « ShapePath.SquareCap ».

cornerRadius : real

Permet de contrôler l'arrondi des angles aux points de jonction entre les lignes radiales et les arcs elliptiques. Pour les segments de camembert, cela arrondit la jonction avec l'arc extérieur. Pour les segments de beignet, cela arrondit également les jonctions avec les arcs intérieur et extérieur.

La valeur par défaut est « 10 ».

dashOffset : real

Cette propriété définit le point de départ du motif de tirets, mesuré dans les unités utilisées pour définir ce motif.

La valeur par défaut est 0.

Voir également QPen::setDashOffset().

dashPattern : list<real>

Cette propriété définit le motif de tirets lorsque la propriété « strokeStyle » est définie sur « ShapePath.DashLine ». Le motif doit être spécifié sous la forme d’un nombre pair d’entrées positives, où les entrées 1, 3, 5… correspondent aux tirets et les entrées 2, 4, 6… aux espaces. Le motif est spécifié en unités correspondant à la largeur du stylo.

La valeur par défaut est (4, 2), ce qui correspond à un tiret de 4 * strokeWidth pixels suivi d'un espace de 2 * strokeWidth pixels.

Voir également QPen::setDashPattern().

fillColor : color

Cette propriété définit la couleur de remplissage.

Lorsqu'elle est définie sur « transparent », aucun remplissage n'est appliqué.

La valeur par défaut est « "white" ».

fillGradient : ShapeGradient

Le « fillGradient » de la couleur de remplissage de l'ellipse.

Par défaut, aucun fillGradient n'est activé et la valeur est nulle. Dans ce cas, le remplissage utilise une couleur unie basée sur la valeur de fillColor.

Lorsqu’il est défini, « fillColor » est ignoré et le remplissage s’effectue à l’aide de l’un des sous-types de « ShapeGradient ».

fillRule : enumeration

Cette propriété définit la règle de remplissage. La valeur par défaut est « ShapePath.OddEvenFill ». Pour plus d'informations sur les règles de remplissage, consultez QPainterPath::setFillRule().

innerArcRatio : real

Cette propriété définit le rapport entre les arcs intérieur et extérieur.

La plage de valeurs est comprise entre 0,0 et 1,0. Si vous définissez la valeur sur 0,0, l'arc intérieur s'affaissera vers le centre, créant ainsi une ellipse pleine. Si vous définissez la valeur sur 1,0, l'arc intérieur aura la même taille que l'ellipse extérieure, ce qui donnera simplement un arc. Les valeurs comprises entre 0,0 et 1,0 créent des anneaux elliptiques creux.

La valeur par défaut est 0.

joinStyle : enumeration

Cette propriété définit la manière dont sont tracées les jonctions entre deux lignes reliées. La valeur par défaut est « ShapePath.BevelJoin ».

startAngle : real

Cette propriété définit l'angle de départ, en degrés, à partir duquel commencer à tracer l'ellipse.

0 degré correspond au sommet. L'angle augmente dans le sens des aiguilles d'une montre.

La valeur par défaut est 0.

strokeColor : color

Cette propriété définit la couleur du contour.

Lorsqu'elle est définie sur « transparent », aucun trait n'est tracé.

La valeur par défaut est « "black" ».

strokeStyle : enumeration

Cette propriété définit le style du trait. La valeur par défaut est ShapePath.SolidLine.

strokeWidth : real

Cette propriété définit la largeur du trait.

Lorsqu'elle est définie sur une valeur négative, aucun trait n'est tracé.

La valeur par défaut est 1.

sweepAngle : real

L'angle en degrés à tracer à partir de l'startAngle.

Si la valeur est positive, l'arc est tracé dans le sens des aiguilles d'une montre. Si la valeur est négative, l'arc est tracé dans le sens inverse des aiguilles d'une montre.

La valeur par défaut est 360.