En esta página

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

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 ».

ConstanteDescripción
ShapePath.FlatCapUn extremo de línea cuadrado que no cubre el punto final de la línea.
ShapePath.SquareCapUn 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.RoundCapUn 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 ».

ConstanteDescripción
ShapePath.MiterJoinLos bordes exteriores de las líneas se extienden hasta encontrarse en ángulo, y esta área se rellena.
ShapePath.BevelJoinSe rellena la muesca triangular entre las dos líneas.
ShapePath.RoundJoinSe 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.

ConstanteDescripción
ShapePath.SolidLineUna línea continua.
ShapePath.DashLineTrazos 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.