PieSlice QML Type

Representa una única porción de una serie de tartas. Más...

• Lista de todos los miembros, incluyendo los heredados
• PieSlice es parte de Qt Graphs QML Types for 2D.

Propiedades

• angleSpan : real
• borderColor : color
• borderWidth : real
• color : color
• explodeDistanceFactor : real
• exploded : bool
• label : string
• labelArmLengthFactor : real
• labelColor : color
• labelFont : font
• labelPosition : enumeration
• labelVisible : bool
• percentage : real
• startAngle : real
• subSlicesCount : int
• subSlicesSum : real
• value : real

Señales

• angleSpanChanged()
• borderColorChanged()
• borderWidthChanged()
• colorChanged()
• explodeDistanceFactorChanged()
• explodedChanged()
• labelArmLengthFactorChanged()
• labelChanged()
• labelColorChanged()
• labelFontChanged()
• labelFontChanged()
• labelPositionChanged()
• labelVisibleChanged()
• percentageChanged()
• startAngleChanged()
• subSlicesAdded(list<PieSlice> slices)
• subSlicesCountChanged(qsizetype count)
• subSlicesRemoved(list<PieSlice> slices)
• subSlicesSumChanged(qreal sum)
• valueChanged()

Métodos

• PieSlice append(string label, real value)
• PieSlice at(int index)
• void clear()
• PieSlice find(string label)
• bool remove(PieSlice slice)
• bool remove(int index)
• void removeMultiple(int index, int count)
• bool replace(PieSlice oldSlice, PieSlice newSlice)
• bool replace(int index, PieSlice slice)
• bool replaceAll(list<PieSlice> slices)
• bool take(PieSlice slice)

Descripción detallada

Una porción de tarta tiene un valor y una etiqueta. Cuando la porción se añade a una serie de tarta, el tipo PieSeries calcula el porcentaje de la porción comparado con la suma de todas las porciones de la serie para determinar el tamaño real de la porción en el gráfico.

Por defecto, la etiqueta está oculta. Si es visible, puede estar situada fuera de la rebanada y conectada a ella con un brazo o centrada dentro de la rebanada horizontalmente o en paralelo con la tangencial o la normal del arco de la rebanada.

Por defecto, el aspecto visual de la rebanada se establece mediante un tema, pero éste puede anularse especificando las propiedades de la rebanada. Sin embargo, si se cambia el tema después de personalizar las rebanadas, se perderá toda la personalización.

El tipo PieSlice debe utilizarse como hijo de un tipo PieSeries. Por ejemplo:

PieSeries {
    PieSlice {
        label: "example"
        value: 1
    }
}

Alternativamente, se pueden añadir rodajas a una serie de tartas utilizando el método PieSeries.append().

En ese caso, se puede utilizar PieSeries.at() o PieSeries.find() para acceder a las propiedades de una instancia PieSlice individual.

Una porción de tarta puede contener porciones secundarias.

PieSeries {
    PieSlice {
        label: "example"
        value: 1
        color: "orange"
        exploded: true
        PieSlice {
            label: "example2"
            value: 2
            color: "red"
        }
        PieSlice {
            label: "example3"
            value: 3
            color: "yellow"
            exploded: true
        }
    }
    PieSlice {
        label: "example4"
        value: 4
        color: "green"
    }
}

Véase también PieSeries.

Documentación de propiedades

angleSpan : real [read-only]

La amplitud de la rebanada en grados. Una tarta completa tiene 360 grados, donde 0 grados está a las 12 en punto. Se actualiza automáticamente cuando la porción se añade a la serie.

borderColor : color

El color utilizado para dibujar el borde de la rebanada.

Véase también borderWidth.

borderWidth : real

La anchura del borde del corte. Esta propiedad permite modificar la anchura del borde del corte.

Véase también borderColor.

color : color

El color de relleno de la rebanada.

explodeDistanceFactor : real

Determina a qué distancia de la tarta explota la rebanada.

• 1.0 significa que la distancia es igual al radio.
• 0.5 significa que la distancia es la mitad del radio.

Por defecto, la distancia es 0.15

Véase también exploded.

exploded : bool

Si la rebanada está separada del pastel.

Véase también explodeDistanceFactor.

label : string

La etiqueta de la rebanada.

labelArmLengthFactor : real

La longitud del brazo de la etiqueta. El factor es relativo al radio de la tarta. Por ejemplo

• 1,0 significa que la longitud es igual al radio.
• 0,5 significa que la longitud es la mitad del radio.

Por defecto, la longitud del brazo es 0,15.

Véase también labelVisible.

labelColor : color

El color utilizado para dibujar la etiqueta de la rebanada.

labelFont : font

La fuente utilizada para la etiqueta de la rebanada.

Para más información, véase font.

Véase también labelVisible y labelPosition.

labelPosition : enumeration

Describe la posición de la etiqueta del corte.

Véase también labelVisible.

labelVisible : bool

La visibilidad de la etiqueta de la rebanada. Por defecto, la etiqueta no es visible.

