PieSeries QML Type

Presenta los datos en gráficos circulares. Más...

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

Propiedades

• angleSpanLabelVisibility : enumeration (since 6.10)
• angleSpanVisibleLimit : real (since 6.10)
• count : int
• endAngle : real
• holeSize : real
• horizontalPosition : real
• pieSize : real
• startAngle : real
• sum : real
• verticalPosition : real

Señales

• added(list<PieSlice> slices)
• angleSpanLabelVisibilityChanged(LabelVisibility visibility) (since 6.10)
• angleSpanVisibleLimitChanged(real limit) (since 6.10)
• clicked(PieSlice slice)
• countChanged()
• doubleClicked(PieSlice slice)
• endAngleChanged()
• holeSizeChanged()
• horizontalPositionChanged()
• pieSizeChanged()
• pressed(PieSlice slice)
• released(PieSlice slice)
• removed(list<PieSlice> slices)
• startAngleChanged()
• sumChanged()
• verticalPositionChanged()

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(list<PieSlice> slices)
• bool replace(PieSlice oldSlice, PieSlice newSlice)
• bool replace(int index, PieSlice slice)
• bool take(PieSlice slice)

Descripción detallada

Una serie de tarta consiste en porciones que se definen utilizando el tipo PieSlice. Las porciones pueden tener cualquier valor, ya que el tipo PieSeries calcula el porcentaje de una porción en comparación con la suma de todas las porciones de la serie para determinar el tamaño real de la porción en el gráfico.

El tamaño de la tarta y su posición en el gráfico se controlan mediante valores relativos que van de 0,0 a 1,0. Estos valores se refieren al rectángulo real del gráfico. Estos valores se refieren al rectángulo real del gráfico.

Por defecto, la tarta se define como una tarta completa. Se puede crear una tarta parcial estableciendo un ángulo inicial y un intervalo de ángulos para la serie. Una tarta completa tiene 360 grados, donde 0 está a las 12 en punto.

El siguiente ejemplo QML muestra cómo crear un gráfico de tarta simple.

import QtQuick
import QtGraphs

Item {
    id: mainView
    width: 1280
    height: 720

    GraphsView {
        anchors.fill: parent
        theme: GraphsTheme {
             colorScheme: GraphsTheme.ColorScheme.Dark
             theme: GraphsTheme.Theme.QtGreen
        }
        PieSeries {
            id: pieSeries
            PieSlice {
                value: 1
            }
            PieSlice {
                value: 2
            }
        }
    }
}

Véase también PieSlice y GraphsView.

Documentación de propiedades

angleSpanLabelVisibility : enumeration [since 6.10]

Modo de visibilidad de las etiquetas.

El modo que determina qué etiquetas se ocultarán si están por debajo del límite de ángulo establecido con angleSpanVisibleLimit. No tiene efecto si no se ha establecido angleSpanVisibleLimit.

Esta propiedad se introdujo en Qt 6.10.

Véase también angleSpanVisibleLimit.

angleSpanVisibleLimit : real [since 6.10]

Límite de ángulo para la visibilidad de la etiqueta.

El intervalo angular que se utilizará como límite de visibilidad para la etiqueta de una rebanada. Una rebanada con un ángulo inferior a este valor cambiará su visibilidad en función de angleSpanLabelVisibility establecido en la serie. El valor por defecto es 0, lo que significa que no se ocultará ninguna rebanada independientemente de angleSpanLabelVisibility.

Esta propiedad se introdujo en Qt 6.10.

Véase también angleSpanLabelVisibility.

count : int [read-only]

El número de rodajas de la serie.

endAngle : real

El ángulo final de la tarta.

Un pastel completo tiene 360 grados, donde 0 grados está a las 12 en punto.

El valor por defecto es 360.

holeSize : real

El tamaño del agujero del donut.

Cuando se establece la propiedad pieSize, esta propiedad se ajusta si es necesario, para asegurar que el tamaño del agujero no es mayor que el tamaño de la tarta.

El valor por defecto es 0.0.

horizontalPosition : real

La posición horizontal de la tarta.

El valor es relativo al rectángulo del gráfico, de modo que:

• 0.0 es la izquierda absoluta.
• 1.0 es la derecha absoluta.

