En esta página

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

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
    }

Elipse con un trozo en forma de porción de tarta recortado

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.

ConstanteDescripción
EllipseShape.InsideEl borde se dibuja a lo largo del borde interior del elemento y no afecta a la anchura del mismo.

Este es el valor predeterminado.

ConstanteDescripción
EllipseShape.MiddleEl borde se dibuja sobre el borde del elemento y no afecta a la anchura del mismo.
EllipseShape.OutsideEl 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 ».

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 este en la mitad del ancho de la línea.
ShapePath.RoundCapUn 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().

ConstanteDescripción
ShapePath.OddEvenFillRegla de relleno par-impar.
ShapePath.WindingFillRegla 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 ».

ConstanteDescripción
ShapePath.MiterJoinLos bordes exteriores de las líneas se prolongan 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.

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.

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