QPieSeries Class
La clase QPieSeries presenta los datos en gráficos circulares. Más...
| Header: | #include <QPieSeries> |
| In QML: | PieSeries |
| Inherits: | QAbstractSeries |
Propiedades
|
|
Funciones públicas
| QPieSeries(QObject *parent = nullptr) | |
| virtual | ~QPieSeries() |
| bool | append(QPieSlice *slice) |
| bool | append(const QList<QPieSlice *> &slices) |
| QPieSlice * | append(const QString &label, qreal value) |
| void | clear() |
| int | count() const |
| qreal | holeSize() const |
| qreal | horizontalPosition() const |
| bool | insert(int index, QPieSlice *slice) |
| bool | isEmpty() const |
| qreal | pieEndAngle() const |
| qreal | pieSize() const |
| qreal | pieStartAngle() const |
| bool | remove(QPieSlice *slice) |
| void | setHoleSize(qreal holeSize) |
| void | setHorizontalPosition(qreal relativePosition) |
| void | setLabelsPosition(QPieSlice::LabelPosition position) |
| void | setLabelsVisible(bool visible = true) |
| void | setPieEndAngle(qreal angle) |
| void | setPieSize(qreal relativeSize) |
| void | setPieStartAngle(qreal startAngle) |
| void | setVerticalPosition(qreal relativePosition) |
| QList<QPieSlice *> | slices() const |
| qreal | sum() const |
| bool | take(QPieSlice *slice) |
| qreal | verticalPosition() const |
| QPieSeries & | operator<<(QPieSlice *slice) |
Funciones públicas reimplementadas
| virtual QAbstractSeries::SeriesType | type() const override |
Señales
| void | added(const QList<QPieSlice *> &slices) |
| void | clicked(QPieSlice *slice) |
| void | countChanged() |
| void | doubleClicked(QPieSlice *slice) |
| void | hovered(QPieSlice *slice, bool state) |
| void | pressed(QPieSlice *slice) |
| void | released(QPieSlice *slice) |
| void | removed(const QList<QPieSlice *> &slices) |
| void | sumChanged() |
Descripción detallada
Una serie de tartas se compone de porciones que se definen como objetos QPieSlice. Las porciones pueden tener cualquier valor ya que el objeto QPieSeries calcula el porcentaje de una 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.
El tamaño del pastel y su posición en el gráfico se controlan utilizando valores relativos que van de 0.0 a 1.0. Estos valores se refieren al rectángulo real del gráfico. Estos valores se refieren al rectángulo real del gráfico.
Por defecto, la tarta se define como una tarta completa. Se puede crear una tarta parcial estableciendo un ángulo inicial y un intervalo de ángulos para la serie. Una tarta completa tiene 360 grados, donde 0 está a las 12 en punto.
Vea la Galería de Gráficos con Widgets para aprender a utilizar QPieSeries.
Vea también QPieSlice y QChart.
Documentación de propiedades
[read-only] count : int
Esta propiedad contiene el número de rodajas de la serie.
Funciones de acceso:
| int | count() const |
Señal del notificador:
| void | countChanged() |
endAngle : qreal
Esta propiedad mantiene el ángulo final de la tarta.
Una tarta completa tiene 360 grados, donde 0 grados está a las 12 en punto.
El valor por defecto es 360.
Funciones de acceso:
| qreal | pieEndAngle() const |
| void | setPieEndAngle(qreal angle) |
holeSize : qreal
Esta propiedad contiene el tamaño del agujero del donut.
El valor es relativo al rectángulo del gráfico, de modo que:
- 0.0 es el tamaño mínimo (tarta completa dibujada sin agujero).
- 1.0 es el tamaño máximo que puede caber en el gráfico (el donut no tiene anchura).
Al establecer esta propiedad, la propiedad size se ajusta si es necesario, para asegurar que el tamaño del agujero no es mayor que el tamaño de la tarta.
El valor por defecto es 0.0.
Funciones de acceso:
| qreal | holeSize() const |
| void | setHoleSize(qreal holeSize) |
horizontalPosition : qreal
Esta propiedad contiene la posición horizontal de la tarta.
El valor es relativo al rectángulo del gráfico, de modo que:
- 0.0 es la izquierda absoluta.
- 1.0 es la derecha absoluta.
El valor por defecto es 0.5 (centro).
Funciones de acceso:
| qreal | horizontalPosition() const |
| void | setHorizontalPosition(qreal relativePosition) |
Véase también verticalPosition.
size : qreal
Esta propiedad contiene el tamaño de la tarta.
El valor es relativo al rectángulo del gráfico, de modo que:
- 0.0 es el tamaño mínimo (tarta no dibujada).
- 1.0 es el tamaño máximo que puede caber en el gráfico.
Cuando se establece esta propiedad, la propiedad holeSize se ajusta si es necesario, para asegurar que el tamaño del agujero no es mayor que el tamaño de la tarta.
El valor por defecto es 0.7.
Funciones de acceso:
| qreal | pieSize() const |
| void | setPieSize(qreal relativeSize) |
startAngle : qreal
Esta propiedad mantiene el ángulo inicial de la tarta.
Una tarta completa tiene 360 grados, donde 0 grados está a las 12 en punto.
El valor por defecto es 0.
Funciones de acceso:
| qreal | pieStartAngle() const |
| void | setPieStartAngle(qreal startAngle) |
[read-only] sum : qreal
Esta propiedad mantiene la suma de todos los cortes.
La serie lleva la cuenta de la suma de todos los cortes que contiene.
Funciones de acceso:
| qreal | sum() const |
Señal del notificador:
| void | sumChanged() |
verticalPosition : qreal
Esta propiedad contiene la posición vertical de la tarta.
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).
Funciones de acceso:
| qreal | verticalPosition() const |
| void | setVerticalPosition(qreal relativePosition) |
Véase también horizontalPosition.
Documentación de las funciones miembro
[explicit] QPieSeries::QPieSeries(QObject *parent = nullptr)
Construye un objeto serie hijo de parent.
[virtual noexcept] QPieSeries::~QPieSeries()
Elimina la serie de tartas y sus porciones.
[signal] void QPieSeries::added(const QList<QPieSlice *> &slices)
Esta señal se emite cuando los cortes especificados por slices se añaden a la serie.
Véase también append() y insert().
bool QPieSeries::append(QPieSlice *slice)
Añade el segmento especificado por slice a la serie. La propiedad de la porción se pasa a la serie.
Devuelve true si la anexión se realiza correctamente.
bool QPieSeries::append(const QList<QPieSlice *> &slices)
Añade a la serie la matriz de cortes especificada por slices. La propiedad de los cortes se pasa a la serie.
Devuelve true si la anexión tiene éxito.
QPieSlice *QPieSeries::append(const QString &label, qreal value)
Añade a la serie un único corte con las direcciones value y label especificadas. La propiedad de la porción se pasa a la serie. Devuelve null si value es NaN, Inf, o -Inf y no añade nada a la serie.
void QPieSeries::clear()
Borra todos los cortes de la serie.
[signal] void QPieSeries::clicked(QPieSlice *slice)
Esta señal se emite cuando se hace clic en la rebanada especificada por slice.
Véase también QPieSlice::clicked().
int QPieSeries::count() const
Devuelve el número de rodajas de esta serie.
Nota: Función Getter para la propiedad count.
[signal] void QPieSeries::countChanged()
Esta señal se emite cuando cambia el recuento de trozos.
Nota: Señal notificadora para la propiedad count.
Véase también count.
[signal] void QPieSeries::doubleClicked(QPieSlice *slice)
Esta señal se emite cuando se hace doble clic en la rebanada especificada por slice.
Véase también QPieSlice::doubleClicked().
[signal] void QPieSeries::hovered(QPieSlice *slice, bool state)
Esta señal se emite cuando el ratón se sitúa sobre el segmento especificado por slice. 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.
Véase también QPieSlice::hovered().
bool QPieSeries::insert(int index, QPieSlice *slice)
Inserta el slice especificado por slice en la serie antes del slice en la posición especificada por index. La propiedad de la rebanada se pasa a la serie.
Devuelve true si la inserción tiene éxito.
bool QPieSeries::isEmpty() const
Devuelve true si la serie está vacía.
qreal QPieSeries::pieEndAngle() const
Devuelve el ángulo final de la tarta.
Una tarta completa tiene 360 grados, donde 0 grados está a las 12 en punto.
Nota: Función Getter para la propiedad endAngle.
Véase también setPieEndAngle(), pieStartAngle(), y setPieStartAngle().
[signal] void QPieSeries::pressed(QPieSlice *slice)
Esta señal se emite cuando el usuario hace clic en la rebanada especificada por slice y mantiene pulsado el botón del ratón.
Véase también QPieSlice::pressed().
[signal] void QPieSeries::released(QPieSlice *slice)
Esta señal se emite cuando el usuario suelta la pulsación del ratón sobre el slice especificado por slice.
Véase también QPieSlice::released().
bool QPieSeries::remove(QPieSlice *slice)
Elimina una única porción, especificada por slice, de la serie y la borra permanentemente.
No se puede hacer referencia al puntero después de esta llamada.
Devuelve true si la eliminación tiene éxito.
[signal] void QPieSeries::removed(const QList<QPieSlice *> &slices)
Esta señal se emite cuando los cortes especificados por slices se eliminan de la serie.
Véase también remove().
void QPieSeries::setLabelsPosition(QPieSlice::LabelPosition position)
Establece la posición de todas las etiquetas de las rebanadas en position.
Nota: Esta función sólo afecta a las rodajas actuales de la serie. Si se añade una nueva rebanada, la posición por defecto de la etiqueta es QPieSlice::LabelOutside.
Véase también QPieSlice::labelPosition() y QPieSlice::setLabelPosition().
void QPieSeries::setLabelsVisible(bool visible = true)
Establece la visibilidad de todas las etiquetas de las rebanadas en visible.
Nota: Esta función sólo afecta a los cortes actuales de la serie. Si se añade una nueva rebanada, la visibilidad de la etiqueta por defecto es false.
Véase también QPieSlice::isLabelVisible() y QPieSlice::setLabelVisible().
void QPieSeries::setPieEndAngle(qreal angle)
Establece el ángulo final de la tarta.
Un pastel completo tiene 360 grados, donde 0 grados está a las 12 en punto.
angle debe ser mayor que el ángulo inicial.
Nota: Función Setter para la propiedad endAngle.
Véase también pieEndAngle(), pieStartAngle(), y setPieStartAngle().
QList<QPieSlice *> QPieSeries::slices() const
Devuelve una lista de rodajas que pertenecen a esta serie.
qreal QPieSeries::sum() const
Devuelve la suma de todos los valores de corte de esta serie.
Nota: Función Getter para la propiedad sum.
Véase también QPieSlice::value(), QPieSlice::setValue(), y QPieSlice::percentage().
[signal] void QPieSeries::sumChanged()
Esta señal se emite cuando cambia la suma de todos los cortes.
Nota: Señal notificadora para la propiedad sum.
Véase también sum.
bool QPieSeries::take(QPieSlice *slice)
Toma una única rebanada, especificada por slice, de la serie. No borra el objeto slice.
Nota: La serie sigue siendo el objeto padre del slice. Debe establecer el objeto padre para tomar la propiedad completa.
Devuelve true si la operación de toma se ha realizado correctamente.
[override virtual] QAbstractSeries::SeriesType QPieSeries::type() const
Reimplementa una función de acceso a la propiedad: QAbstractSeries::type.
Devuelve el tipo de la serie.
QPieSeries &QPieSeries::operator<<(QPieSlice *slice)
Añade el segmento especificado por slice a la serie y devuelve una referencia a la serie. La propiedad de la rebanada se pasa a la serie.
© 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.
