En esta página

QPieSeries Class

La clase QPieSeries muestra los datos en gráficos circulares. Más información...

Encabezado: #include <QPieSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
En QML: PieSeries
Heredan de: QAbstractSeries

Tipos públicos

(since 6.10) enum class LabelVisibility { None, First, Even, Odd }

Propiedades

Funciones públicas

QPieSeries(QObject *parent = nullptr)
QPieSeries::LabelVisibility angleSpanLabelVisibility() const
qreal angleSpanVisibleLimit() const
bool append(QPieSlice *slice)
bool append(const QList<QPieSlice *> &slices)
QPieSlice *append(const QString &label, qreal value)
QPieSlice *at(qsizetype index)
void clear()
qsizetype count() const
qreal endAngle() const
QPieSlice *find(const QString &label)
qreal holeSize() const
qreal horizontalPosition() const
bool insert(qsizetype index, QPieSlice *slice)
bool isEmpty() const
qreal pieSize() const
bool remove(QPieSlice *slice)
bool remove(qsizetype index)
void removeMultiple(qsizetype index, int count)
bool replace(const QList<QPieSlice *> &slices)
bool replace(QPieSlice *oldSlice, QPieSlice *newSlice)
bool replace(qsizetype index, QPieSlice *slice)
void setAngleSpanLabelVisibility(QPieSeries::LabelVisibility newAngleSpanVisibleMode)
void setAngleSpanVisibleLimit(qreal newAngleSpanVisibleLimit)
void setEndAngle(qreal angle)
void setHoleSize(qreal holeSize)
void setHorizontalPosition(qreal relativePosition)
void setLabelsPosition(QPieSlice::LabelPosition position)
void setLabelsVisible(bool visible)
void setPieSize(qreal relativeSize)
void setSliceData(const QList<qreal> &newSliceData)
void setSliceLabels(QStringList newLabels)
void setStartAngle(qreal angle)
void setVerticalPosition(qreal relativePosition)
QList<qreal> sliceData() const
const QStringList &sliceLabels() const &
QStringList sliceLabels() &&
QList<QPieSlice *> slices() const
qreal startAngle() 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 angleSpanLabelVisibilityChanged(QPieSeries::LabelVisibility visibility)
void angleSpanVisibleLimitChanged(qreal limit)
void countChanged()
void endAngleChanged()
void holeSizeChanged()
void horizontalPositionChanged()
void pieSizeChanged()
void removed(const QList<QPieSlice *> &slices)
void sliceDataChanged(const QList<qreal> &sliceData)
void sliceLabelsChanged(const QStringList &sliceLabels)
void startAngleChanged()
void sumChanged()
void verticalPositionChanged()

Descripción detallada

Una serie 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 del gráfico circular y su posición 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 abarca 360 grados, donde 0 corresponde a las 12 en punto.

Véase también QPieSlice.

Documentación sobre tipos de miembros

[since 6.10] enum class QPieSeries::LabelVisibility

El modo de visibilidad de las etiquetas.

ConstanteValorDescripción
QPieSeries::LabelVisibility::None0Se ocultarán todas las etiquetas de los cortes cuyo ángulo de extensión sea menor que el valor de « angleSpanVisibleLimit ».
QPieSeries::LabelVisibility::First1Se ocultarán todas las etiquetas, excepto la primera, de los cortes consecutivos con un ángulo de extensión menor que el « angleSpanVisibleLimit ». Este es el valor por defecto.
QPieSeries::LabelVisibility::Even2Se ocultarán las etiquetas alternas de los cortes consecutivos cuyo ángulo sea menor que el « angleSpanVisibleLimit », empezando por la segunda.
QPieSeries::LabelVisibility::Odd3Se ocultarán las etiquetas alternas de los cortes consecutivos cuyo ángulo sea menor que el de « angleSpanVisibleLimit », empezando por la primera.

Esta enumeración se introdujo en Qt 6.10.

Véase también « QPieSeries::angleSpanVisibleLimit ».

Documentación de la propiedad

[since 6.10] angleSpanLabelVisibility : LabelVisibility

Esta propiedad establece el modo de visibilidad de las etiquetas.

El modo que determina qué etiquetas se ocultarán si se encuentran por debajo del límite de ángulo establecido con « angleSpanVisibleLimit ». No tiene ningún efecto si no se ha establecido « angleSpanVisibleLimit ».

