En esta página

PieSeries QML Type

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

Import Statement: import QtCharts 2.12
In C++: QPieSeries
Inherits:

AbstractSeries

Status: Deprecated

Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

Señales

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 circular está formada por porciones que se definen mediante 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 del gráfico circular en el gráfico se controlan mediante valores relativos que oscilan entre 0,0 y 1,0. Estos valores se refieren al rectángulo real del gráfico.

Por defecto, el gráfico circular se define como un gráfico completo. Se puede crear un gráfico circular parcial estableciendo un ángulo inicial y un intervalo de ángulos para la serie. Un gráfico circular completo es de 360 grados, donde 0 corresponde a las 12 en punto.

El siguiente ejemplo de QML muestra cómo crear un gráfico circular sencillo.

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;
    }
}

Gráfico circular con las cuotas de mercado de las cinco principales marcas de coches en Finlandia, en el que la sección «Otros» representa aproximadamente la mitad


Véase también PieSlice y ChartView.

Documentación de propiedades

count : int [read-only]

El número de secciones de la serie.

endAngle : real

El ángulo final del círculo.

Un círculo completo mide 360 grados, donde 0 grados corresponde a las 12 en punto.

El valor por defecto es 360.

holeSize : real

El tamaño del «agujero de la rosquilla».

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 cabe en el gráfico (el gráfico de anillo no tiene anchura).

Al establecer esta propiedad, la propiedad « size » se ajusta si es necesario, para garantizar que el tamaño del agujero no sea mayor que el del gráfico circular.

El valor por defecto es 0,0.

horizontalPosition : real

La posición horizontal del gráfico circular.

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

  • 0,0 es el extremo izquierdo absoluto.
  • 1,0 es el extremo derecho absoluto.

El valor por defecto es 0,5 (centro).

Véase también verticalPosition.

size : real

El tamaño del gráfico circular.

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

  • 0,0 es el tamaño mínimo (el gráfico circular no se dibuja).
  • 1,0 es el tamaño máximo que cabe en el gráfico.

Al establecer esta propiedad, la propiedad « holeSize » se ajusta si es necesario, para garantizar que el tamaño del agujero no sea mayor que el tamaño del gráfico circular.

El valor por defecto es 0,7.

startAngle : real

El ángulo inicial del círculo.

Un círculo completo mide 360 grados, donde 0 grados corresponde a las 12 en punto.

El valor por defecto es 0.

sum : real [read-only]

La suma de todas las porciones.

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

verticalPosition : real

La posición vertical del gráfico circular.

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 Signal

added(list<PieSlice> slices)

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

El controlador de señales correspondiente es ` onAdded`.

Nota: El controlador correspondiente es onAdded.

clicked(PieSlice slice)

Esta señal se emite al hacer clic en la sección especificada por slice.

El controlador de señales correspondiente es onClicked.

Nota: El controlador correspondiente es onClicked.

doubleClicked(PieSlice slice)

Esta señal se emite al hacer doble clic en la sección especificada por « slice ».

El controlador de señal correspondiente es onDoubleClicked.

Nota: El controlador correspondiente es onDoubleClicked.

hovered(PieSlice slice, bool state)

Esta señal se emite cuando se pasa el ratón por encima del corte especificado en slice. Cuando el ratón se desplaza sobre el corte, state cambia a true, y cuando el ratón se aleja de nuevo, cambia a false.

El controlador de señal correspondiente es onHovered.

Nota: El controlador correspondiente es onHovered.

pressed(PieSlice slice)

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

El controlador de señal correspondiente es onPressed.

Nota: El controlador correspondiente es onPressed.

released(PieSlice slice)

Esta señal se emite cuando el usuario suelta el botón del ratón sobre el segmento especificado por slice.

El controlador de señal correspondiente es onReleased.

Nota: El controlador correspondiente es onReleased.

removed(list<PieSlice> slices)

Esta señal se emite cuando los cortes especificados en « slices » se eliminan de la serie.

El controlador de señales correspondiente es onRemoved.

Nota: El controlador correspondiente es onRemoved.

sliceAdded(PieSlice slice)

Esta señal se emite cuando la sección especificada por slice se añade a la serie.

El gestor de señales correspondiente es onSliceAdded.

Nota: El controlador correspondiente es onSliceAdded.

sliceRemoved(PieSlice slice)

Esta señal se emite cuando el segmento especificado por slice se elimina de la serie.

El controlador de señales correspondiente es onSliceRemoved.

Nota: El controlador correspondiente es onSliceRemoved.

Documentación del método

PieSlice append(string label, real value)

Añade una nueva porción al gráfico circular con la etiqueta « label » y el valor « value ».

PieSlice at(int index)

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

void clear()

Elimina todas las porciones del pastel.

PieSlice find(string label)

Devuelve la primera sección que tenga la etiqueta « label ». Devuelve «null» si no se encuentra la etiqueta.

bool remove(PieSlice slice)

Elimina del gráfico circular la porción especificada por ` slice `. Devuelve ` true ` si la eliminación se ha realizado correctamente y ` false ` en caso contrario.

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