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
- capStyle : enumeration
- cornerRadius : real
- dashOffset : real
- dashPattern : list<real>
- fillColor : color
- fillGradient : ShapeGradient
- joinStyle : enumeration
- pointCount : int
- ratio : real
- strokeColor : color
- strokeStyle : enumeration
- strokeWidth : real
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 ».
| 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 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 ».
| Constante | Descripción |
|---|---|
ShapePath.MiterJoin | Los bordes exteriores de las líneas se extienden hasta encontrarse en ángulo, y esta zona 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.
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.
| 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 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.