RegularPolygonShape QML Type
Un polígono regular relleno con un borde opcional. Más...
| Import Statement: | import QtQuick.Shapes.DesignHelpers 6.11 |
| 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 sólo un trazo con forma de polígono 2D, un relleno o un trazo con relleno. Las propiedades strokeColor, strokeWidth, y strokeStyle especifican la apariencia del contorno. Las propiedades dashPattern y dashOffset especifican el aspecto del trazo discontinuo.
El área dentro del trazo se pinta utilizando un color de relleno sólido, especificado utilizando la propiedad fillColor, o un degradado, definido utilizando uno de los subtipos ShapeGradient y establecido utilizando la propiedad degradado. Si se especifica tanto un color como un degradado, se utiliza el degradado.
Para crear un polígono con un trazo, establezca la propiedad sideCount entre 3 y 100 y la propiedad strokeWidth mayor que 0. La propiedad strokeWidth especifica la anchura del trazo del polígono. El valor por defecto de sideCount es 6 y el valor por defecto de strokeWidth es 4. Establecer el valor de strokeWidth a un valor negativo oculta el borde.
La propiedad cornerRadius especifica si las esquinas del polígono están redondeadas.
Documentación de Propiedades
capStyle : enumeration
Esta propiedad define cómo se dibujan los puntos finales de las líneas. El valor por defecto es ShapePath.SquareCap.
| Constante | Descripción |
|---|---|
ShapePath.FlatCap | Un final de línea cuadrado que no cubre el punto final de la línea. |
ShapePath.SquareCap | Un final 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 final 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 sólo es necesario cuando strokeStyle == ShapePath.DashLine
cornerRadius : real
La propiedad especifica si las esquinas del polígono están redondeadas.
El valor por defecto es 10.
dashOffset : real
Esta propiedad define el punto de inicio en el patrón de guiones, medido en unidades utilizadas para especificar el patrón de guiones.
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 donde las entradas 1, 3, 5... son los guiones y 2, 4, 6... son los espacios. El patrón se especifica en unidades del ancho de la pluma.
El valor por defecto es (4, 2), lo que significa un guión de 4 * strokeWidth píxeles seguido de un espacio de 2 * strokeWidth píxeles.
Véase también QPen::setDashPattern().
fillColor : color
Esta propiedad contiene el color de relleno.
Cuando se establece en transparent, no se produce relleno.
El valor por defecto es "white".
Nota: Si fillGradient tiene un valor distinto de null, se utilizará en lugar de fillColor.
fillGradient : ShapeGradient
El fillGradient del color de relleno del polígono.
Por defecto, no se activa fillGradient y el valor es null. En este caso, el relleno utiliza un color sólido basado en el valor de fillColor.
Cuando se establece, fillColor se ignora y el relleno se realiza utilizando uno de los subtipos de ShapeGradient.
Nota: El tipo Gradient no puede utilizarse aquí. En su lugar, prefiera 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 para encontrarse en un ángulo, y esta área se rellena. |
ShapePath.BevelJoin | Se rellena la muesca triangular entre las dos líneas. |
ShapePath.RoundJoin | Se rellena el arco circular entre las dos líneas. |
El joinStyle sólo 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 contiene el color del trazo.
Cuando se establece en transparent, no se produce el trazo.
El valor por defecto es "black".
strokeStyle : enumeration
Esta propiedad define el estilo del trazo. El valor por defecto es ShapePath.SolidLine.
| Constante | Descripción |
|---|---|
ShapePath.SolidLine | Una línea lisa. |
ShapePath.DashLine | Guiones separados por unos pocos píxeles. |
strokeWidth : real
Esta propiedad contiene el ancho del trazo.
Cuando se establece en un valor negativo, no se produce el trazo.
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.
