En esta página

QPieSlice Class

La clase QPieSlice representa un solo segmento de una serie circular. Más información...

Header: #include <QPieSlice>
In QML: PieSlice
Inherits: QObject
Status: Deprecated

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Tipos públicos

enum LabelPosition { LabelOutside, LabelInsideHorizontal, LabelInsideTangential, LabelInsideNormal }

Propiedades

Funciones públicas

QPieSlice(QObject *parent = nullptr)
QPieSlice(QString label, qreal value, QObject *parent = nullptr)
virtual ~QPieSlice()
qreal angleSpan() const
QColor borderColor()
int borderWidth()
QBrush brush() const
QColor color()
qreal explodeDistanceFactor() const
bool isExploded() const
bool isLabelVisible() const
QString label() const
qreal labelArmLengthFactor() const
QBrush labelBrush() const
QColor labelColor()
QFont labelFont() const
QPieSlice::LabelPosition labelPosition()
QPen pen() const
qreal percentage() const
QPieSeries *series() const
void setBorderColor(QColor color)
void setBorderWidth(int width)
void setBrush(const QBrush &brush)
void setColor(QColor color)
void setExplodeDistanceFactor(qreal factor)
void setExploded(bool exploded = true)
void setLabel(QString label)
void setLabelArmLengthFactor(qreal factor)
void setLabelBrush(const QBrush &brush)
void setLabelColor(QColor color)
void setLabelFont(const QFont &font)
void setLabelPosition(QPieSlice::LabelPosition position)
void setLabelVisible(bool visible = true)
void setPen(const QPen &pen)
void setValue(qreal value)
qreal startAngle() const
qreal value() const

Señales

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 los sectores del gráfico o pasan el ratón por encima de ellos.

Véase también QPieSeries.

Documentación sobre los tipos de miembros

enum QPieSlice::LabelPosition

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

ConstanteValorDescripción
QPieSlice::LabelOutside0La etiqueta se encuentra fuera del corte y está unida a él mediante un brazo. Este es el valor por defecto.
QPieSlice::LabelInsideHorizontal1La etiqueta está centrada dentro del corte y dispuesta horizontalmente.
QPieSlice::LabelInsideTangential2La etiqueta está centrada dentro del corte y girada de forma que quede paralela a la tangente del arco del corte.
QPieSlice::LabelInsideNormal3La 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 del segmento 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 el segmento a la serie.

Funciones de acceso:

qreal angleSpan() const

Señal de notificación:

borderColor : QColor

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

Funciones de acceso:

QColor borderColor()
void setBorderColor(QColor color)

Señal de notificación:

Véase también pen y borderWidth.

borderWidth : int

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

Funciones de acceso:

int borderWidth()
void setBorderWidth(int width)

Señal de notificación:

Véase también pen y borderColor.

brush : QBrush

Esta propiedad contiene el pincel utilizado para rellenar la sección.

Funciones de acceso:

QBrush brush() const
void setBrush(const QBrush &brush)

Señal de notificación:

void brushChanged()

color : QColor

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

Funciones de acceso:

QColor color()
void setColor(QColor color)

Señal de notificación:

void colorChanged()

Véase también brush.

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)

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 = true)

Véase también explodeDistanceFactor.

label : QString

Esta propiedad contiene el título del segmento.

Nota: La cadena puede estar formateada en HTML.

Funciones de acceso:

QString label() const
void setLabel(QString label)

Señal de notificador:

void labelChanged()

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

labelArmLengthFactor : qreal

Esta propiedad indica la longitud del brazo de la etiqueta. El factor es relativo al 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)

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

labelBrush : QBrush

Esta propiedad contiene el pincel utilizado para dibujar la etiqueta y el brazo de la etiqueta del segmento.

Funciones de acceso:

QBrush labelBrush() const
void setLabelBrush(const QBrush &brush)

Señal de notificación:

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

labelColor : QColor

Esta propiedad contiene el color utilizado para dibujar la etiqueta del segmento. Se trata de una propiedad auxiliar que permite modificar el pincel de la etiqueta del segmento.

Funciones de acceso:

QColor labelColor()
void setLabelColor(QColor color)

Señal de notificación:

Véase también labelBrush.

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:

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)

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 del notificador:

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

pen : QPen

