EllipseShape QML Type

Un composant de forme qui peut rendre une ellipse, un arc ou une tranche de tarte. Plus d'informations...

• 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 peint une ellipse, qui peut être personnalisée pour apparaître sous la forme d'une ellipse complète, d'un arc ou d'une tranche de tarte 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 avec la propriété fillColor, et le contour est dessiné selon les propriétés strokeColor, strokeWidth, et strokeStyle.

Arc et tranches de tarte

Pour créer un arc ou une tranche de tarte, définissez les propriétés startAngle (0-360 degrés) et sweepAngle (0-360 degrés) pour définir le segment de l'ellipse à dessiner.

Mode Arc: Pour créer un arc simple (juste le contour), réglez fillColor sur "transparent". Le style de ligne 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 fillColor. Le contour de la part sera également tracé.

Mode Donut: Pour créer un anneau en forme de beignet (une ellipse creuse), réglez le paramètre innerArcRatio sur une valeur comprise entre 0,0 et 1,0. Cette valeur définit le rapport entre le rayon de l'ellipse intérieure et le rayon de l'ellipse extérieure.

La zone située à l'intérieur du trait est peinte à l'aide d'une couleur de remplissage unie, spécifiée à l'aide de la propriété fillColor, ou d'un dégradé, défini à l'aide de l'un des sous-types ShapeGradient et défini à l'aide de la propriété fillGradient. Si une couleur et un dégradé sont spécifiés, c'est le dégradé qui est utilisé.

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

L'ellipse peut être dessinée avec des coins arrondis en utilisant 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 d'EllipseShape est Shape.CurveRenderer.

Exemple d'utilisation

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

Documentation sur la propriété

borderMode : enumeration

La propriété borderMode détermine où la bordure est dessinée le long du bord 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

Contrôle l'arrondi des coins où les lignes radiales rencontrent les arcs elliptiques. Pour les segments de tarte, ce paramètre arrondit la connexion à l'arc extérieur. Pour les segments de donuts, ce paramètre arrondit également les connexions aux arcs intérieurs et extérieurs.

La valeur par défaut est 10.

dashOffset : real

Cette propriété définit le point de départ du motif du tiret, mesuré dans les unités utilisées pour spécifier le motif du tiret.

La valeur par défaut est 0.

Voir également QPen::setDashOffset().

dashPattern : list<real>

Cette propriété définit le motif des tirets lorsque strokeStyle est défini 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... sont les tirets et 2, 4, 6... sont les espaces. Le motif est spécifié en unités de largeur du stylo.

La valeur par défaut est (4, 2), ce qui signifie 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.

Si la valeur est transparent, il n'y a pas de remplissage.

La valeur par défaut est "white".

fillGradient : ShapeGradient

Le gradient de remplissage 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 est effectué à l'aide de l'un des sous-types ShapeGradient.

fillRule : enumeration

Cette propriété contient la règle de remplissage. La valeur par défaut est ShapePath.OddEvenFill. Pour une explication sur les règles de remplissage, voir QPainterPath::setFillRule().

innerArcRatio : real

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

La plage de valeurs est comprise entre 0,0 et 1,0. Si la valeur est de 0,0, l'arc intérieur s'affaisse vers le centre, dessinant ainsi une ellipse pleine. En réglant la valeur sur 1,0, l'arc intérieur a la même taille que l'ellipse extérieure, ce qui ne donne qu'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 dessinées les jointures entre deux lignes connecté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 l'ellipse doit être dessinée.

L'angle de 0 degré indique le 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 de l'effet de caresse.

Lorsqu'elle est définie sur transparent, il n'y a pas de tracé.

La valeur par défaut est "black".

strokeStyle : enumeration

Cette propriété définit le style de 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 effectué.

La valeur par défaut est 1.

sweepAngle : real

L'étendue angulaire en degrés à dessiner à partir de 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 dessiné dans le sens inverse des aiguilles d'une montre.

La valeur par défaut est 360.