Back to Qt.io
Contact Us Blog Download Qt
En esta página

QBoxPlotSeries Class

La clase QBoxPlotSeries presenta los datos en gráficos de cajas y bigotes. Más...

Header: #include <QBoxPlotSeries>
In QML: BoxPlotSeries
Inherits: QAbstractSeries

Propiedades

Funciones públicas

QBoxPlotSeries(QObject *parent = nullptr)
virtual ~QBoxPlotSeries()
bool append(QBoxSet *set)
bool append(const QList<QBoxSet *> &sets)
bool boxOutlineVisible()
QList<QBoxSet *> boxSets() const
qreal boxWidth()
QBrush brush() const
void clear()
int count() const
bool insert(int index, QBoxSet *set)
QPen pen() const
bool remove(QBoxSet *set)
void setBoxOutlineVisible(bool visible)
void setBoxWidth(qreal width)
void setBrush(const QBrush &brush)
void setPen(const QPen &pen)
bool take(QBoxSet *set)

Funciones públicas reimplementadas

virtual QAbstractSeries::SeriesType type() const override

Señales

void boxOutlineVisibilityChanged()
void boxWidthChanged()
void boxsetsAdded(const QList<QBoxSet *> &sets)
void boxsetsRemoved(const QList<QBoxSet *> &sets)
void brushChanged()
void clicked(QBoxSet *boxset)
void countChanged()
void doubleClicked(QBoxSet *boxset)
void hovered(bool status, QBoxSet *boxset)
void penChanged()
void pressed(QBoxSet *boxset)
void released(QBoxSet *boxset)

Descripción detallada

Una serie de gráficos de caja actúa como contenedor de elementos de caja y bigotes. Los elementos de varias series se agrupan en categorías según su valor de índice.

La clase QBarCategoryAxis se utiliza para añadir las categorías al eje del gráfico. Las etiquetas de categoría deben ser únicas. Si se define la misma etiqueta de categoría para varios elementos de caja y bigotes, sólo se dibuja la primera.

Consulte la Galería de gráficos con widgets para aprender a crear un gráfico de cajas y bigotes.

Véase también QBoxSet y QBarCategoryAxis.

Documentación de propiedades

boxOutlineVisible : bool

Esta propiedad mantiene la visibilidad del contorno de la caja.

Funciones de acceso:

bool boxOutlineVisible()
void setBoxOutlineVisible(bool visible)

Señal del notificador:

void boxOutlineVisibilityChanged()

boxWidth : qreal

Esta propiedad contiene la anchura del elemento caja y bigotes. El valor indica la anchura relativa del elemento dentro de su categoría. El valor puede estar entre 0.0 y 1.0. Los valores negativos se sustituyen por 0,0 y los valores superiores a 1,0 se sustituyen por 1,0.

Funciones de acceso:

qreal boxWidth()
void setBoxWidth(qreal width)

Señal del notificador:

void boxWidthChanged()

brush : QBrush

Esta propiedad contiene el pincel utilizado para rellenar las cajas de los elementos de caja y bigotes.

Funciones de acceso:

QBrush brush() const
void setBrush(const QBrush &brush)

Señal del notificador:

void brushChanged()

[read-only] count : int

Esta propiedad contiene el número de elementos de caja y bigotes de una serie de gráficos de caja.

Funciones de acceso:

int count() const

Señal del notificador:

void countChanged()

pen : QPen

Esta propiedad contiene la pluma utilizada para dibujar las líneas de los elementos de caja y bigotes.

Funciones de acceso:

QPen pen() const
void setPen(const QPen &pen)

Señal del notificador:

void penChanged()

Documentación de funciones miembro

[explicit] QBoxPlotSeries::QBoxPlotSeries(QObject *parent = nullptr)

Construye un gráfico de caja vacío que es un QObject y un hijo de parent.

[virtual noexcept] QBoxPlotSeries::~QBoxPlotSeries()

Elimina la serie del gráfico.

bool QBoxPlotSeries::append(QBoxSet *set)

Añade un único elemento de caja y bigotes especificado por set a la serie y toma posesión de él. Si el elemento es nulo o ya pertenece a la serie, no se añadirá. Devuelve true si la adición se ha realizado correctamente.

bool QBoxPlotSeries::append(const QList<QBoxSet *> &sets)

Añade una lista de elementos de caja y bigotes especificados por sets a la serie y toma posesión de ellos. Si la lista es nula o los elementos ya pertenecen a la serie, no se añadirán. Devuelve true si la adición se ha realizado correctamente.

