QPieSlice Class
La clase QPieSlice representa un solo segmento de una serie circular. Más información...
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
| void | angleSpanChanged() |
| void | borderColorChanged() |
| void | borderWidthChanged() |
| void | brushChanged() |
| void | clicked() |
| void | colorChanged() |
| void | doubleClicked() |
| void | hovered(bool state) |
| void | labelBrushChanged() |
| void | labelChanged() |
| void | labelColorChanged() |
| void | labelFontChanged() |
| void | labelVisibleChanged() |
| void | penChanged() |
| void | percentageChanged() |
| void | pressed() |
| void | released() |
| void | startAngleChanged() |
| 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 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.
| Constante | Valor | Descripción |
|---|---|---|
QPieSlice::LabelOutside | 0 | La etiqueta se encuentra fuera del corte y está unida a él mediante un brazo. Este es el valor por defecto. |
QPieSlice::LabelInsideHorizontal | 1 | La etiqueta está centrada dentro del corte y dispuesta horizontalmente. |
QPieSlice::LabelInsideTangential | 2 | La etiqueta está centrada dentro del corte y girada de forma que quede paralela a la tangente del arco del corte. |
QPieSlice::LabelInsideNormal | 3 | La 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:
| void | angleSpanChanged() |
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:
| void | borderColorChanged() |
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:
| void | borderWidthChanged() |
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:
| void | labelBrushChanged() |
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:
| void | labelColorChanged() |
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:
| 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) |
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:
| void | labelVisibleChanged() |
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:
| void | percentageChanged() |
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:
| void | startAngleChanged() |
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.