En esta página

QPieSlice Class

La clase QPieSlice representa una sola porción de una serie circular. Más información...

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

Tipos públicos

enum class LabelPosition { Outside, InsideHorizontal, InsideTangential, InsideNormal }

Propiedades

Funciones públicas

QPieSlice(QObject *parent = nullptr)
QPieSlice(const QString &label, qreal value, QObject *parent = nullptr)
virtual ~QPieSlice() override
qreal angleSpan() const
bool append(QPieSlice *slice)
bool append(const QList<QPieSlice *> &slices)
QPieSlice *append(const QString &label, qreal value)
QPieSlice *at(qsizetype index) const
QColor borderColor() const
qreal borderWidth() const
QColor color() const
qreal explodeDistanceFactor() const
QPieSlice *find(const QString &label) const
bool insert(qsizetype index, QPieSlice *slice)
bool isEmpty() const
bool isExploded() const
bool isLabelVisible() const
QString label() const
qreal labelArmLengthFactor() const
QColor labelColor() const
QFont labelFont() const
QPieSlice::LabelPosition labelPosition()
qreal percentage() const
bool remove(QPieSlice *slice)
bool remove(qsizetype index)
void removeMultiple(qsizetype index, int count)
bool replace(QPieSlice *oldSlice, QPieSlice *newSlice)
bool replace(qsizetype index, QPieSlice *slice)
bool replaceAll(const QList<QPieSlice *> &slices)
QPieSeries *series() const
void setBorderColor(QColor color)
void setBorderWidth(qreal borderWidth)
void setColor(QColor color)
void setExplodeDistanceFactor(qreal factor)
void setExploded(bool exploded)
void setLabel(const QString &label)
void setLabelArmLengthFactor(qreal factor)
void setLabelColor(QColor color)
void setLabelFont(const QFont &font)
void setLabelPosition(QPieSlice::LabelPosition position)
void setLabelVisible(bool visible = true)
void setSubSlicesRatio(qreal subSlicesRatio)
void setValue(qreal value)
QQmlListProperty<QPieSlice> sliceChildren()
qreal startAngle() const
QList<QPieSlice *> subSlices() const
qsizetype subSlicesCount() const
qreal subSlicesRatio() const
qreal subSlicesSum() const
bool take(QPieSlice *slice)
qreal value() const

Ranuras públicas

void clear()

Señales

void angleSpanChanged()
void borderColorChanged()
void borderWidthChanged()
void colorChanged()
void explodeDistanceFactorChanged()
void explodedChanged()
void labelArmLengthFactorChanged()
void labelChanged()
void labelColorChanged()
void labelFontChanged()
void labelPositionChanged()
void labelVisibleChanged()
void percentageChanged()
void startAngleChanged()
void subSlicesAdded(const QList<QPieSlice *> &slices)
void subSlicesCountChanged(qsizetype count)
void subSlicesRatioChanged(qreal newSubSlicesRatio)
void subSlicesRemoved(const QList<QPieSlice *> &slices)
void subSlicesSumChanged(qreal sum)
void valueChanged()

Descripción detallada

Una porción de gráfico circular tiene un valor y una etiqueta. Cuando la porción se añade a una serie de gráficos circulares, el objeto ` QPieSeries ` calcula el porcentaje de la 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.

Por defecto, la etiqueta está oculta. Si está visible, puede situarse fuera del sector y conectarse a él mediante un brazo, o bien centrarse dentro del sector, ya sea horizontalmente o en paralelo a la tangente o a la normal del arco del sector.

Por defecto, el aspecto visual de la porción viene determinado por un tema, pero este se puede anular especificando las propiedades de la porción. Sin embargo, si se cambia el tema después de personalizar las porciones, se perderá toda la personalización.

Para permitir la interacción del usuario con el gráfico circular, se emiten algunas señales básicas cuando los usuarios hacen clic en las porciones del gráfico o pasan el ratón por encima de ellas.

Un sector del gráfico circular puede contener subsectores.

Véase también QPieSeries.

Documentación sobre tipos de miembros

enum class QPieSlice::LabelPosition

Esta enumeración describe la posición de la etiqueta de la sección.

ConstanteValorDescripción
QPieSlice::LabelPosition::Outside0La etiqueta se encuentra fuera del corte y está conectada a él mediante un brazo. Este es el valor por defecto.
QPieSlice::LabelPosition::InsideHorizontal1La etiqueta está centrada dentro del corte y dispuesta horizontalmente.
QPieSlice::LabelPosition::InsideTangential2La etiqueta está centrada dentro del corte y girada de forma que quede paralela a la tangente del arco del corte.
QPieSlice::LabelPosition::InsideNormal3La etiqueta está centrada dentro del corte y girada de modo que quede paralela a la normal del arco del corte.

Documentación de propiedades

[read-only] angleSpan : qreal

Esta propiedad indica el ángulo de la porción en grados. Un círculo completo equivale a 360 grados, donde 0 grados corresponde a las 12 en punto. Se actualiza automáticamente una vez que se añade la porción a la serie.

