En esta página

PieSlice QML Type

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

Import Statement: import QtCharts 2.12
In C++: QPieSlice
Status: Deprecated

Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

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 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 de la porción y conectarse a ella mediante un brazo, o bien centrarse dentro de la porción, ya sea horizontalmente o en paralelo a la tangente o a la normal del arco de la porción.

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

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

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

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, siendo 0 grados la posición de 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 (color del lápiz).

Véase también borderWidth.

borderWidth : int

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.

Véase también borderColor.

brushFilename : string

El nombre del archivo que se utiliza como pincel para la sección.

color : color

El color de relleno (pincel) de la sección.

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 secció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.LabelOutsideLa etiqueta se sitúa fuera del corte, unida a él mediante un brazo. Este es el valor por defecto.
PieSlice.LabelInsideHorizontalLa etiqueta está centrada dentro del corte y dispuesta horizontalmente.
PieSlice.LabelInsideTangentialLa etiqueta está centrada dentro del corte y girada de modo que quede paralela a la tangente del arco del corte.
PieSlice.LabelInsideNormalLa 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 es 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 los 0 grados se sitúan a las 12 en punto. Se actualiza automáticamente una vez que se añade el segmento a la serie.

value : real

El valor de la porción.

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

Documentación de Signal

clicked()

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

El controlador de señal correspondiente es onClicked().

Nota: El controlador correspondiente es onClicked.

doubleClicked()

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

El controlador de señales correspondiente es onDoubleClicked().

Nota: El controlador correspondiente es onDoubleClicked.

hovered(bool state)

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

El controlador de señal correspondiente es onHovered().

Nota: El controlador correspondiente es onHovered.

pressed()

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

El controlador de señal correspondiente es onPressed().

Nota: El controlador correspondiente es onPressed.

released()

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

El controlador de señal correspondiente es onReleased().

Nota: El controlador correspondiente es onReleased.

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