En esta página

QBoxPlotSeries Class

La clase QBoxPlotSeries presenta los datos en gráficos de caja y bigotes. Más información...

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

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

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 diagramas de caja actúa como contenedor de elementos de diagramas 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 diagramas de caja y bigotes, solo se dibuja el primero.

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

Gráfico de caja y bigotes en el que se compara la desviación mensual de las acciones de dos empresas a lo largo de 2012

Véase también QBoxSet y QBarCategoryAxis.

Documentación de propiedades

boxOutlineVisible : bool

Esta propiedad controla la visibilidad del contorno del cuadro.

Funciones de acceso:

bool boxOutlineVisible()
void setBoxOutlineVisible(bool visible)

Señal de notificación:

boxWidth : qreal

Esta propiedad contiene el ancho del elemento de tipo «caja y bigotes». El valor indica el ancho relativo del elemento dentro de su categoría. El valor puede estar comprendido 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 de notificación:

brush : QBrush

Esta propiedad contiene el pincel utilizado para rellenar los recuadros de los elementos de tipo «caja y bigotes».

Funciones de acceso:

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

Señal de notificador:

void brushChanged()

[read-only] count : int

Esta propiedad indica el número de elementos representados mediante diagramas de caja y bigotes en una serie de diagramas de caja.

Funciones de acceso:

int count() const

Señal de notificación:

void countChanged()

pen : QPen

Esta propiedad contiene el lápiz utilizado para dibujar las líneas de los elementos de tipo «caja y bigotes».

Funciones de acceso:

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

Señal de notificador:

void penChanged()

Documentación de funciones de miembro

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

Crea una serie de diagramas de caja vacía que es un « QObject » y un elemento secundario de « parent ».

[virtual noexcept] QBoxPlotSeries::~QBoxPlotSeries()

Elimina la serie del gráfico.

bool QBoxPlotSeries::append(QBoxSet *set)

Añade a la serie un único elemento de tipo «caja y bigotes» especificado por ` set ` y asume la propiedad del mismo. 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 a la serie una lista de elementos de tipo «caja y bigotes» especificados por ` sets ` y asume la propiedad de los mismos. 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 del cuadro.

Nota: Señalde notificación para la propiedad « boxOutlineVisible ».

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

Devuelve una lista de elementos de caja y bigotes de una serie de diagramas 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ñalde notificación para la propiedad « boxWidth ».

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

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

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

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

[signal] void QBoxPlotSeries::brushChanged()

Esta señal se emite cuando cambia el pincel utilizado para rellenar las casillas de los elementos de tipo «caja y bigotes».

Nota: Señalde Notifier para la propiedad brush.

void QBoxPlotSeries::clear()

Elimina todos los elementos de tipo «caja y bigotes» de la serie y los borra de forma permanente.

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

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

int QBoxPlotSeries::count() const

Devuelve el número de elementos representados mediante diagramas de caja y bigotes en una serie de diagramas de caja.

Nota: Funcióngetter para la propiedad count.

[signal] void QBoxPlotSeries::countChanged()

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

Nota: Señalde notificación 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 gráfico 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 se pasa el ratón por encima del elemento de diagrama de caja y bigotes especificado por boxset en el gráfico. Cuando el ratón se desplaza sobre el elemento, status cambia a true, y cuando el ratón se aleja de nuevo, cambia a false.

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

Inserta un elemento de tipo «caja y bigotes» especificado por ` set ` en una serie en la posición indicada por ` index ` y asume la propiedad del elemento. Si el elemento es nulo o ya pertenece a la serie, no se añadirá. Devuelve ` true ` si la inserción se realiza correctamente.

[signal] void QBoxPlotSeries::penChanged()

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

Nota: Señalde notificador para la propiedad « pen ».

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

Esta señal se emite cuando el usuario hace clic en el elemento de diagrama 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 el botón del ratón sobre el elemento de gráfico de caja y bigotes especificado por boxset en el gráfico.

bool QBoxPlotSeries::remove(QBoxSet *set)

Elimina de la serie el elemento de caja y bigotes especificado por ` set ` y lo borra definitivamente si la eliminación se realiza con éxito. Devuelve ` true ` si se ha eliminado el elemento.

bool QBoxPlotSeries::take(QBoxSet *set)

Recupera de la serie el elemento de diagrama de caja y bigotes especificado por ` set `. No elimina el elemento.

Nota: La serie sigue siendo el objeto padre del elemento. Debes establecer el objeto padre para que asuma la propiedad total.

Devuelve ` true ` si la operación «take» se realiza correctamente.

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

Reimplementa una función de acceso para 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.