QPieSeries Class
La clase QPieSeries muestra datos en gráficos circulares. Más información...
| Header: | #include <QPieSeries> |
| In QML: | PieSeries |
| Inherits: | QAbstractSeries |
| Status: | Deprecated |
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
Propiedades
|
|
Funciones públicas
| QPieSeries(QObject *parent = nullptr) | |
| virtual | ~QPieSeries() |
| bool | append(QPieSlice *slice) |
| bool | append(const QList<QPieSlice *> &slices) |
| QPieSlice * | append(const QString &label, qreal value) |
| void | clear() |
| int | count() const |
| qreal | holeSize() const |
| qreal | horizontalPosition() const |
| bool | insert(int index, QPieSlice *slice) |
| bool | isEmpty() const |
| qreal | pieEndAngle() const |
| qreal | pieSize() const |
| qreal | pieStartAngle() const |
| bool | remove(QPieSlice *slice) |
| void | setHoleSize(qreal holeSize) |
| void | setHorizontalPosition(qreal relativePosition) |
| void | setLabelsPosition(QPieSlice::LabelPosition position) |
| void | setLabelsVisible(bool visible = true) |
| void | setPieEndAngle(qreal angle) |
| void | setPieSize(qreal relativeSize) |
| void | setPieStartAngle(qreal startAngle) |
| void | setVerticalPosition(qreal relativePosition) |
| QList<QPieSlice *> | slices() const |
| qreal | sum() const |
| bool | take(QPieSlice *slice) |
| qreal | verticalPosition() const |
| QPieSeries & | operator<<(QPieSlice *slice) |
Funciones públicas reimplementadas
| virtual QAbstractSeries::SeriesType | type() const override |
Señales
| void | added(const QList<QPieSlice *> &slices) |
| void | clicked(QPieSlice *slice) |
| void | countChanged() |
| void | doubleClicked(QPieSlice *slice) |
| void | hovered(QPieSlice *slice, bool state) |
| void | pressed(QPieSlice *slice) |
| void | released(QPieSlice *slice) |
| void | removed(const QList<QPieSlice *> &slices) |
| void | sumChanged() |
Descripción detallada
Una serie de gráfico circular está formada por porciones definidas como objetos ` QPieSlice `. Las porciones pueden tener cualquier valor, ya que el objeto `QPieSeries` 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.
Consulta la galería «Gráficos con widgets » para aprender a utilizar QPieSeries.