percentage : real [read-only]

Porcentaje del corte respecto a la suma de todos los cortes de la serie. El valor real oscila entre 0,0 y 1,0. Se actualiza automáticamente una vez que el corte se añade a la serie.

startAngle : real [read-only]

El ángulo inicial de esta rebanada en la serie a la que pertenece. Una tarta completa tiene 360 grados, donde 0 grados está a las 12 en punto. Se actualiza automáticamente cuando la porción se añade a la serie.

subSlicesCount : int [read-only]

Número de subcortes del corte.

subSlicesSum : real [read-only]

La suma de todas las subcortes.

El corte lleva la cuenta de la suma de todos los subcortes que contiene.

value : real

El valor del corte.

Documentación de señales

angleSpanChanged()

Esta señal se emite cuando cambia el ángulo de la rebanada.

Véase también angleSpan.

borderColorChanged()

Esta señal se emite cuando cambia el color del borde del corte.

Véase también borderColor.

borderWidthChanged()

Esta señal se emite cuando cambia el ancho del borde del corte.

Véase también borderWidth.

colorChanged()

Esta señal se emite cuando cambia el color del corte.

explodeDistanceFactorChanged()

Esta señal se emite cuando cambia el factor de distancia de explosión.

Véase también explodeDistanceFactor.

explodedChanged()

Esta señal se emite cuando cambia la propiedad explotada.

Véase también exploded.

labelArmLengthFactorChanged()

Esta señal se emite cuando cambia el factor de longitud del brazo de la etiqueta.

Véase también labelArmLengthFactor.

labelChanged()

Esta señal se emite cuando cambia la etiqueta del corte.

Véase también label.

labelColorChanged()

Esta señal se emite cuando cambia el color de la etiqueta del corte.

Véase también labelColor.

labelFontChanged()

Esta señal se emite cuando cambia la fuente de la etiqueta de la rebanada.

Véase también labelFont.

labelFontChanged()

Esta señal se emite cuando cambia la fuente de la etiqueta.

Véase también labelFont.

labelPositionChanged()

Esta señal se emite cuando cambia la posición de la etiqueta.

Véase también labelPosition.

labelVisibleChanged()

Esta señal se emite cuando cambia la visibilidad de la etiqueta del corte.

Véase también labelVisible.

percentageChanged()

Esta señal se emite cuando cambia el porcentaje de la rebanada.

Véase también percentage.

startAngleChanged()

Esta señal se emite cuando cambia el ángulo inicial del corte.

Véase también startAngle.

subSlicesAdded(list<PieSlice> slices)

Esta señal se emite cuando los subcortes especificados por slices se añaden al corte.

subSlicesCountChanged(qsizetype count)

Esta señal se emite cuando cambia el subcorte count.

Véase también subSlicesCount.

subSlicesRemoved(list<PieSlice> slices)

Esta señal se emite cuando las subdivisiones especificadas por slices se eliminan de la subdivisión.

subSlicesSumChanged(qreal sum)

Esta señal se emite cuando cambia la sum de todos los subcortes.

Véase también subSlicesSum.

valueChanged()

Esta señal se emite cuando cambia el valor del corte.

Véase también value.

Documentación del método

PieSlice append(string label, real value)

Añade un nuevo subcorte con la etiqueta label y el valor value al corte.

PieSlice at(int index)

Devuelve la subcorta en la posición especificada por index. Devuelve null si el índice no es válido.

void clear()

Elimina todas las subcortes del corte.

PieSlice find(string label)

Devuelve la primera subcorta que tiene la etiqueta label. Devuelve null si no se encuentra la etiqueta.

bool remove(PieSlice slice)

Elimina la subdivisión especificada por slice de la subdivisión. Devuelve true si la eliminación se ha realizado correctamente, false en caso contrario.

bool remove(int index)

Elimina la subdivisión especificada por index de la subdivisión. Devuelve true si la eliminación se ha realizado correctamente, false en caso contrario.

void removeMultiple(int index, int count)

Elimina un intervalo de subcortes especificado en index y count. La llamada recorre todas las subdivisiones aunque falle la eliminación de una.

bool replace(PieSlice oldSlice, PieSlice newSlice)

Sustituye la subfragmentación especificada por oldSlice por newSlice. Devuelve true si la sustitución se ha realizado correctamente, false en caso contrario. oldSlice se destruye si la sustitución se ha realizado correctamente.

bool replace(int index, PieSlice slice)

Reemplaza la subfragmentación especificada por slice a partir de la que se encuentra en index. Devuelve true si la sustitución se ha realizado correctamente, false en caso contrario.

bool replaceAll(list<PieSlice> slices)

Sustituye completamente todos los subcortes actuales por slices. No es necesario que el tamaño coincida. Devuelve false si alguno de los PieSlice en slices no es válido.

bool take(PieSlice slice)

Toma una única subfragmentación, especificada por slice, de la segmentación. No borra el objeto sub slice. Devuelve true si tiene éxito.