En esta página

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.

Gráfico circular con un sector separado del resto y con la etiqueta «Joe»

Gráfico de rosquilla con la información nutricional del glaseado de limón, con porciones de proteínas, grasas, otros y carbohidratos; la porción de grasas aparece ampliada

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.