PieSeries QML Type

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

• Lista de todos los miembros, incluidos los heredados

Propiedades

• count : int
• endAngle : real
• holeSize : real
• horizontalPosition : real
• size : real
• startAngle : real
• sum : real
• verticalPosition : real

Señales

• added(list<PieSlice> slices)
• clicked(PieSlice slice)
• doubleClicked(PieSlice slice)
• hovered(PieSlice slice, bool state)
• pressed(PieSlice slice)
• released(PieSlice slice)
• removed(list<PieSlice> slices)
• sliceAdded(PieSlice slice)
• sliceRemoved(PieSlice slice)

Métodos

• PieSlice append(string label, real value)
• PieSlice at(int index)
• void clear()
• PieSlice find(string label)
• bool remove(PieSlice slice)

Descripción detallada

Una serie de tarta se compone de 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 y la posición de la tarta 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 circular simple.

ChartView {
    id: chart
    title: "Top-5 car brand shares in Finland"
    anchors.fill: parent
    legend.alignment: Qt.AlignBottom
    antialiasing: true

    property variant othersSlice: 0

    PieSeries {
        id: pieSeries
        PieSlice { label: "Volkswagen"; value: 13.5 }
        PieSlice { label: "Toyota"; value: 10.9 }
        PieSlice { label: "Ford"; value: 8.6 }
        PieSlice { label: "Skoda"; value: 8.2 }
        PieSlice { label: "Volvo"; value: 6.8 }
    }

    Component.onCompleted: {
        // You can also manipulate slices dynamically, like append a slice or set a slice exploded
        othersSlice = pieSeries.append("Others", 52.0);
        pieSeries.find("Volkswagen").exploded = true;
    }
}

Véase también PieSlice y ChartView.

Documentación de propiedades

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.

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

• 0.0 es el tamaño mínimo (tarta completa dibujada sin agujero).
• 1.0 es el tamaño máximo que puede tener el gráfico (el donut no tiene anchura).

Al establecer esta propiedad, la propiedad size 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.

size : real

El tamaño de la tarta.

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

• 0.0 es el tamaño mínimo (tarta no dibujada).
• 1.0 es el tamaño 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.

El manejador de señal correspondiente es onAdded.

clicked(PieSlice slice)

Esta señal se emite cuando se hace clic en la rebanada especificada por slice.

El manejador de señal correspondiente es onClicked.

doubleClicked(PieSlice slice)

Esta señal se emite cuando se hace doble clic en la rebanada especificada por slice.

El manejador de señal correspondiente es onDoubleClicked.

hovered(PieSlice slice, bool state)

Esta señal se emite cuando el ratón se sitúa sobre el segmento especificado por slice. Cuando el ratón se mueve sobre la sección, state se convierte en true, y cuando el ratón se aleja de nuevo, se convierte en false.

El controlador de señal correspondiente es onHovered.

pressed(PieSlice slice)

Esta señal se emite cuando el usuario hace clic en la rebanada especificada por slice y mantiene pulsado el botón del ratón.

El manejador de señal correspondiente es onPressed.

released(PieSlice slice)

Esta señal se emite cuando el usuario suelta el botón del ratón en la sección especificada por slice.

El manejador de señal correspondiente es onReleased.

removed(list<PieSlice> slices)

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

El manejador de señal correspondiente es onRemoved.

sliceAdded(PieSlice slice)

Esta señal se emite cuando la rebanada especificada por slice se añade a la serie.

El manejador de señal correspondiente es onSliceAdded.

sliceRemoved(PieSlice slice)

Esta señal se emite cuando la rebanada especificada por slice se elimina de la serie.

El manejador de señal correspondiente es onSliceRemoved.

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.