En esta página

PieSlice QML Type

Representa una sola porción de una serie de gráficos circulares. Más...

Import Statement: import QtGraphs
In C++: QPieSlice

Propiedades

Señales

Métodos

  • PieSlice append(string label, real value)
  • PieSlice at(int index)
  • void clear()
  • PieSlice find(string label)
  • bool remove(PieSlice slice)
  • bool remove(int index)
  • void removeMultiple(int index, int count)
  • bool replace(PieSlice oldSlice, PieSlice newSlice)
  • bool replace(int index, PieSlice slice)
  • bool replaceAll(list<PieSlice> slices)
  • bool take(PieSlice slice)

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 tipo « PieSeries » 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.

De forma predeterminada, 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.

De forma predeterminada, el aspecto visual del segmento viene determinado por un tema, pero este se puede anular especificando las propiedades del segmento. Sin embargo, si se cambia el tema después de personalizar los segmentos, se perderá toda la personalización.

El tipo `PieSlice` debe utilizarse como elemento secundario de un tipo ` PieSeries `. Por ejemplo:

PieSeries {
    PieSlice {
        label: "example"
        value: 1
    }
}

Como alternativa, se pueden añadir porciones a una serie de gráfico circular utilizando el método PieSeries.append().

En ese caso, se puede utilizar ` PieSeries.at()` o ` PieSeries.find()` para acceder a las propiedades de una instancia individual de `PieSlice`.

Un segmento de gráfico circular puede contener subsegmentos.

PieSeries {
    PieSlice {
        label: "example"
        value: 1
        color: "orange"
        exploded: true
        PieSlice {
            label: "example2"
            value: 2
            color: "red"
        }
        PieSlice {
            label: "example3"
            value: 3
            color: "yellow"
            exploded: true
        }
    }
    PieSlice {
        label: "example4"
        value: 4
        color: "green"
    }
}

Una porción de tarta se divide en dos subporciones

Véase también PieSeries.

Documentación de propiedades

angleSpan : real [read-only]

El ángulo de la porción en grados. Un círculo completo mide 360 grados, y 0 grados corresponde a las 12 en punto. Se actualiza automáticamente una vez que se añade la porción a la serie.

borderColor : color

El color utilizado para dibujar el borde de la sección.

Véase también borderWidth.

borderWidth : real

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.

Véase también borderColor.

color : color

El color de relleno del segmento.

explodeDistanceFactor : real

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

Véase también exploded.

exploded : bool

Si la porción está separada del pastel.

Véase también explodeDistanceFactor.

label : string

La etiqueta de la sección.

Nota: La cadena puede estar formateada en HTML.

labelArmLengthFactor : real

La longitud del brazo de la etiqueta. Este 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

Véase también labelVisible.

labelColor : color

El color utilizado para dibujar la etiqueta de la sección.

labelFont : font

La fuente utilizada para la etiqueta de la porción.

Para obtener más información, consulta font.

Véase también labelVisible y labelPosition.

labelPosition : enumeration

Describe la posición de la etiqueta del corte.

ConstanteDescripción
PieSlice.LabelPosition.OutsideLa etiqueta se sitúa fuera del corte, unida a él mediante un brazo. Este es el valor por defecto.
PieSlice.LabelPosition.InsideHorizontalLa etiqueta está centrada dentro del corte y dispuesta horizontalmente.
PieSlice.LabelPosition.InsideTangentialLa etiqueta está centrada dentro del corte y girada de modo que quede paralela a la tangente del arco del corte.
PieSlice.LabelPosition.InsideNormalLa etiqueta está centrada dentro del corte y girada de forma que quede paralela a la normal del arco del corte.

Véase también labelVisible.

labelVisible : bool

La visibilidad de la etiqueta de la sección. Por defecto, la etiqueta no está visible.

percentage : real [read-only]

El porcentaje que representa el segmento en relación con la suma de todos los segmentos de la serie. El valor real oscila entre 0,0 y 1,0. Se actualiza automáticamente una vez que se añade el segmento a la serie.

startAngle : real [read-only]

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

subSlicesCount : int [read-only]

El número de subcortes que hay en el corte.

subSlicesSum : real [read-only]

La suma de todas las subsecciones.

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

value : real

El valor de la porción.

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

Documentación de Signal

angleSpanChanged()

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

Nota: El controlador correspondiente es onAngleSpanChanged.

Véase también angleSpan.

borderColorChanged()

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

Nota: El controlador correspondiente es onBorderColorChanged.

Véase también borderColor.

borderWidthChanged()

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