Véase también QPieSlice y QChart.
Documentación de propiedades
[read-only] count : int
Esta propiedad contiene el número de segmentos de la serie.
Funciones de acceso:
| int | count() const |
Señal de notificación:
| void | countChanged() |
endAngle : qreal
Esta propiedad indica el ángulo final del sector circular.
Un círculo completo mide 360 grados, donde 0 grados corresponde a las 12 en punto.
El valor por defecto es 360.
Funciones de acceso:
| qreal | pieEndAngle() const |
| void | setPieEndAngle(qreal angle) |
holeSize : qreal
Esta propiedad indica 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 (un gráfico circular completo sin agujero).
- 1,0 es el tamaño máximo que cabe en el gráfico (el gráfico de donut 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.
Funciones de Access:
| qreal | holeSize() const |
| void | setHoleSize(qreal holeSize) |
horizontalPosition : qreal
Esta propiedad determina 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 la posición más a la derecha.
El valor por defecto es 0,5 (centro).
Funciones de acceso:
| qreal | horizontalPosition() const |
| void | setHorizontalPosition(qreal relativePosition) |
Véase también verticalPosition.
size : qreal
Esta propiedad indica 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 configurar esta propiedad, se ajusta la propiedad « holeSize » si es necesario, para garantizar que el tamaño del hueco no sea mayor que el del gráfico circular.
El valor por defecto es 0,7.
Funciones de Access:
| qreal | pieSize() const |
| void | setPieSize(qreal relativeSize) |
startAngle : qreal
Esta propiedad contiene el ángulo inicial del sector circular.
Un gráfico circular completo tiene 360 grados, donde 0 grados corresponde a las 12 en punto.
El valor por defecto es 0.
Funciones de acceso:
| qreal | pieStartAngle() const |
| void | setPieStartAngle(qreal startAngle) |
[read-only] sum : qreal
Esta propiedad contiene la suma de todas las partes.
La serie lleva la cuenta de la suma de todas las secciones que contiene.
Funciones de acceso:
| qreal | sum() const |
Señal de notificación:
| void | sumChanged() |
verticalPosition : qreal
Esta propiedad determina 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).
Funciones de acceso:
| qreal | verticalPosition() const |
| void | setVerticalPosition(qreal relativePosition) |
Véase también horizontalPosition.
Documentación de funciones de miembro
[explicit] QPieSeries::QPieSeries(QObject *parent = nullptr)
Crea un objeto de la serie que es un elemento secundario de parent.
[virtual noexcept] QPieSeries::~QPieSeries()
Elimina la serie de gráficos circulares y sus sectores.
[signal] void QPieSeries::added(const QList<QPieSlice *> &slices)
Esta señal se emite cuando los cortes especificados en slices se añaden a la serie.
Véanse también append() y insert().
bool QPieSeries::append(QPieSlice *slice)
Añade el fragmento especificado por ` slice ` a la serie. La propiedad del fragmento se transfiere a la serie.
Devuelve ` true ` si la inserción se realiza correctamente.
bool QPieSeries::append(const QList<QPieSlice *> &slices)
Añade a la serie el conjunto de segmentos especificado por ` slices `. La propiedad de los segmentos se transfiere a la serie.
Devuelve ` true ` si la adición se realiza correctamente.
QPieSlice *QPieSeries::append(const QString &label, qreal value)
Añade un único segmento con los valores especificados en « value » y « label » a la serie. La propiedad del segmento se transfiere a la serie. Devuelve «null» si « value » es « NaN », « Inf » o « -Inf », y no añade nada a la serie.
void QPieSeries::clear()
Elimina todas las secciones de la serie.
[signal] void QPieSeries::clicked(QPieSlice *slice)
Esta señal se emite al hacer clic en el corte especificado por slice.
Véase también QPieSlice::clicked().
int QPieSeries::count() const
Devuelve el número de segmentos de esta serie.
Nota: Funcióngetter para la propiedad «count».
[signal] void QPieSeries::countChanged()
Esta señal se emite cuando cambia el número de segmentos.
Nota: Señalde notificación para la propiedad count.
Véase también count.
[signal] void QPieSeries::doubleClicked(QPieSlice *slice)
Esta señal se emite al hacer doble clic en el corte especificado por slice.
Véase también QPieSlice::doubleClicked().
[signal] void QPieSeries::hovered(QPieSlice *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.
Véase también QPieSlice::hovered().
bool QPieSeries::insert(int index, QPieSlice *slice)
Inserta el segmento especificado por slice en la serie, antes del segmento situado en la posición especificada por index. La propiedad del segmento se transfiere a la serie.
Devuelve true si la inserción se realiza correctamente.
bool QPieSeries::isEmpty() const
Devuelve ` true ` si la serie está vacía.
qreal QPieSeries::pieEndAngle() const
Devuelve el ángulo final del sector circular.
Un círculo completo mide 360 grados, donde 0 grados corresponde a las 12 en punto.
Nota: Funcióngetter para la propiedad endAngle.
Véase también setPieEndAngle(), pieStartAngle() y setPieStartAngle().
[signal] void QPieSeries::pressed(QPieSlice *slice)
Esta señal se emite cuando el usuario hace clic en la sección especificada por « slice » y mantiene pulsado el botón del ratón.
Véase también QPieSlice::pressed().
[signal] void QPieSeries::released(QPieSlice *slice)
Esta señal se emite cuando el usuario suelta el botón del ratón sobre el corte especificado por slice.
Véase también QPieSlice::released().
bool QPieSeries::remove(QPieSlice *slice)
Elimina una sola porción, especificada mediante ` slice`, de la serie y la borra de forma permanente.
No se puede hacer referencia al puntero tras esta llamada.
Devuelve ` true ` si la eliminación se realiza correctamente.
[signal] void QPieSeries::removed(const QList<QPieSlice *> &slices)
Esta señal se emite cuando los cortes especificados en « slices » se eliminan de la serie.
Véase también remove().
void QPieSeries::setLabelsPosition(QPieSlice::LabelPosition position)
Establece la posición de todas las etiquetas de los segmentos en position.
Nota: Esta función solo afecta a los segmentos actuales de la serie. Si se añade un nuevo segmento, la posición predeterminada de la etiqueta es QPieSlice::LabelOutside.
Véase también QPieSlice::labelPosition() y QPieSlice::setLabelPosition().
void QPieSeries::setLabelsVisible(bool visible = true)
Establece la visibilidad de todas las etiquetas de los segmentos en « visible ».
Nota: Esta función solo afecta a los segmentos actuales de la serie. Si se añade un nuevo segmento, la visibilidad predeterminada de la etiqueta es « false ».
Véase también « QPieSlice::isLabelVisible()» y « QPieSlice::setLabelVisible()».
void QPieSeries::setPieEndAngle(qreal angle)
Establece el ángulo final del sector circular.
Un círculo completo mide 360 grados, donde 0 grados corresponde a las 12 en punto.
angle Debe ser mayor que el ángulo inicial.
Nota: Funciónde asignación para la propiedad endAngle.
Véase también pieEndAngle(), pieStartAngle() y setPieStartAngle().
QList<QPieSlice *> QPieSeries::slices() const
Devuelve una lista de segmentos que pertenecen a esta serie.
qreal QPieSeries::sum() const
Devuelve la suma de todos los valores de los segmentos de esta serie.
Nota: Funcióngetter para la propiedad sum.
Véase también QPieSlice::value(), QPieSlice::setValue() y QPieSlice::percentage().
[signal] void QPieSeries::sumChanged()
Esta señal se emite cuando cambia la suma de todos los segmentos.
Nota: Señalde notificación para la propiedad sum.
Véase también sum.
bool QPieSeries::take(QPieSlice *slice)
Extrae una única sección, especificada mediante ` slice`, de la serie. No elimina el objeto de sección.
Nota: La serie sigue siendo el objeto padre del segmento. Debes establecer el objeto padre para que asuma la propiedad total.
Devuelve ` true ` si la operación de extracción se ha realizado correctamente.
[override virtual] QAbstractSeries::SeriesType QPieSeries::type() const
Reimplementa una función de acceso para la propiedad: QAbstractSeries::type.
Devuelve el tipo de la serie.
QPieSeries &QPieSeries::operator<<(QPieSlice *slice)
Añade el fragmento especificado por « slice » a la serie y devuelve una referencia a la misma. La propiedad del fragmento se transfiere a la serie.
© 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.