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 |
- Lista de todos los miembros, incluidos los heredados
- QPieSlice forma parte de las clases C++ de «Qt Graphs » para 2D.
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.
| Constante | Valor | Descripción |
|---|---|---|
QPieSlice::LabelPosition::Outside | 0 | La etiqueta se encuentra fuera del corte y está conectada a él mediante un brazo. Este es el valor por defecto. |
QPieSlice::LabelPosition::InsideHorizontal | 1 | La etiqueta está centrada dentro del corte y dispuesta horizontalmente. |
QPieSlice::LabelPosition::InsideTangential | 2 | La etiqueta está centrada dentro del corte y girada de forma que quede paralela a la tangente del arco del corte. |
QPieSlice::LabelPosition::InsideNormal | 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 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.