Funciones de acceso:

qreal angleSpan() const

Señal de notificación:

void angleSpanChanged()

borderColor : QColor

Esta propiedad contiene el color que se utiliza para dibujar el borde de la sección. Se trata de una propiedad de uso práctico para modificar la sección.

Funciones de acceso:

QColor borderColor() const
void setBorderColor(QColor color)

Señal de notificación:

void borderColorChanged()

Véase también « borderWidth ».

borderWidth : qreal

Esta propiedad define el ancho del borde de la sección. Se trata de una propiedad de uso práctico para modificar el ancho del borde de la sección.

Funciones de acceso:

qreal borderWidth() const
void setBorderWidth(qreal borderWidth)

Señal de notificación:

void borderWidthChanged()

Véase también « borderColor ».

color : QColor

Esta propiedad contiene el color de relleno del segmento. Se trata de una propiedad de uso práctico para modificar el color de relleno del segmento.

Funciones de acceso:

QColor color() const
void setColor(QColor color)

Señal de notificación:

void colorChanged()

explodeDistanceFactor : qreal

Determina a qué distancia del pastel se expande la porción.

  • 1,0 significa que la distancia es igual al radio.
  • 0,5 significa que la distancia es la mitad del radio.

Por defecto, la distancia es 0,15

Funciones de acceso:

qreal explodeDistanceFactor() const
void setExplodeDistanceFactor(qreal factor)

Señal de notificación:

void explodeDistanceFactorChanged()

Véase también exploded.

exploded : bool

Esta propiedad indica si la porción está separada del pastel.

Funciones de acceso:

bool isExploded() const
void setExploded(bool exploded)

Señal de notificación:

void explodedChanged()

Véase también explodeDistanceFactor.

label : QString

Esta propiedad contiene el nombre de la sección.

Nota: La cadena puede estar formateada en HTML.

Funciones de acceso:

QString label() const
void setLabel(const QString &label)

Señal de notificación:

void labelChanged()

Véase también labelVisible, labelFont y labelArmLengthFactor.

labelArmLengthFactor : qreal

Esta propiedad indica la longitud del brazo de la etiqueta. El valor se expresa en relación con el radio del gráfico circular. Por ejemplo:

  • 1,0 significa que la longitud es igual al radio.
  • 0,5 significa que la longitud es la mitad del radio.

Por defecto, la longitud del brazo es 0,15

Funciones de acceso:

qreal labelArmLengthFactor() const
void setLabelArmLengthFactor(qreal factor)

Señal de notificación:

void labelArmLengthFactorChanged()

Véase también label, labelVisible y labelFont.

labelColor : QColor

Esta propiedad determina el color que se utiliza para dibujar la etiqueta de la sección.

Funciones de acceso:

QColor labelColor() const
void setLabelColor(QColor color)

Señal de notificación:

void labelColorChanged()

labelFont : QFont

Esta propiedad contiene la fuente utilizada para dibujar el texto de la etiqueta.

Funciones de acceso:

QFont labelFont() const
void setLabelFont(const QFont &font)

Señal de notificación:

void labelFontChanged()

Véase también label, labelVisible y labelArmLengthFactor.

labelPosition : LabelPosition

Esta propiedad determina la posición de la etiqueta del segmento.

Funciones de acceso:

QPieSlice::LabelPosition labelPosition()
void setLabelPosition(QPieSlice::LabelPosition position)

Señal de notificación:

void labelPositionChanged()

Véase también label y labelVisible.

labelVisible : bool

Esta propiedad determina la visibilidad de la etiqueta del corte. Por defecto, la etiqueta no es visible.

Funciones de acceso:

bool isLabelVisible() const
void setLabelVisible(bool visible = true)

Señal de notificación:

void labelVisibleChanged()

Véase también label, labelFont y labelArmLengthFactor.

[read-only] percentage : qreal

Esta propiedad indica el porcentaje que representa la porción en relación con la suma de todas las porciones de la serie. El valor real oscila entre 0,0 y 1,0. Se actualiza automáticamente una vez que se añade la porción a la serie.

Funciones de acceso:

qreal percentage() const

Señal de notificación:

void percentageChanged()

Véase también value y QPieSeries::sum.

[read-only] sliceChildren : QQmlListProperty<QPieSlice>

La lista de sub-slices que contiene este slice. Se trata de una propiedad predeterminada que permite especificar sub-slices dentro de un elemento slice en QML sin necesidad de utilizar explícitamente el nombre de la propiedad «children».

Funciones de acceso:

QQmlListProperty<QPieSlice> sliceChildren()

[read-only] startAngle : qreal

Esta propiedad contiene el ángulo inicial de este sector dentro de la serie a la que pertenece. Un círculo completo mide 360 grados, donde 0 grados corresponde a las 12 en punto. Se actualiza automáticamente una vez que se añade el sector a la serie.

Funciones de acceso:

qreal startAngle() const