Esta enumeración se introdujo en Qt 6.10.

Funciones de acceso:

QPieSeries::LabelVisibility angleSpanLabelVisibility() const
void setAngleSpanLabelVisibility(QPieSeries::LabelVisibility newAngleSpanVisibleMode)

Señal de notificador:

void angleSpanLabelVisibilityChanged(QPieSeries::LabelVisibility visibility)

Véase también QPieSeries::angleSpanVisibleLimit.

[since 6.10] angleSpanVisibleLimit : qreal

Esta propiedad establece el límite de amplitud angular para la visibilidad de las etiquetas.

El intervalo angular que se utilizará como límite de visibilidad para una etiqueta de segmento. Un segmento con un intervalo angular inferior a este valor cambiará su visibilidad en función de la propiedad « angleSpanLabelVisibility » establecida para la serie. El valor por defecto es « 0 », lo que significa que no se ocultará ningún segmento, independientemente del valor de « angleSpanLabelVisibility ».

Esta enumeración se introdujo en Qt 6.10.

Funciones de acceso:

qreal angleSpanVisibleLimit() const
void setAngleSpanVisibleLimit(qreal newAngleSpanVisibleLimit)

Señal de notificador:

void angleSpanVisibleLimitChanged(qreal limit)

Véase también QPieSeries::angleSpanLabelVisibility.

[read-only] count : qsizetype

Esta propiedad contiene el número de segmentos de la serie.

Funciones de acceso:

qsizetype 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 endAngle() const
void setEndAngle(qreal angle)

Señal de notificación:

void endAngleChanged()

holeSize : qreal

Esta propiedad indica el tamaño del agujero de la rosquilla.

Al establecer la propiedad « pieSize », esta propiedad se ajusta si es necesario, para garantizar que el tamaño del agujero no sea mayor que el del pastel.

El valor por defecto es 0,0.

Funciones de acceso:

qreal holeSize() const
void setHoleSize(qreal holeSize)

Señal de notificación:

void holeSizeChanged()

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 derecha absoluta.

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

Funciones de acceso:

qreal horizontalPosition() const
void setHorizontalPosition(qreal relativePosition)

Señal de notificación:

void horizontalPositionChanged()

Véase también verticalPosition.

pieSize : 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 del gráfico circular (el gráfico circular no se dibuja).
  • 1,0 es el tamaño máximo del gráfico circular 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 hueco no sea mayor que el tamaño del gráfico circular.

El valor por defecto es 0,7.

Funciones de acceso:

qreal pieSize() const
void setPieSize(qreal relativeSize)

Señal de notificación:

void pieSizeChanged()

[since 6.12] sliceData : QList<qreal>

Valores declarativos de los segmentos.

Establece esta propiedad para crear sectores de gráfico circular de forma declarativa. La serie crea automáticamente un sector por cada valor. Las etiquetas se pueden proporcionar mediante sliceLabels.

Nota: No se admitela combinación de entradas de datos declarativas e imperativas.

Esta enumeración se introdujo en Qt 6.12.

Funciones de acceso:

QList<qreal> sliceData() const
void setSliceData(const QList<qreal> &newSliceData)

Señal de notificación:

void sliceDataChanged(const QList<qreal> &sliceData)

Véase también sliceLabels.

[since 6.12] sliceLabels : QStringList

Etiquetas declarativas de segmentos.

Proporciona etiquetas para los segmentos creados mediante sliceData. Las etiquetas deben seguir el mismo orden que los valores. Se ignoran las etiquetas adicionales que superen el número de segmentos.

Nota: No se admitela combinación de entradas de datos declarativas e imperativas.

Esta enumeración se introdujo en Qt 6.12.

Funciones de acceso:

const QStringList &sliceLabels() const &
QStringList sliceLabels() &&
void setSliceLabels(QStringList newLabels)

Señal de notificador:

void sliceLabelsChanged(const QStringList &sliceLabels)

Véase también sliceData.

startAngle : qreal

Esta propiedad contiene el ángulo inicial del sector circular.

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

El valor por defecto es 0.

Funciones de acceso:

qreal startAngle() const
void setStartAngle(qreal angle)

Señal de notificación:

void startAngleChanged()

[read-only] sum : qreal

Esta propiedad contiene la suma de todas las porciones.

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)

Señal de notificación:

void verticalPositionChanged()

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.

