RegularPolygonShape QML Type
Un polygone régulier 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
- sideCount : int
- strokeColor : color
- strokeStyle : enumeration
- strokeWidth : real
Description détaillée
Un polygone régulier peut être simplement un trait de forme polygonale en 2D, 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.
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 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 un polygone avec un trait, définissez la propriété sideCount sur une valeur comprise entre 3 et 100 et 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 sideCount 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 spécifie 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 recouvre pas le point d'extrémité de la ligne. |
ShapePath.SquareCap | Une extrémité de ligne carrée qui recouvre le point d’extrémité et s’étend au-delà de celui-ci de la moitié de la largeur de la ligne. |
ShapePath.RoundCap | Une extrémité de ligne arrondie. |
Comme il s'agit d'un polygone, le tracé 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é « property » indique si les sommets 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 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 des 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 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 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.
sideCount : int
Le nombre d'arêtes du polygone régulier. Le nombre minimal d'arêtes peut être de 3.
La valeur par défaut est 6.
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.