Señal de notificación:

void startAngleChanged()

[read-only] subSlicesCount : qsizetype

Esta propiedad contiene el número de subcortes que hay en el corte.

Funciones de acceso:

qsizetype subSlicesCount() const

Señal de notificación:

void subSlicesCountChanged(qsizetype count)

subSlicesRatio : qreal

El tamaño relativo de los subsegmentos en comparación con el segmento principal. El valor oscila entre 0,0 y 1,0, donde 1,0 significa que los subsegmentos ocupan el mismo espacio que ocuparía el segmento principal sin subsegmentos. El valor por defecto es 0,6.

Funciones de acceso:

qreal subSlicesRatio() const
void setSubSlicesRatio(qreal subSlicesRatio)

Señal de notificación:

void subSlicesRatioChanged(qreal newSubSlicesRatio)

[read-only] subSlicesSum : qreal

Esta propiedad contiene la suma de todas las subsecciones.

El segmento lleva un registro de la suma de todos los subsegmentos que contiene.

Funciones de acceso:

qreal subSlicesSum() const

Señal de notificación:

void subSlicesSumChanged(qreal sum)

value : qreal

Esta propiedad contiene el valor del fragmento.

Nota: Un valor negativo se convierte en un valor positivo.

Funciones de acceso:

qreal value() const
void setValue(qreal value)

Señal de notificación:

void valueChanged()

Véase también percentage() y QPieSeries::sum().

Documentación de funciones de miembro

[explicit] QPieSlice::QPieSlice(QObject *parent = nullptr)

Crea una sección vacía a partir del elemento padre parent.

Véase también QPieSeries::append() y QPieSeries::insert().

QPieSlice::QPieSlice(const QString &label, qreal value, QObject *parent = nullptr)

Crea una sección vacía con los valores especificados para « value », « label » y « parent ».

Véanse también QPieSeries::append() y QPieSeries::insert().

[override virtual noexcept] QPieSlice::~QPieSlice()

Elimina el segmento. El segmento no debe eliminarse si se ha añadido a una serie.

[invokable] bool QPieSlice::append(QPieSlice *slice)

Añade el subslices especificado por slice al slice. La propiedad del subslices se transfiere al slice.

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 QPieSlice::append(const QList<QPieSlice *> &slices)

Añade a la sección el conjunto de subsecciones especificadas por ` slices `. La propiedad de las subsecciones se transfiere a la sección.

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 *QPieSlice::append(const QString &label, qreal value)

Añade un único subsegmento con los valores especificados para ` value ` y ` label ` al segmento. La propiedad del subsegmento se transfiere al segmento. 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 *QPieSlice::at(qsizetype index) const

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.

[slot] void QPieSlice::clear()

Elimina todos los subsegmentos del segmento.

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

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 QPieSlice::insert(qsizetype index, QPieSlice *slice)

Inserta el subsegmento especificado por ` slice ` en el segmento anterior al subsegmento, en la posición especificada por ` index`. La propiedad del subsegmento se transfiere al segmento.

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 QPieSlice::isEmpty() const

Devuelve « true » si la lista de subtramos está vacía.

[invokable] bool QPieSlice::remove(QPieSlice *slice)

Elimina un único subsegmento, especificado por ` slice`, del segmento y lo borra de forma permanente.

No se podrá 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 QPieSlice::remove(qsizetype index)

Elimina el « PieSlice » de la ubicación index. El « 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 QPieSlice::removeMultiple(qsizetype index, int count)

Elimina varias porciones de «PieSlices» de la porción que comienza en « index » hasta el número indicado en « count ». Las porciones de «PieSlices» 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.

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

Sustituye el elemento PieSlice oldSlice por newSlice si se encuentra en el segmento. 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 metaobjetos y desde QML. Véase Q_INVOKABLE.

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

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

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

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

Sustituye toda la lista de PieSlices de la porción 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.

QPieSeries *QPieSlice::series() const

Devuelve la serie a la que pertenece este segmento.

Véase también QPieSeries::append().

QList<QPieSlice *> QPieSlice::subSlices() const

Devuelve una lista de subfragmentos que pertenecen a este fragmento.

[signal] void QPieSlice::subSlicesAdded(const QList<QPieSlice *> &slices)

Esta señal se emite cuando se añaden a la sección transversal las subsecciones especificadas en « slices ».

Véase también append().

qsizetype QPieSlice::subSlicesCount() const

Devuelve el número de subsegmentos que hay en este segmento.

Nota: Funcióngetter para la propiedad subSlicesCount.

[signal] void QPieSlice::subSlicesRemoved(const QList<QPieSlice *> &slices)

Esta señal se emite cuando los subcortes especificados por slices se eliminan del corte.

Véase también remove().

qreal QPieSlice::subSlicesSum() const

Devuelve la suma de todos los valores de los subsegmentos de este segmento.

Nota: Funcióngetter para la propiedad subSlicesSum.

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

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

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

Nota: El segmento 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.

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

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