StarShape QML Type
Un polygone en forme d'étoile rempli, avec une bordure facultative. En savoir plus...
| Import Statement: | import QtQuick.Shapes.DesignHelpers 6.12 |
| Since: | QtQuick 6.10 |
Propriétés
- capStyle : enumeration
- cornerRadius : real
- dashOffset : real
- dashPattern : list<real>
- fillColor : color
- fillGradient : ShapeGradient
- joinStyle : enumeration
- pointCount : int
- ratio : real
- strokeColor : color
- strokeStyle : enumeration
- strokeWidth : real
Description détaillée
Une étoile peut être un trait en forme d’étoile, un remplissage ou un trait avec remplissage. Les propriétés strokeColor, strokeWidth et strokeStyle définissent l’apparence du contour. Les propriétés dashPattern et dashOffset définissent l’apparence du trait en pointillés.
Définissez la propriété ` pointCount ` entre 3 et 60 pour spécifier le nombre de branches de l’étoile. Définissez la propriété ` ratio ` entre 0,1 et 1 pour spécifier la distance entre les branches intérieures de l’étoile et son centre.
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 la propriété ShapeGradient et configuré à l’aide de la propriété gradient. Si une couleur et un dégradé sont tous deux spécifiés, c’est le dégradé qui est utilisé.
Pour créer une étoile avec un trait, définissez la propriété « strokeWidth » sur une valeur supérieure à 0. La propriété « strokeWidth » spécifie la largeur du trait du polygone. La valeur par défaut de « pointCount » est 6 et celle de « strokeWidth » est 4. Définir la valeur de « strokeWidth » sur une valeur négative masque le contour.
La propriété cornerRadius indique si les coins en étoile sont arrondis.
Documentation des propriétés
capStyle : enumeration
Cette propriété définit la manière dont les extrémités des lignes sont tracées. La valeur par défaut est « ShapePath.SquareCap ».
| Constante | Description |
|---|---|
ShapePath.FlatCap | Une extrémité de ligne carrée qui ne recouvre pas le point d'extrémité de la ligne. |
ShapePath.SquareCap | Une extrémité de ligne carrée qui recouvre l'extrémité de la ligne et s'étend au-delà de celle-ci de la moitié de la largeur de la ligne. |
ShapePath.RoundCap | Une extrémité de ligne arrondie. |
Comme il s'agit d'une étoile, le tracé forme une boucle sans points d'extrémité. Par conséquent, capStyle n'est nécessaire que lorsque strokeStyle == ShapePath.DashLine
cornerRadius : real
Cette propriété contrôle l'arrondi des pointes extérieures et intérieures de l'étoile.
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 spécifier 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 trait 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" ».
Remarque : si l'une des valeurs « fillGradient » est définie sur une valeur autre que « null », celle-ci sera utilisée à la place de « fillColor ».
fillGradient : ShapeGradient
La propriété « fillGradient » de la couleur de remplissage en forme d'étoile.
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 `.
Remarque : le type « Gradient » ne peut pas être utilisé ici. Préférez plutôt l’un des sous-types avancés, comme « LinearGradient ».
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 ».
| Constante | Description |
|---|---|
ShapePath.MiterJoin | Les bords extérieurs des lignes sont prolongés pour se rejoindre en formant un angle, et cette zone est remplie. |
ShapePath.BevelJoin | L'encoche triangulaire entre les deux lignes est remplie. |
ShapePath.RoundJoin | Un arc de cercle entre les deux lignes est rempli. |
Le paramètre joinStyle n'a de sens que si cornerRadius == 0.
pointCount : int
Cette propriété définit le nombre total de branches de l'étoile.
La valeur par défaut est « 6 ».
ratio : real
Cette propriété définit la distance entre les points intérieurs de l'étoile et son centre.
La valeur par défaut est 0.5.
strokeColor : color
Cette propriété définit la couleur du contour.
Lorsqu'elle est définie sur « transparent », aucun contour 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`.
| Constante | Description |
|---|---|
ShapePath.SolidLine | Une ligne continue. |
ShapePath.DashLine | Des tirets séparés de quelques pixels. |
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.
© 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.
