EllipseShape QML Type

Un componente de forma que puede representar una elipse, un arco o una porción de tarta. Más...

• Lista de todos los miembros, incluidos los heredados

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 pinta una elipse, que puede personalizarse para que aparezca como una elipse completa, un arco o un trozo de tarta relleno. Su aspecto se controla mediante las propiedades startAngle y sweepAngle.

Elipse básica

Por defecto, el elemento muestra una elipse completa. El interior se rellena con la propiedad fillColor, y el contorno se dibuja según las propiedades strokeColor, strokeWidth, y strokeStyle.

Arco y sectores circulares

Para crear un arco o una porción de tarta, establezca las propiedades startAngle (0-360 grados) y sweepAngle (0-360 grados) para definir el segmento de la elipse a dibujar.

Modo Arco: Para crear un arco simple (sólo el contorno), establezca fillColor en "transparent". El estilo de línea del arco puede personalizarse con dashPattern y dashOffset.

Modo Tarta: Para crear una porción de tarta rellena (un segmento conectado al centro), simplemente ajuste fillColor. El contorno de la porción también será trazado.

Modo Donut: Para crear un anillo de donut (una elipse hueca), ajuste innerArcRatio a un valor entre 0,0 y 1,0. Esto define la proporción de la elipse interior. 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 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 fillGradient. Si se especifica 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 estableciendo las propiedades strokeColor y strokeWidth. Si el color es transparent, se crea un borde sin color de relleno.

La elipse puede dibujarse con esquinas redondeadas utilizando la propiedad cornerRadius. El valor por defecto de cornerRadius es de 10 grados.

El valor por defecto de EllipseShape para QtQuick.Shapes::Shape::preferredRendererType 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 borde de la elipse.

Este es el valor por defecto.

Véase también strokeWidth.

capStyle : enumeration

Esta propiedad define cómo se dibujan los puntos finales de las líneas. El valor por defecto es ShapePath.SquareCap.

cornerRadius : real

Controla el redondeo de las esquinas donde las líneas radiales se encuentran con los arcos elípticos. En los segmentos de tarta, redondea la conexión con el arco exterior. En los segmentos de rosquilla, también redondea las conexiones con los arcos interior y exterior.

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".

fillGradient : ShapeGradient

El fillGradient del color de relleno de la elipse.

Por defecto, no se activa fillGradient y el valor es null. 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.

fillRule : enumeration

Esta propiedad contiene la regla de relleno. El valor por defecto es ShapePath.OddEvenFill. Para una explicación de las reglas de relleno, véase QPainterPath::setFillRule().

innerArcRatio : real

Esta propiedad define la relación entre los arcos interior y exterior.

El rango de valores está entre 0.0 y 1.0. Establecer el valor a 0.0 hará que el arco interior se colapse hacia el centro, dibujando una elipse sólida rellena. Establecer el valor a 1.0 hace que el arco interior tenga el mismo tamaño que la elipse exterior, resultando sólo un arco. Los valores entre 0,0 y 1,0 crean anillos elípticos huecos.

El valor por defecto 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.

startAngle : real

La propiedad define el ángulo inicial en grados desde el que comenzar a dibujar la elipse.

0 grados apunta a la parte superior. El ángulo aumenta en el sentido de las agujas del reloj.

El valor por defecto es 0.

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.

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.

sweepAngle : real

La extensión angular en grados que se dibujará desde startAngle.

Si el valor es positivo, el arco se dibuja en el sentido de las agujas del reloj. Si el valor es negativo, el arco se dibuja en el sentido contrario a las agujas del reloj.

El valor por defecto es 360.