[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éase también append().

[invokable] 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 adición se realiza correctamente.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] bool QPieSeries::append(const QList<QPieSlice *> &slices)

Añade a la serie la matriz de segmentos especificada por ` slices `. La propiedad de los segmentos se transfiere a la serie.

Devuelve ` true ` si la adición se realiza correctamente.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] QPieSlice *QPieSeries::append(const QString &label, qreal value)

Añade un único segmento con los valores especificados para « 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.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] QPieSlice *QPieSeries::at(qsizetype index)

Devuelve el objeto ` PieSlice ` en la posición ` index`. Devuelve `null` si no se ha encontrado ningún objeto ` PieSlice `.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QPieSeries::clear()

Elimina todas las secciones de la serie.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

qsizetype QPieSeries::count() const

Devuelve el número de segmentos de esta serie.

Nota: Funcióngetter para la propiedad count.

qreal QPieSeries::endAngle() 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ónde lectura para la propiedad endAngle.

Véase también setEndAngle(), startAngle() y setStartAngle().

[invokable] QPieSlice *QPieSeries::find(const QString &label)

Busca un objeto « PieSlice » que contenga la etiqueta « label ». Devuelve el objeto « PieSlice » si lo encuentra; en caso contrario, devuelve «null».

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] bool QPieSeries::insert(qsizetype 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.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

bool QPieSeries::isEmpty() const

Devuelve « true » si la serie está vacía.

[invokable] 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.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] bool QPieSeries::remove(qsizetype index)

Elimina el objeto « PieSlice » de la ubicación « index ». El objeto « PieSlice » se eliminará de forma permanente. Devuelve « true » si la eliminación se realiza correctamente.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QPieSeries::removeMultiple(qsizetype index, int count)

Elimina varias porciones de gráfico circular (PieSlices) de la serie, desde index hasta el número indicado en count. Las porciones de gráfico circular se eliminarán de forma permanente.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[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().

[invokable] bool QPieSeries::replace(const QList<QPieSlice *> &slices)

Sustituye toda la lista de «PieSlices» de la serie por la lista especificada en « slices ». Todos los «PieSlices» originales se eliminarán de forma permanente. Devuelve « true » si todos los «PieSlices» se han sustituido correctamente.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] bool QPieSeries::replace(QPieSlice *oldSlice, QPieSlice *newSlice)

Sustituye el elemento PieSlice oldSlice por newSlice si se encuentra en la serie.oldSlice se eliminará de forma permanente. Devuelve true si la sustitución se realiza correctamente.

Nota: Esta función se puede invocar a través del sistema de metaojetos y desde QML. Véase Q_INVOKABLE.

[invokable] bool QPieSeries::replace(qsizetype index, QPieSlice *slice)

Sustituye el ` PieSlice ` situado en la posición ` index ` por el especificado en ` slice`. El ` PieSlice ` original se eliminará de forma permanente. Devuelve ` false ` si falla la sustitución de cualquiera de los `PieSlices`.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

void QPieSeries::setEndAngle(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 endAngle(), startAngle() y setStartAngle().

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)

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::setStartAngle(qreal angle)

Establece el ángulo inicial del sector circular.

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

angle Debe ser menor que el ángulo final.

Nota: Funciónde asignación para la propiedad startAngle.

Véase también startAngle(), endAngle() y setEndAngle().

QList<QPieSlice *> QPieSeries::slices() const

Devuelve una lista de segmentos que pertenecen a esta serie.

qreal QPieSeries::startAngle() const

Devuelve el ángulo inicial 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 startAngle.

Véase también setStartAngle(), endAngle() y setEndAngle().

qreal QPieSeries::sum() const

Devuelve la suma de todos los valores de las secciones de esta serie.

Nota: Funcióngetter para la propiedad sum.

Véase también QPieSlice::value(), QPieSlice::setValue() y QPieSlice::percentage().

[invokable] bool QPieSeries::take(QPieSlice *slice)

Extrae un único segmento, especificado mediante ` slice`, de la serie. No elimina el objeto segmento.

Nota: La serie sigue siendo el objeto padre del segmento. Debes establecer el objeto padre para que asuma la propiedad completa.

Devuelve true si la operación de extracción se ha realizado correctamente.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[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 segmento especificado por ` slice ` a la serie y devuelve una referencia a la misma. La propiedad del segmento 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.