PieSeries QML Type
Muestra los datos en gráficos circulares. Más...
| Import Statement: | import QtGraphs |
| In C++: | QPieSeries |
| Inherits: |
- Lista de todos los miembros, incluidos los miembros heredados
- PieSeries forma parte de los tipos QML deQt Graphs para 2D.
Propiedades
- angleSpanLabelVisibility : enumeration
(since 6.10) - angleSpanVisibleLimit : real
(since 6.10) - count : int
- endAngle : real
- holeSize : real
- horizontalPosition : real
- pieSize : real
- sliceData : list<real>
(since 6.12) - sliceLabels : list<string>
(since 6.12) - startAngle : real
- sum : real
- verticalPosition : real
Señales
- added(list<PieSlice> slices)
- angleSpanLabelVisibilityChanged(LabelVisibility visibility)
(since 6.10) - angleSpanVisibleLimitChanged(real limit)
(since 6.10) - clicked(PieSlice slice)
- countChanged()
- doubleClicked(PieSlice slice)
- endAngleChanged()
- holeSizeChanged()
- horizontalPositionChanged()
- pieSizeChanged()
- pressed(PieSlice slice)
- released(PieSlice slice)
- removed(list<PieSlice> slices)
- sliceDataChanged(list<real> sliceData)
(since 6.12) - sliceLabelsChanged(list<string> sliceLabels)
(since 6.12) - startAngleChanged()
- sumChanged()
- verticalPositionChanged()
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(list<PieSlice> slices)
- bool replace(PieSlice oldSlice, PieSlice newSlice)
- bool replace(int index, PieSlice slice)
- bool take(PieSlice slice)
Descripción detallada
Una serie de gráficos circulares está formada por porciones que se definen mediante el tipo « PieSlice ». Las porciones pueden tener cualquier valor, ya que el tipo «PieSeries» calcula el porcentaje de una 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.
El tamaño y la posición del gráfico circular en el gráfico se controlan mediante valores relativos que oscilan entre 0,0 y 1,0. Estos valores se refieren al rectángulo real del gráfico.
Por defecto, el gráfico circular se define como un gráfico completo. Se puede crear un gráfico circular parcial estableciendo un ángulo inicial y un intervalo de ángulos para la serie. Un gráfico circular completo es de 360 grados, donde 0 corresponde a las 12 en punto.
El siguiente ejemplo de QML muestra cómo crear un gráfico circular sencillo.
import QtQuick
import QtGraphs
Item {
id: mainView
width: 1280
height: 720
GraphsView {
anchors.fill: parent
theme: GraphsTheme {
colorScheme: GraphsTheme.ColorScheme.Dark
theme: GraphsTheme.Theme.QtGreen
}
PieSeries {
id: pieSeries
PieSlice {
value: 1
}
PieSlice {
value: 2
}
}
}
}Véase también PieSlice y GraphsView.
Documentación de propiedades
angleSpanLabelVisibility : enumeration [since 6.10]
El modo de visibilidad de las etiquetas.
El modo que determina qué etiquetas se ocultarán si se encuentran por debajo del límite de ángulo establecido con « angleSpanVisibleLimit ». No tiene ningún efecto si no se ha establecido « angleSpanVisibleLimit ».
| Constante | Descripción |
|---|---|
PieSeries.LabelVisibility.None | Se ocultarán todas las etiquetas de los cortes cuyo ángulo de extensión sea menor que el valor de « angleSpanVisibleLimit ». |
PieSeries.LabelVisibility.First | Se ocultarán todas las etiquetas, excepto la primera, de los cortes consecutivos cuyo ángulo de extensión sea menor que el valor de « angleSpanVisibleLimit ». Este es el valor por defecto. |
PieSeries.LabelVisibility.Even | Se ocultarán las etiquetas alternas de los cortes consecutivos cuyo ángulo sea menor que el de « angleSpanVisibleLimit », empezando por la segunda. |
PieSeries.LabelVisibility.Odd | Se ocultarán las etiquetas alternas de los segmentos consecutivos cuyo ángulo sea menor que el de « angleSpanVisibleLimit », empezando por la primera. |
Esta propiedad se introdujo en Qt 6.10.
Véase también « angleSpanVisibleLimit ».
angleSpanVisibleLimit : real [since 6.10]
El límite del intervalo angular para la visibilidad de las etiquetas.
El intervalo angular que se utilizará como límite de visibilidad para la etiqueta de un segmento. Un segmento cuyo intervalo angular sea inferior a este valor cambiará su visibilidad en función del valor de « angleSpanLabelVisibility » establecido para la serie. El valor por defecto es « 0 », lo que significa que no se ocultará ningún segmento, independientemente del valor de « angleSpanLabelVisibility ».
Esta propiedad se introdujo en Qt 6.10.
Véase también angleSpanLabelVisibility.
count : int [read-only]
El número de secciones de la serie.
endAngle : real
El ángulo final del círculo.
Un círculo completo mide 360 grados, donde 0 grados corresponde a las 12 en punto.
El valor por defecto es 360.
holeSize : real
El tamaño del agujero de la rosquilla.
Al establecer la propiedad « pieSize », esta propiedad se ajusta si es necesario para garantizar que el tamaño del agujero no sea mayor que el tamaño del gráfico circular.
El valor por defecto es 0,0.
horizontalPosition : real
La posición horizontal del sector circular.
El valor es relativo al rectángulo del gráfico, de modo que:
- 0,0 es el extremo izquierdo absoluto.
- 1,0 es la derecha absoluta.
El valor por defecto es 0,5 (centro).
Véase también verticalPosition.
pieSize : real
El tamaño del gráfico circular.
El valor es relativo al rectángulo del gráfico, de modo que:
- 0,0 es el tamaño mínimo del gráfico circular (el gráfico circular no se dibuja).
- 1,0 es el tamaño máximo del gráfico circular que cabe en el gráfico.
Al establecer esta propiedad, la propiedad « holeSize » se ajusta si es necesario, para garantizar que el tamaño del hueco no sea mayor que el tamaño del gráfico circular.
El valor por defecto es 0,7.
sliceData : list<real> [since 6.12]
Valores declarativos de los segmentos.
Esta propiedad se puede utilizar para asignar valores de forma declarativa a los sectores del gráfico circular. Cuando se establece esta propiedad, la serie de gráficos circulares creará automáticamente un sector para cada valor. Las etiquetas de los sectores se pueden especificar en sliceLabels.
Nota: No se admitela combinación de entradas de datos declarativas e imperativas.
Esta propiedad se introdujo en Qt 6.12.
Véase también sliceLabels.
sliceLabels : list<string> [since 6.12]
Etiquetas declarativas de los sectores.
Esta propiedad se puede utilizar para asignar etiquetas de forma declarativa a los segmentos del gráfico circular. Cuando se establece esta propiedad, la serie de gráficos circulares (pieseries) asigna etiquetas a los segmentos creados de forma declarativa. Las etiquetas deben seguir el mismo orden que los valores de sliceData. Si no hay suficientes segmentos declarativos, se ignoran el resto de las etiquetas.
Nota: No se admitela combinación de entradas de datos declarativas e imperativas.
Esta propiedad se introdujo en Qt 6.12.
Véase también sliceData.
startAngle : real
El ángulo inicial del círculo.
Un círculo completo mide 360 grados, donde 0 grados corresponde a las 12 en punto.
El valor por defecto es 0.
sum : real [read-only]
La suma de todas las porciones.
La serie lleva la cuenta de la suma de todas las porciones que contiene.
verticalPosition : real
La posición vertical del sector circular.
El valor es relativo al rectángulo del gráfico, de modo que:
- 0,0 es la parte superior absoluta.
- 1,0 es la parte inferior absoluta.
El valor por defecto es 0,5 (centro).
Véase también horizontalPosition.
Documentación de Signal
added(list<PieSlice> slices)
Esta señal se emite cuando se añaden a la serie los cortes especificados por slices.
Nota: El controlador correspondiente es onAdded.
[since 6.10] angleSpanLabelVisibilityChanged(LabelVisibility visibility)
Esta señal se emite cuando se ha modificado el modo visible del límite del ángulo de cobertura. El parámetro « visibility » contiene el nuevo modo visible.
Nota: El controlador correspondiente es ` onAngleSpanLabelVisibilityChanged`.
Esta señal se introdujo en Qt 6.10.
[since 6.10] angleSpanVisibleLimitChanged(real limit)
Esta señal se emite cuando se ha modificado el límite del intervalo angular. El parámetro limit contiene el nuevo límite.
Nota: El controlador correspondiente es onAngleSpanVisibleLimitChanged.
Esta señal se introdujo en Qt 6.10.
clicked(PieSlice slice)
Esta señal se emite al hacer clic o pulsar sobre el slice.
Nota: El controlador correspondiente es onClicked.
countChanged()
Esta señal se emite cuando cambia el recuento de segmentos.
Nota: El controlador correspondiente es onCountChanged.
Véase también count.
doubleClicked(PieSlice slice)
Esta señal se emite cuando se hace doble clic o doble toque en el slice. Esta señal siempre se produce después de clicked.
Nota: El controlador correspondiente es onDoubleClicked.
endAngleChanged()
Esta señal se emite cuando cambia el ángulo del extremo del pastel.
Nota: El controlador correspondiente es onEndAngleChanged.
Véase también endAngle.
holeSizeChanged()
Esta señal se emite cuando cambia el tamaño del «agujero de la rosquilla».
Nota: El controlador correspondiente es onHoleSizeChanged.
Véase también holeSize.
horizontalPositionChanged()
Esta señal se emite cuando cambia la posición horizontal.
Nota: El controlador correspondiente es onHorizontalPositionChanged.
Véase también horizontalPosition.
pieSizeChanged()
Esta señal se emite cuando cambia el tamaño del pastel.
Nota: El controlador correspondiente es onPieSizeChanged.
Véase también pieSize.
pressed(PieSlice slice)
Esta señal se emite cuando el usuario hace clic o toca el « slice » y mantiene pulsado el botón del ratón o el gesto.
Nota: El controlador correspondiente es onPressed.
released(PieSlice slice)
Esta señal se emite cuando el usuario suelta un botón del ratón que había pulsado previamente o realiza un gesto en el slice.
Nota: El controlador correspondiente es onReleased.
removed(list<PieSlice> slices)
Esta señal se emite cuando los cortes especificados por slices se eliminan de la serie.
Nota: El controlador correspondiente es onRemoved.
[since 6.12] sliceDataChanged(list<real> sliceData)
Esta señal se emite cuando se han modificado los datos del corte. El parámetro sliceData contiene los datos del corte.
Nota: El controlador correspondiente es ` onSliceDataChanged`.
Esta señal se introdujo en Qt 6.12.
[since 6.12] sliceLabelsChanged(list<string> sliceLabels)
Esta señal se emite cuando se han modificado los datos del corte. El parámetro sliceLabels contiene los datos del corte.
Nota: El controlador correspondiente es onSliceLabelsChanged.
Esta señal se introdujo en Qt 6.12.
startAngleChanged()
Esta señal se emite cuando cambia el ángulo de inicio del pastel.
Nota: El controlador correspondiente es onStartAngleChanged.
Véase también startAngle.
sumChanged()
Esta señal se emite cuando cambia la suma de todos los segmentos.
Nota: El controlador correspondiente es onSumChanged.
Véase también sum.
verticalPositionChanged()
Esta señal se emite cuando cambia la posición vertical.
Nota: El controlador correspondiente es onVerticalPositionChanged.
Véase también verticalPosition.
Documentación del método
PieSlice append(string label, real value)
Añade una nueva porción al gráfico circular con la etiqueta « label » y el valor « value ».
PieSlice at(int index)
Devuelve el fragmento situado en la posición especificada por ` index`. Devuelve `null` si el índice no es válido.
void clear()
Elimina todas las porciones del gráfico circular.
PieSlice find(string label)
Devuelve el primer fragmento que tenga la etiqueta « label ». Devuelve «null» si no se encuentra la etiqueta.
bool remove(PieSlice slice)
Elimina del gráfico circular la porción especificada por ` slice `. Devuelve ` true ` si la eliminación se ha realizado correctamente y ` false ` en caso contrario.
bool remove(int index)
Elimina del gráfico circular la porció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 segmentos según lo especificado por index y count. La llamada recorre todos los segmentos, incluso si falla la eliminación de uno de ellos.
bool replace(list<PieSlice> slices)
Sustituye por completo todas las secciones actuales por slices. No es necesario que el tamaño coincida. Devuelve «false» si alguno de los elementos de PieSlice en slices no es válido.
bool replace(PieSlice oldSlice, PieSlice newSlice)
Sustituye el segmento especificado por « oldSlice » por «newSlice». Devuelve « true » si la eliminación se ha realizado correctamente; en caso contrario, devuelve « false ». « oldSlice » se destruye si la operación se realiza correctamente.
bool replace(int index, PieSlice slice)
Sustituye la porción especificada por slice del gráfico circular de index. Devuelve true si la sustitución se ha realizado correctamente; en caso contrario, devuelve false.
bool take(PieSlice slice)
Extrae un único segmento, especificado mediante ` slice`, de la serie. No elimina el objeto del segmento. 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.