Nota: El controlador correspondiente es onBorderWidthChanged.

Véase también borderWidth.

colorChanged()

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

Nota: El controlador correspondiente es onColorChanged.

explodeDistanceFactorChanged()

Esta señal se emite cuando cambia el factor de distancia de explosión.

Nota: El controlador correspondiente es onExplodeDistanceFactorChanged.

Véase también explodeDistanceFactor.

explodedChanged()

Esta señal se emite cuando cambia la propiedad «exploded».

Nota: El controlador correspondiente es onExplodedChanged.

Véase también exploded.

labelArmLengthFactorChanged()

Esta señal se emite cuando cambia el factor de longitud del brazo de la etiqueta.

Nota: El controlador correspondiente es onLabelArmLengthFactorChanged.

Véase también labelArmLengthFactor.

labelChanged()

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

Nota: El controlador correspondiente es onLabelChanged.

Véase también label.

labelColorChanged()

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

Nota: El controlador correspondiente es onLabelColorChanged.

Véase también labelColor.

labelFontChanged()

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

Nota: El controlador correspondiente es onLabelFontChanged.

Véase también labelFont.

labelFontChanged()

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

Nota: El controlador correspondiente es onLabelFontChanged.

Véase también labelFont.

labelPositionChanged()

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

Nota: El controlador correspondiente es onLabelPositionChanged.

Véase también labelPosition.

labelVisibleChanged()

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

Nota: El controlador correspondiente es onLabelVisibleChanged.

Véase también labelVisible.

percentageChanged()

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

Nota: El controlador correspondiente es onPercentageChanged.

Véase también percentage.

startAngleChanged()

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

Nota: El controlador correspondiente es onStartAngleChanged.

Véase también startAngle.

subSlicesAdded(list<PieSlice> slices)

Esta señal se emite cuando se añaden a la sección las subsecciones especificadas por slices.

Nota: El controlador correspondiente es onSubSlicesAdded.

subSlicesCountChanged(qsizetype count)

Esta señal se emite cuando cambia el subsegmento count.

Nota: El controlador correspondiente es onSubSlicesCountChanged.

Véase también subSlicesCount.

subSlicesRemoved(list<PieSlice> slices)

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

Nota: El controlador correspondiente es onSubSlicesRemoved.

subSlicesSumChanged(qreal sum)

Esta señal se emite cuando cambia el sum de todos los subsegmentos.

Nota: El controlador correspondiente es onSubSlicesSumChanged.

Véase también subSlicesSum.

valueChanged()

Esta señal se emite cuando cambia el valor del segmento.

Nota: El controlador correspondiente es onValueChanged.

Véase también value.

Documentación del método

PieSlice append(string label, real value)

Añade una nueva subsección a la sección con la etiqueta « label » y el valor « value ».

PieSlice at(int index)

Devuelve el subsegmento situado en la posición especificada por ` index`. Devuelve `null` si el índice no es válido.

void clear()

Elimina todos los subcortes del corte.

PieSlice find(string label)

Devuelve la primera subserie que tenga la etiqueta « label ». Devuelve «null» si no se encuentra la etiqueta.

bool remove(PieSlice slice)

Elimina del segmento el subsegmento especificado por slice. Devuelve true si la eliminación se ha realizado correctamente; en caso contrario, devuelve false.

bool remove(int index)

Elimina de la sección el subsección especificada por ` index `. Devuelve ` true ` si la eliminación se ha realizado correctamente y ` false ` en caso contrario.

void removeMultiple(int index, int count)

Elimina un rango de subsegmentos según se especifica en index y count. La llamada recorre todos los subsegmentos, incluso si falla la eliminación de uno de ellos.

bool replace(PieSlice oldSlice, PieSlice newSlice)

Sustituye la subporción especificada por ` oldSlice ` por ` newSlice`. Devuelve ` true ` si la sustitución se ha realizado correctamente; en caso contrario, devuelve ` false `. ` oldSlice ` se destruye si se ha sustituido correctamente.

bool replace(int index, PieSlice slice)

Sustituye el subsegmento especificado por slice del segmento situado en index. Devuelve true si la sustitución se ha realizado correctamente; en caso contrario, devuelve false.

bool replaceAll(list<PieSlice> slices)

Sustituye por completo todos los subsegmentos actuales por slices. No es necesario que el tamaño coincida. Devuelve «false» si alguno de los PieSlice de slices no es válido.

bool take(PieSlice slice)

Extrae un único subcorte, especificado por ` slice`, del corte. No elimina el objeto del subcorte. Devuelve ` true ` si la operación se realiza correctamente.

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