EllipseShape QML Type
Un componente de forma que puede representar una elipse, un arco o un sector circular. Más...
| Import Statement: | import QtQuick.Shapes.DesignHelpers 6.12 |
| Since: | QtQuick 6.10 |
Propiedades
- borderMode : enumeration
- capStyle : enumeration
- cornerRadius : real
- dashOffset : real
- dashPattern : list<real>
- fillColor : color
- fillGradient : ShapeGradient
- fillRule : enumeration
- innerArcRatio : real
- joinStyle : enumeration
- startAngle : real
- strokeColor : color
- strokeStyle : enumeration
- strokeWidth : real
- sweepAngle : real
Descripción detallada
El elemento EllipseShape dibuja una elipse, que se puede personalizar para que aparezca como una elipse completa, un arco o un sector de tarta relleno. Su aspecto se controla mediante las propiedades startAngle y sweepAngle.
Elipse básica
De forma predeterminada, el elemento representa una elipse completa. El interior se rellena con el valor de « fillColor », y el contorno se dibuja según las propiedades « strokeColor », « strokeWidth » y « strokeStyle ».
Arcos y porciones circulares
Para crear un arco o un sector circular, establece los valores de « startAngle » (0-360 grados) y « sweepAngle » (0-360 grados) para definir el segmento de la elipse que se va a dibujar.
Modo arco: Para crear un arco simple (solo el contorno), establece « fillColor » en « "transparent" ». El estilo de línea del arco se puede personalizar con « dashPattern » y « dashOffset ».
Modo «Pie»: Para crear una porción de tarta rellena (un segmento conectado al centro), basta con establecer el valor de « fillColor ». El contorno de la porción también se trazará.
Modo «donut»: Para crear un anillo tipo «donut» (una elipse hueca), establece la propiedad « innerArcRatio » en un valor comprendido entre 0,0 y 1,0. Esto define la relación entre el radio de la elipse interior y el radio de la elipse exterior.
El área dentro del trazo se rellena con un color sólido, especificado mediante la propiedad « fillColor », o con un degradado, definido mediante uno de los subtipos de « ShapeGradient » y configurado mediante la propiedad « fillGradient ». Si se especifican tanto un color como un degradado, se utiliza el degradado.
Se puede añadir un borde opcional a una elipse con su propio color y grosor configurando las propiedades strokeColor y strokeWidth. Si se establece el color en transparent, se crea un borde sin color de relleno.
Se puede dibujar una elipse con esquinas redondeadas utilizando la propiedad « cornerRadius ». El valor predeterminado de la propiedad « cornerRadius » es de 10 grados.
El valor por defecto de « QtQuick.Shapes::Shape::preferredRendererType » en «EllipseShape» es « Shape.CurveRenderer ».
Ejemplo de uso
EllipseShape {
id: ellipseShape
anchors.fill: parent
width: 90
height: 90
startAngle: 0
sweepAngle: 270
}
Documentación de la propiedad
borderMode : enumeration
La propiedad `borderMode` determina dónde se dibuja el borde a lo largo del contorno de la elipse.
| Constante | Descripción |
|---|---|
EllipseShape.Inside | El borde se dibuja a lo largo del borde interior del elemento y no afecta a la anchura del mismo. |
Este es el valor predeterminado.
| Constante | Descripción |
|---|---|
EllipseShape.Middle | El borde se dibuja sobre el borde del elemento y no afecta a la anchura del mismo. |
EllipseShape.Outside | El borde se dibuja a lo largo del borde exterior del elemento y aumenta su anchura en el valor de strokeWidth. |
Véase también « strokeWidth ».
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 este en la mitad del ancho de la línea. |
ShapePath.RoundCap | Un extremo de línea redondeado. |
cornerRadius : real
Controla el redondeo de las esquinas donde las líneas radiales se unen con los arcos elípticos. En el caso de los segmentos de tarta, esto redondea la unión con el arco exterior. En el caso de los segmentos de rosquilla, esto redondea también las uniones tanto con el arco interior como con el exterior.
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 predeterminado es ` 0`.
Véase también QPen::setDashOffset().
dashPattern : list<real>
Esta propiedad define el patrón de guiones cuando se establece « strokeStyle » 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 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 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 cualquiera de los valores « fillGradient » se establece en algo distinto de « null », se utilizará en lugar de « fillColor ».
fillGradient : ShapeGradient
El «fillGradient» del color de relleno de la elipse.
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í. Es preferible utilizar uno de los subtipos avanzados, como « LinearGradient ».
fillRule : enumeration
Esta propiedad define la regla de relleno. El valor por defecto es ShapePath.OddEvenFill. Para obtener una explicación sobre las reglas de relleno, consulta QPainterPath::setFillRule().
| Constante | Descripción |
|---|---|
ShapePath.OddEvenFill | Regla de relleno par-impar. |
ShapePath.WindingFill | Regla de relleno de bobinado distinta de cero. |
innerArcRatio : real
Esta propiedad define la relación entre los arcos interior y exterior.
El rango de valores está comprendido entre 0,0 y 1,0. Si se establece el valor en 0,0, el arco interior se colapsará hacia el centro, dibujando una elipse rellena. Si se establece el valor en 1,0, el arco interior tendrá el mismo tamaño que la elipse exterior, lo que dará como resultado únicamente un arco. Los valores entre 0,0 y 1,0 crean anillos elípticos huecos.
El valor predeterminado es 0.
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 prolongan 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. |
startAngle : real
Esta propiedad define el ángulo inicial, expresado en grados, desde el que se empieza a dibujar la elipse.
0 grados apunta hacia arriba. El ángulo aumenta en el sentido de las agujas del reloj.
El valor por defecto es 0.
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 grosor del trazo.
Si se establece en un valor negativo, no se traza el trazo.
El valor por defecto es 1.
sweepAngle : real
El ángulo, expresado en grados, que se va a trazar a partir del startAngle.
Si se establece un valor positivo, el arco se dibuja en el sentido de las agujas del reloj. Si se establece un valor negativo, el arco se dibuja en sentido contrario a las agujas del reloj.
El valor por defecto es 360.
© 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.