Esta propiedad contiene el trazo utilizado para dibujar el borde de la sección.

Funciones de acceso:

QPen pen() const
void setPen(const QPen &pen)

Señal de notificación:

void penChanged()

[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:

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

[read-only] startAngle : qreal

Esta propiedad contiene el ángulo inicial de este segmento en 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 segmento a la serie.

Funciones de acceso:

qreal startAngle() const

Señal de notificación:

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(QString label, qreal value, QObject *parent = nullptr)

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

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

[virtual noexcept] QPieSlice::~QPieSlice()

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

[signal] void QPieSlice::angleSpanChanged()

Esta señal se emite cuando cambia el intervalo angular del corte.

Nota: Señalde notificación para la propiedad angleSpan.

Véase también ` angleSpan`.

[signal] void QPieSlice::borderColorChanged()

Esta señal se emite cuando cambia el color del borde de la sección.

Nota: Señalde notificación para la propiedad borderColor.

Véase también pen y borderColor.

[signal] void QPieSlice::borderWidthChanged()

Esta señal se emite cuando cambia el ancho del borde de un corte.

Nota: Señalde notificación para la propiedad borderWidth.

Véase también pen y borderWidth.

[signal] void QPieSlice::brushChanged()

Esta señal se emite cuando cambia el pincel utilizado para rellenar la sección.

Nota: Señalde notificación para la propiedad brush.

Véase también ` brush`.

[signal] void QPieSlice::clicked()

Esta señal se emite al hacer clic en el corte.

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

[signal] void QPieSlice::colorChanged()

Esta señal se emite cuando cambia el color del corte.

Nota: Señalde notificación para la propiedad color.

Véase también brush.

[signal] void QPieSlice::doubleClicked()

Esta señal se emite cuando el usuario hace doble clic en el corte.

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

[signal] void QPieSlice::hovered(bool state)

Esta señal se emite cuando se pasa el ratón por encima de la sección. Cuando el ratón se desplaza sobre la sección, state cambia a true, y cuando el ratón se aleja de nuevo, cambia a false.

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

[signal] void QPieSlice::labelBrushChanged()

Esta señal se emite cuando cambia el pincel de etiqueta del corte.

Nota: Señalde notificación para la propiedad labelBrush.

Véase también ` labelBrush`.

[signal] void QPieSlice::labelChanged()

Esta señal se emite cuando cambia la etiqueta del corte.

Nota: Señalde notificación para la propiedad label.

Véase también label.

[signal] void QPieSlice::labelColorChanged()

Esta señal se emite cuando cambia el color de la etiqueta de un corte.

Nota: Señalde notificación para la propiedad labelColor.

Véase también labelColor.

[signal] void QPieSlice::labelFontChanged()

Esta señal se emite cuando cambia la fuente de la etiqueta del corte.

Nota: Señalde notificación para la propiedad labelFont.

Véase también « labelFont ».

[signal] void QPieSlice::labelVisibleChanged()

Esta señal se emite cuando cambia la visibilidad de la etiqueta de la sección.

Nota: Señalde notificación para la propiedad labelVisible.

Véase también labelVisible.

[signal] void QPieSlice::penChanged()

Esta señal se emite cuando cambia el lápiz utilizado para dibujar el borde del corte.

Nota: Señalde notificación para la propiedad pen.

Véase también pen.

[signal] void QPieSlice::percentageChanged()

Esta señal se emite cuando cambia el porcentaje de la porción.

Nota: Señalde notificación para la propiedad percentage.

Véase también percentage.

[signal] void QPieSlice::pressed()

Esta señal se emite cuando el usuario hace clic en el corte y mantiene pulsado el botón del ratón.

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

[signal] void QPieSlice::released()

Esta señal se emite cuando el usuario suelta el botón del ratón sobre el corte.

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

QPieSeries *QPieSlice::series() const

Devuelve la serie a la que pertenece este segmento.

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

[signal] void QPieSlice::startAngleChanged()

Esta señal se emite cuando cambia el ángulo inicial del corte.

Nota: Señalde notificación para la propiedad startAngle.

Véase también startAngle.

[signal] void QPieSlice::valueChanged()

Esta señal se emite cuando cambia el valor de la sección.

Nota: Señalde notificación para la propiedad value.

Véase también value.

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