PieSlice QML Type
Representa una única porción de una serie de tartas. Más...
| Import Statement: | import QtCharts 2.11 |
| In C++: | QPieSlice |
Propiedades
- angleSpan : real
- borderColor : color
- borderWidth : int
- brushFilename : string
- color : color
- explodeDistanceFactor : real
- exploded : bool
- label : string
- labelArmLengthFactor : real
- labelColor : color
- labelFont : font
- labelPosition : enumeration
- labelVisible : bool
- percentage : real
- startAngle : real
- value : real
Señales
- clicked()
- doubleClicked()
- hovered(bool state)
- pressed()
- released()
Descripción detallada
Una porción de tarta tiene un valor y una etiqueta. Cuando la porción se añade a una serie de tarta, el tipo PieSeries calcula el porcentaje de la porción comparado 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 es visible, puede estar situada fuera de la rebanada y conectada a ella con un brazo o centrada dentro de la rebanada horizontalmente o en paralelo con la tangencial o la normal del arco de la rebanada.
Por defecto, el aspecto visual de la rebanada se establece mediante un tema, pero éste puede anularse especificando las propiedades de la rebanada. Sin embargo, si se cambia el tema después de personalizar las rebanadas, se perderá toda la personalización.
El tipo PieSlice debe utilizarse como hijo de un tipo PieSeries. Por ejemplo:
Alternativamente, se pueden añadir rodajas a una serie de tartas 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 PieSlice individual.
Véase también PieSeries.
Documentación de propiedades
angleSpan : real [read-only]
La amplitud de la rebanada en grados. Una tarta completa tiene 360 grados, donde 0 grados está a las 12 en punto. Se actualiza automáticamente cuando la porción se añade a la serie.
borderColor : color
El color utilizado para dibujar el borde de la rebanada (color del lápiz).
Véase también borderWidth.
borderWidth : int
La anchura del borde del corte. Se trata de una propiedad útil para modificar el lápiz del corte.
Véase también borderColor.
brushFilename : string
El nombre del archivo utilizado como pincel para la rebanada.
color : color
El color de relleno (pincel) de la rebanada.
explodeDistanceFactor : real
Determina a qué distancia de la tarta explota la rebanada.
- 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 rebanada está separada del pastel.
Véase también explodeDistanceFactor.
label : string
La etiqueta de la rebanada.
Nota: La cadena puede tener formato HTML.
labelArmLengthFactor : real
La longitud del brazo de la etiqueta. El factor es relativo al radio de la tarta. 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 rebanada.
labelFont : font
La fuente utilizada para la etiqueta de la rebanada.
Para más información, véase font.
Véase también labelVisible y labelPosition.
labelPosition : enumeration
Describe la posición de la etiqueta del corte.
| Constante | Descripción |
|---|---|
PieSlice.LabelOutside | La etiqueta se encuentra fuera de la rebanada conectada a ella con un brazo. Este es el valor por defecto. |
PieSlice.LabelInsideHorizontal | La etiqueta está centrada dentro de la rodaja y dispuesta horizontalmente. |
PieSlice.LabelInsideTangential | La etiqueta está centrada en la sección y girada en paralelo a la tangente del arco de la sección. |
PieSlice.LabelInsideNormal | La etiqueta se centra en el corte y se gira para que sea paralela a la normal del arco del corte. |
Véase también labelVisible.
labelVisible : bool
La visibilidad de la etiqueta de la rebanada. Por defecto, la etiqueta no es visible.
percentage : real [read-only]
Porcentaje del corte respecto a la suma de todos los cortes de la serie. El valor real oscila entre 0,0 y 1,0. Se actualiza automáticamente una vez que el corte se añade a la serie.
startAngle : real [read-only]
El ángulo inicial de esta rebanada en la serie a la que pertenece. Una tarta completa tiene 360 grados, donde 0 grados está a las 12 en punto. Se actualiza automáticamente cuando la porción se añade a la serie.
value : real
El valor del corte.
Nota: Un valor negativo se convierte en positivo.
Documentación de señales
clicked()
Esta señal se emite cuando se hace clic en el corte.
El manejador de señal correspondiente es onClicked().
Nota: El manejador correspondiente es onClicked.
doubleClicked()
Esta señal se emite cuando el usuario hace doble clic en la rebanada.
El manejador de señal correspondiente es onDoubleClicked().
Nota: El manejador correspondiente es onDoubleClicked.
hovered(bool state)
Esta señal se emite cuando se pasa el ratón por encima de la rebanada. Cuando el ratón se mueve sobre la rebanada, state se convierte en true, y cuando el ratón se aleja de nuevo, se convierte en false.
El manejador de señal correspondiente es onHovered().
Nota: El manejador correspondiente es onHovered.
pressed()
Esta señal se emite cuando el usuario hace clic en la rebanada y mantiene pulsado el botón del ratón.
El manejador de señal correspondiente es onPressed().
Nota: El manejador correspondiente es onPressed.
released()
Esta señal se emite cuando el usuario deja de pulsar el ratón sobre la rebanada.
El manejador de señal correspondiente es onReleased().
Nota: El manejador 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.
