RegularPolygonShape QML Type
Un polígono regular relleno con un borde opcional. Más...
| Import Statement: | import QtQuick.Shapes.DesignHelpers 6.12 |
| Since: | QtQuick 6.10 |
Propiedades
- capStyle : enumeration
- cornerRadius : real
- dashOffset : real
- dashPattern : list<real>
- fillColor : color
- fillGradient : ShapeGradient
- joinStyle : enumeration
- sideCount : int
- strokeColor : color
- strokeStyle : enumeration
- strokeWidth : real
Descripción detallada
Un polígono regular puede ser simplemente un trazo con forma de polígono bidimensional, un relleno o un trazo con relleno. Las propiedades « strokeColor », « strokeWidth » y « strokeStyle » especifican el aspecto del contorno. Las propiedades « dashPattern » y « dashOffset » especifican el aspecto del trazo discontinuo.
El área interior del trazo se rellena con un color de relleno liso, especificado mediante la propiedad fillColor, o con un degradado, definido mediante uno de los subtipos de ShapeGradient y configurado mediante la propiedad gradient. Si se especifican tanto un color como un degradado, se utiliza el degradado.
Para crear un polígono con trazo, establece la propiedad ` sideCount ` entre 3 y 100 y la propiedad ` strokeWidth ` en un valor superior a 0. La propiedad ` strokeWidth ` especifica el ancho del trazo del polígono. El valor predeterminado de ` sideCount ` es 6 y el de ` strokeWidth ` es 4. Si se establece la propiedad ` strokeWidth ` en un valor negativo, se oculta el borde.
La propiedad cornerRadius especifica si las esquinas del polígono son redondeadas.
Documentación de la propiedad
capStyle : enumeration
Esta propiedad define cómo se dibujan los extremos de las líneas. El valor por defecto es « ShapePath.SquareCap ».
| Constante | Descripción |
|---|---|
ShapePath.FlatCap | Un extremo de línea cuadrado que no cubre el punto final de la línea. |
ShapePath.SquareCap | Un extremo de línea cuadrado que cubre el punto final y se extiende más allá de él la mitad del ancho de la línea. |
ShapePath.RoundCap | Un extremo de línea redondeado. |
Dado que se dibuja un polígono, el trazado forma un bucle sin puntos finales de línea. Por lo tanto, capStyle solo es necesario cuando strokeStyle == ShapePath.DashLine
cornerRadius : real
La propiedad «property» especifica si las esquinas del polígono son redondeadas.
El valor por defecto es « 10 ».
dashOffset : real
Esta propiedad define el punto de inicio del patrón de guiones, medido en las unidades utilizadas para especificar dicho patrón.
El valor por defecto es 0.
Véase también QPen::setDashOffset().
dashPattern : list<real>
Esta propiedad define el patrón de guiones cuando strokeStyle se establece en ShapePath.DashLine. El patrón debe especificarse como un número par de entradas positivas, en el que las entradas 1, 3, 5... son los guiones y las 2, 4, 6... son los espacios. El patrón se especifica en unidades del ancho del trazo.
El valor por defecto es (4, 2), lo que significa un guion de 4 * strokeWidth píxeles seguido de un espacio de 2 * strokeWidth píxeles.
Véase también QPen::setDashPattern().
fillColor : color
Esta propiedad determina el color de relleno.
Si se establece en « transparent », no se aplica ningún relleno.
El valor predeterminado es « "white" ».
Nota: Si cualquiera de los valores de « fillGradient » se establece en algo distinto de « null », se utilizará en lugar de « fillColor ».
fillGradient : ShapeGradient
El «fillGradient» del color de relleno del polígono.
Por defecto, no hay ningún «fillGradient» activado y el valor es nulo. En este caso, el relleno utiliza un color sólido basado en el valor de « fillColor ».
Cuando se establece, se ignora « fillColor » y el relleno se realiza utilizando uno de los subtipos de « ShapeGradient ».
Nota: El tipo « Gradient » no se puede utilizar aquí. En su lugar, es preferible utilizar uno de los subtipos avanzados, como « LinearGradient ».
joinStyle : enumeration
Esta propiedad define cómo se dibujan las uniones entre dos líneas conectadas. El valor por defecto es « ShapePath.BevelJoin ».
| Constante | Descripción |
|---|---|
ShapePath.MiterJoin | Los bordes exteriores de las líneas se extienden hasta encontrarse en ángulo, y esta área se rellena. |
ShapePath.BevelJoin | Se rellena la muesca triangular entre las dos líneas. |
ShapePath.RoundJoin | Se rellena un arco circular entre las dos líneas. |
El parámetro «joinStyle» solo tiene sentido si « cornerRadius » == 0.
sideCount : int
El número de aristas del polígono regular. El número mínimo de aristas puede ser 3.
El valor por defecto es 6.
strokeColor : color
Esta propiedad define el color del trazo.
Cuando se establece en « transparent », no se aplica ningún trazo.
El valor por defecto es « "black" ».
strokeStyle : enumeration
Esta propiedad define el estilo del trazo. El valor predeterminado es ShapePath.SolidLine.
| Constante | Descripción |
|---|---|
ShapePath.SolidLine | Una línea continua. |
ShapePath.DashLine | Trazos separados por unos pocos píxeles. |
strokeWidth : real
Esta propiedad determina el ancho del trazo.
Si se establece en un valor negativo, no se traza el contorno.
El valor por defecto es « 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.