El valor por defecto es 0.5 (centro).

Véase también verticalPosition.

pieSize : real

El tamaño de la tarta.

El valor es relativo al rectángulo del gráfico, de modo que:

• 0.0 es el pieSize mínimo (pastel no dibujado).
• 1.0 es el pieSize máximo que puede caber en el gráfico.

Cuando se establece esta propiedad, la propiedad holeSize se ajusta si es necesario, para asegurar que el tamaño del agujero no es mayor que el tamaño de la tarta.

El valor por defecto es 0.7.

startAngle : real

El ángulo inicial de la tarta.

Un pastel completo tiene 360 grados, donde 0 grados está a las 12 en punto.

El valor por defecto es 0.

sum : real [read-only]

La suma de todos los cortes.

La serie lleva la cuenta de la suma de todas las rodajas que contiene.

verticalPosition : real

La posición vertical de la tarta.

El valor es relativo al rectángulo del gráfico, de modo que:

• 0.0 es la parte superior absoluta.
• 1.0 es la parte inferior absoluta.

El valor por defecto es 0.5 (centro).

Véase también horizontalPosition.

Documentación de señales

added(list<PieSlice> slices)

Esta señal se emite cuando los cortes especificados por slices se añaden a la serie.

[since 6.10] angleSpanLabelVisibilityChanged(LabelVisibility visibility)

Esta señal se emite cuando se ha cambiado el modo visible del límite de ángulo. El parámetro visibility contiene el nuevo modo visible.

Esta señal se introdujo en Qt 6.10.

[since 6.10] angleSpanVisibleLimitChanged(real limit)

Esta señal se emite cuando se ha modificado el límite del intervalo angular. El parámetro limit contiene el nuevo límite.

Esta señal se introdujo en Qt 6.10.

clicked(PieSlice slice)

Esta señal se emite cuando se hace clic o se toca slice.

countChanged()

Esta señal se emite cuando cambia el recuento de trozos.

Véase también count.

doubleClicked(PieSlice slice)

Esta señal se emite cuando se hace doble clic o se pulsa dos veces en slice. Esta señal siempre se produce después de clicked.

endAngleChanged()

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

Véase también endAngle.

holeSizeChanged()

Esta señal se emite cuando cambia el tamaño del agujero del donut.

Véase también holeSize.

horizontalPositionChanged()

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

Véase también horizontalPosition.

pieSizeChanged()

Esta señal se emite cuando cambia el tamaño de la tarta.

Véase también pieSize.

pressed(PieSlice slice)

Esta señal se emite cuando el usuario hace clic o toca slice y mantiene pulsado el botón o el gesto del ratón.

released(PieSlice slice)

Esta señal se emite cuando el usuario suelta un botón o gesto del ratón previamente pulsado en slice.

removed(list<PieSlice> slices)

Esta señal se emite cuando los cortes especificados por slices se eliminan de la serie.

startAngleChanged()

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

Véase también startAngle.

sumChanged()

Esta señal se emite cuando cambia la suma de todas las rebanadas.

Véase también sum.

verticalPositionChanged()

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

Véase también verticalPosition.

Documentación del método

PieSlice append(string label, real value)

Añade una nueva rebanada con la etiqueta label y el valor value a la tarta.

PieSlice at(int index)

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

void clear()

Elimina todas las rebanadas del pastel.

PieSlice find(string label)

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

bool remove(PieSlice slice)

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

bool remove(int index)

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

void removeMultiple(int index, int count)

Elimina un intervalo de rebanadas especificado en index y count. La llamada recorre todas las rebanadas incluso si falla la eliminación de una.

bool replace(list<PieSlice> slices)

Sustituye completamente todas las rodajas 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 replace(PieSlice oldSlice, PieSlice newSlice)

Sustituye la rebanada especificada por oldSlice por newSlice. Devuelve true si la eliminación tuvo éxito, false en caso contrario. oldSlice se destruye si esto tiene éxito.

bool replace(int index, PieSlice slice)

Sustituye la porción especificada por slice de la tarta en index. Devuelve true si la sustitución se ha realizado correctamente, false en caso contrario.

bool take(PieSlice slice)

Toma una única rebanada, especificada por slice, de la serie. No borra el objeto slice. Devuelve true si tiene éxito.