RegularPolygonShape QML Type
Un polygone régulier rempli 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
- sideCount : int
- strokeColor : color
- strokeStyle : enumeration
- strokeWidth : real
Description détaillée
Un polygone régulier peut être simplement un trait en forme de polygone 2D, 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és.
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 un polygone avec un trait, définissez la propriété sideCount entre 3 et 100 et la propriété strokeWidth supérieure à 0. La propriété strokeWidth spécifie la largeur du trait du polygone. La valeur par défaut de sideCount est 6 et la valeur par défaut de strokeWidth est 4. La valeur négative de strokeWidth permet de masquer la bordure.
La propriété cornerRadius indique si les coins du polygone 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'un polygone est dessiné, le chemin forme une boucle sans point d'extrémité de ligne. Par conséquent, capStyle n'est nécessaire que lorsque strokeStyle == ShapePath.DashLine
cornerRadius : real
La propriété spécifie si les coins du polygone sont arrondis.
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 du polygone.
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.
sideCount : int
Le nombre d'arêtes du polygone régulier. Le nombre minimum d'arêtes peut être de 3.
La valeur par défaut est 6.
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.
