PieSeries QML Type
Muestra los datos en gráficos circulares. Más...
| Import Statement: | import QtCharts 2.12 |
| In C++: | QPieSeries |
| Inherits: | |
| Status: | Deprecated |
Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.
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 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;
}
}
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.