StarShape QML Type
Un polygone rempli en forme d'étoile avec une bordure optionnelle. Plus d'informations...
| Import Statement: | import QtQuick.Shapes.DesignHelpers 6.11 |
| 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 précisent l'aspect du contour. Les propriétés dashPattern et dashOffset précisent l'aspect du trait en pointillé.
Réglez la propriété pointCount entre 3 et 60 pour spécifier le nombre de points de l'étoile. Définissez la propriété ratio entre 0,1 et 1 pour spécifier la distance des points intérieurs de l'étoile par rapport au centre.
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é gradient. Si une couleur et un dégradé sont 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 avec 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 la valeur par défaut de strokeWidth est 4. La valeur négative de strokeWidth masque la bordure.
La propriété cornerRadius indique si les coins de l'étoile sont arrondis.
Documentation sur les propriétés
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.
| Constante | Description |
|---|---|
ShapePath.FlatCap | Une extrémité de ligne carrée qui ne couvre pas le point final de la ligne. |
ShapePath.SquareCap | Une extrémité de ligne carrée qui couvre le point final et le dépasse de la moitié de la largeur de la ligne. |
ShapePath.RoundCap | Extrémité de ligne arrondie. |
Étant donné qu'une étoile est dessinée, le chemin forme une boucle sans aucun point d'extrémité de ligne. Par conséquent, capStyle n'est nécessaire que lorsque strokeStyle == ShapePath.DashLine
cornerRadius : real
Cette propriété contrôle l'arrondi des points extérieurs et intérieurs de l'étoile.
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".
Remarque : si la valeur de fillGradient est différente de null, elle sera utilisée à la place de fillColor.
fillGradient : ShapeGradient
Le gradient de remplissage de la couleur de remplissage de l'é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 est effectué à l'aide de l'un des sous-types ShapeGradient.
Note : Le type Gradient ne peut pas être utilisé ici. Il est préférable d'utiliser l'un des sous-types avancés, comme LinearGradient.
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.
| Constante | Description |
|---|---|
ShapePath.MiterJoin | Les bords extérieurs des lignes sont prolongés pour former 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 points 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 le centre.
La valeur par défaut est 0.5.
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.
| Constante | Description de la constante |
|---|---|
ShapePath.SolidLine | Une ligne simple. |
ShapePath.DashLine | Tirets séparés par 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 effectué.
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.
