En esta página

StarShape QML Type

Un polígono relleno con forma de estrella y un borde opcional. Más...

Import Statement: import QtQuick.Shapes.DesignHelpers 6.12
Since: QtQuick 6.10

Propiedades

Descripción detallada

Una estrella puede ser un trazo con forma de estrella, 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.

Establezca la propiedad « pointCount » entre 3 y 60 para especificar el número de puntas de la estrella. Establezca la propiedad « ratio » entre 0,1 y 1 para especificar la distancia de los puntos interiores de la estrella respecto al centro.

El área interior del trazo se rellena con un color de relleno sólido, especificado mediante la propiedad « fillColor », o con un degradado, definido mediante uno de los subtipos de « ShapeGradient » y establecido mediante la propiedad «gradient ». Si se especifican tanto un color como un degradado, se utiliza el degradado.

Para crear una estrella con trazo, establezca la propiedad « strokeWidth » en un valor superior a 0. La propiedad « strokeWidth » especifica el ancho del trazo del polígono. El valor predeterminado de « pointCount » es 6 y el valor predeterminado de « strokeWidth » es 4. Si se establece el valor de « strokeWidth » en un valor negativo, se oculta el borde.

La propiedad cornerRadius especifica si las esquinas en forma de estrella están 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 una estrella, el trazado forma un bucle sin puntos finales de línea. Por lo tanto, capStyle solo es necesario cuando strokeStyle == ShapePath.DashLine

cornerRadius : real

Esta propiedad controla el redondeo tanto de los puntos exteriores como de los interiores de la estrella.

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 las que las entradas 1, 3, 5... son los guiones y las entradas 2, 4, 6... son los espacios. El patrón se especifica en unidades equivalentes al ancho del trazo.

El valor predeterminado es (4, 2), lo que significa un trazo 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 alguna de las opciones de « fillGradient » se establece en un valor distinto de « null », se utilizará en lugar de « fillColor ».

fillGradient : ShapeGradient

El «fillGradient» del color de relleno de la estrella.

Por defecto, no hay ningún «fillGradient» activado y el valor es nulo. En este caso, el relleno utiliza un color liso 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 zona 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.

pointCount : int

Esta propiedad define el número total de puntas que tiene la estrella.

El valor por defecto es 6.

ratio : real

Esta propiedad define la distancia entre los puntos interiores de la estrella y el centro.

El valor por defecto es 0.5.

strokeColor : color

Esta propiedad determina 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 un valor negativo, no se traza ningún 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.