[signal] void QBoxPlotSeries::boxOutlineVisibilityChanged()

Esta señal se emite cuando cambia la visibilidad del contorno de la caja.

Nota: Señal notificadora para la propiedad boxOutlineVisible.

QList<QBoxSet *> QBoxPlotSeries::boxSets() const

Devuelve una lista de elementos de caja y bigotes de una serie de gráficos de caja. Mantiene la propiedad de los elementos.

[signal] void QBoxPlotSeries::boxWidthChanged()

Esta señal se emite cuando cambia la anchura del elemento caja y bigotes.

Nota: Señal notificadora para la propiedad boxWidth.

[signal] void QBoxPlotSeries::boxsetsAdded(const QList<QBoxSet *> &sets)

Esta señal se emite cuando la lista de elementos de caja y bigotes especificada por sets se añade a la serie.

[signal] void QBoxPlotSeries::boxsetsRemoved(const QList<QBoxSet *> &sets)

Esta señal se emite cuando la lista de elementos de caja y bigotes especificada por sets se elimina de la serie.

[signal] void QBoxPlotSeries::brushChanged()

Esta señal se emite cuando cambia el pincel con el que se rellenan las cajas de los elementos caja y bigotes.

Nota: Señal notificadora para la propiedad brush.

void QBoxPlotSeries::clear()

Elimina todos los elementos de caja y bigotes de la serie y los borra permanentemente.

[signal] void QBoxPlotSeries::clicked(QBoxSet *boxset)

Esta señal se emite cuando el usuario hace clic en el elemento de caja y bigotes especificado por boxset en el gráfico.

int QBoxPlotSeries::count() const

Devuelve el número de elementos de caja y bigotes de una serie de gráficos de caja.

Nota: Función Getter para la propiedad count.

[signal] void QBoxPlotSeries::countChanged()

Esta señal se emite cuando cambia el número de elementos de caja y bigotes de la serie.

Nota: Señal notificadora para la propiedad count.

[signal] void QBoxPlotSeries::doubleClicked(QBoxSet *boxset)

Esta señal se emite cuando el usuario hace doble clic en el elemento de caja y bigotes especificado por boxset en el gráfico.

[signal] void QBoxPlotSeries::hovered(bool status, QBoxSet *boxset)

Esta señal se emite cuando el ratón se sitúa sobre el elemento de caja y bigotes especificado por boxset en el gráfico. Cuando el ratón se mueve sobre el elemento, status se convierte en true, y cuando el ratón se aleja de nuevo, se convierte en false.

bool QBoxPlotSeries::insert(int index, QBoxSet *set)

Inserta un elemento de caja y bigotes especificado por set en una serie en la posición especificada por index y toma posesión del elemento. Si el elemento es nulo o ya pertenece a la serie, no se añadirá. Devuelve true si la inserción tiene éxito.

[signal] void QBoxPlotSeries::penChanged()

Esta señal se emite cuando cambia el lápiz utilizado para dibujar las líneas de los elementos caja y bigotes.

Nota: Señal notificadora para la propiedad pen.

[signal] void QBoxPlotSeries::pressed(QBoxSet *boxset)

Esta señal se emite cuando el usuario hace clic en el elemento de caja y bigotes especificado por boxset en el gráfico y mantiene pulsado el botón del ratón.

[signal] void QBoxPlotSeries::released(QBoxSet *boxset)

Esta señal se emite cuando el usuario suelta la presión del ratón sobre el elemento de caja y bigotes especificado por boxset en el gráfico.

bool QBoxPlotSeries::remove(QBoxSet *set)

Elimina el elemento de caja y bigotes especificado por set de la serie y lo elimina permanentemente si la eliminación tiene éxito. Devuelve true si se ha eliminado el elemento.

bool QBoxPlotSeries::take(QBoxSet *set)

Toma el elemento de caja y bigotes especificado por set de la serie. No elimina el elemento.

Nota: La serie sigue siendo el objeto padre del elemento. Debe establecer el objeto padre para tomar la propiedad completa.

Devuelve true si la operación tiene éxito.

[override virtual] QAbstractSeries::SeriesType QBoxPlotSeries::type() const

Reimplementa una función de acceso a la propiedad: QAbstractSeries::type.

Devuelve el tipo de la serie.

Véase también QAbstractSeries y SeriesType.

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