StarShape QML Type
Un polígono relleno en forma de estrella 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
- pointCount : int
- ratio : real
- strokeColor : color
- strokeStyle : enumeration
- strokeWidth : real
Descripción detallada
Una estrella puede ser un trazo en forma de estrella, un relleno o un trazo con relleno. Las propiedades strokeColor, strokeWidth y strokeStyle especifican el aspecto del trazo. 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 puntos de la estrella. Establezca la propiedad ratio entre 0,1 y 1 para especificar la distancia de los puntos interiores de la estrella desde el centro.
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 de ShapeGradient y establecido utilizando la propiedad degradado. Si se especifica tanto un color como un degradado, se utiliza el degradado.
Para crear una estrella con trazo, establezca la propiedad strokeWidth a un valor mayor que 0. La propiedad strokeWidth especifica el ancho del trazo del polígono. El valor por defecto pointCount es 6 y el valor por defecto strokeWidth es 4. Si se establece el valor strokeWidth a un valor negativo, se oculta el borde.
La propiedad cornerRadius especifica si las esquinas de la estrella 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 una estrella, 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
Esta propiedad controla el redondeo de los puntos exteriores e interiores de la estrella.
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 de la estrella.
Por defecto, no se activa fillGradient y el valor es nulo. 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.
pointCount : int
La propiedad define el número total de puntos que tiene la estrella.
El valor por defecto es 6.
ratio : real
La propiedad define la distancia de los puntos interiores de la estrella desde el centro.
El valor por defecto es 0.5.
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.
