En esta página

QBarSet Class

La clase QBarSet representa un conjunto de barras en un gráfico de barras. Más...

Header: #include <QBarSet>
In QML: BarSet
Inherits: QObject

Propiedades

Funciones públicas

QBarSet(const QString label, QObject *parent = nullptr)
virtual ~QBarSet()
void append(const QList<qreal> &values)
void append(const qreal value)
qreal at(const int index) const
QColor borderColor()
QBrush brush() const
QColor color()
int count() const
(since 6.2) void deselectAllBars()
(since 6.2) void deselectBar(int index)
(since 6.2) void deselectBars(const QList<int> &indexes)
void insert(const int index, const qreal value)
(since 6.2) bool isBarSelected(int index) const
QString label() const
QBrush labelBrush() const
QColor labelColor()
QFont labelFont() const
QPen pen() const
void remove(const int index, const int count = 1)
void replace(const int index, const qreal value)
(since 6.2) void selectAllBars()
(since 6.2) void selectBar(int index)
(since 6.2) void selectBars(const QList<int> &indexes)
(since 6.2) QList<int> selectedBars() const
(since 6.2) QColor selectedColor() const
(since 6.2) void setBarSelected(int index, bool selected)
void setBorderColor(QColor color)
void setBrush(const QBrush &brush)
void setColor(QColor color)
void setLabel(const QString label)
void setLabelBrush(const QBrush &brush)
void setLabelColor(QColor color)
void setLabelFont(const QFont &font)
void setPen(const QPen &pen)
(since 6.2) void setSelectedColor(const QColor &color)
qreal sum() const
(since 6.2) void toggleSelection(const QList<int> &indexes)
QBarSet &operator<<(const qreal &value)
qreal operator[](const int index) const

Señales

void borderColorChanged(QColor color)
void brushChanged()
void clicked(int index)
void colorChanged(QColor color)
void doubleClicked(int index)
void hovered(bool status, int index)
void labelBrushChanged()
void labelChanged()
void labelColorChanged(QColor color)
void labelFontChanged()
void penChanged()
void pressed(int index)
void released(int index)
void valueChanged(int index)
void valuesAdded(int index, int count)
void valuesRemoved(int index, int count)

Descripción detallada

Un conjunto de barras contiene un valor de datos por cada categoría. Se supone que el primer valor de un conjunto pertenece a la primera categoría, el segundo a la segunda, y así sucesivamente. Si el conjunto tiene menos valores que categorías, se supone que los valores que faltan se encuentran al final del conjunto. Para los valores que faltan en medio de un conjunto, se utiliza el valor numérico cero. No se muestran las etiquetas de los conjuntos de valor cero.

Véase también QAbstractBarSeries, QBarSeries, QStackedBarSeries, QPercentBarSeries, QHorizontalBarSeries, QHorizontalStackedBarSeries, y QHorizontalPercentBarSeries.

Documentación de propiedades

borderColor : QColor

Esta propiedad contiene el color de la línea (pluma) del conjunto de barras.

Funciones de acceso:

QColor borderColor()
void setBorderColor(QColor color)

Señal del notificador:

void borderColorChanged(QColor color)

brush : QBrush

Esta propiedad contiene el pincel utilizado para rellenar las barras del conjunto de barras.

Funciones de acceso:

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

Señal del notificador:

void brushChanged()

color : QColor

Esta propiedad contiene el color de relleno (pincel) del conjunto de barras.

Funciones de acceso:

QColor color()
void setColor(QColor color)

Señal del notificador:

void colorChanged(QColor color)

label : QString

Esta propiedad contiene la etiqueta del conjunto de barras.

Funciones de acceso:

QString label() const
void setLabel(const QString label)

Señal del notificador:

void labelChanged()

labelBrush : QBrush

Esta propiedad contiene el pincel utilizado para dibujar la etiqueta del conjunto de barras.

Funciones de acceso:

QBrush labelBrush() const
void setLabelBrush(const QBrush &brush)

Señal del notificador:

labelColor : QColor

Esta propiedad contiene el color del texto (etiqueta) del conjunto de barras.

Funciones de acceso:

QColor labelColor()
void setLabelColor(QColor color)

Señal del notificador:

void labelColorChanged(QColor color)

labelFont : QFont

Esta propiedad contiene la fuente utilizada para dibujar la etiqueta del conjunto de barras.

Funciones de acceso:

QFont labelFont() const
void setLabelFont(const QFont &font)

Señal del notificador:

pen : QPen

Esta propiedad contiene el lápiz utilizado para dibujar las líneas de las barras del conjunto de barras.

Funciones de acceso:

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

Señal del notificador:

void penChanged()

Documentación de la función miembro

[explicit] QBarSet::QBarSet(const QString label, QObject *parent = nullptr)

Construye un conjunto de barras con la etiqueta label y el padre parent.

[virtual noexcept] QBarSet::~QBarSet()

Elimina el juego de barras.

void QBarSet::append(const QList<qreal> &values)

Añade la lista de valores reales especificada por values al final del conjunto de barras.

Véase también append().

void QBarSet::append(const qreal value)

Añade el nuevo valor especificado por value al final del conjunto de barras.

qreal QBarSet::at(const int index) const

Devuelve el valor especificado por index del conjunto de barras. Si el índice está fuera de los límites, se devuelve 0,0.

QColor QBarSet::borderColor()

Devuelve el color de la línea del conjunto de barras.

Nota: Función Getter para la propiedad borderColor.

Véase también setBorderColor().

[signal] void QBarSet::borderColorChanged(QColor color)

Esta señal se emite cuando el color de la línea (pluma) del conjunto de barras cambia a color.

Nota: Señal notificadora para la propiedad borderColor.

QBrush QBarSet::brush() const

Devuelve el pincel utilizado para rellenar las barras del conjunto de barras.

Nota: Función Getter para la propiedad brush.

Véase también setBrush().

[signal] void QBarSet::brushChanged()

Esta señal se emite cuando cambia el pincel utilizado para dibujar el conjunto de barras.

Nota: Señal notificadora para la propiedad brush.

Véase también brush.

[signal] void QBarSet::clicked(int index)

Esta señal se emite cuando el usuario hace clic en la barra especificada por index en un conjunto de barras.

QColor QBarSet::color()

Devuelve el color de relleno del conjunto de barras.

Nota: Función Getter para la propiedad color.

Véase también setColor().

[signal] void QBarSet::colorChanged(QColor color)

Esta señal se emite cuando el color de relleno (pincel) del conjunto de barras cambia a color.

Nota: Señal notificadora para la propiedad color.

int QBarSet::count() const

Devuelve el número de valores de un conjunto de barras.

[since 6.2] void QBarSet::deselectAllBars()

Deselecciona todos los compases de la serie.

Esta función se introdujo en Qt 6.2.

Véase también setBarSelected().

[since 6.2] void QBarSet::deselectBar(int index)

Deselecciona la barra en index.

Esta función se introdujo en Qt 6.2.

Véase también setBarSelected().

[since 6.2] void QBarSet::deselectBars(const QList<int> &indexes)

Marca múltiples barras pasadas en una lista indexes como deseleccionadas.

Esta función se introdujo en Qt 6.2.

Véase también setBarSelected().

[signal] void QBarSet::doubleClicked(int index)

Esta señal se emite cuando el usuario hace doble clic en la barra especificada por index en un conjunto de barras.

[signal] void QBarSet::hovered(bool status, int index)

Esta señal se emite cuando se pasa el ratón por encima de la barra especificada por index en un conjunto de barras. Cuando el ratón se mueve sobre la barra, status se convierte en true, y cuando el ratón se aleja de nuevo, se convierte en false.

void QBarSet::insert(const int index, const qreal value)

Inserta value en la posición especificada por index. Los valores que siguen al valor insertado se desplazan una posición hacia arriba.

Véase también remove().

[since 6.2] bool QBarSet::isBarSelected(int index) const

Devuelve true si la barra en el index dado está entre las barras seleccionadas y false en caso contrario.

Nota: Las barras seleccionadas se dibujan usando el color seleccionado si se especificó usando QBarSet::setSelectedColor.

Esta función se introdujo en Qt 6.2.

Véase también selectedBars(), setBarSelected(), y setSelectedColor().

QString QBarSet::label() const

Devuelve la etiqueta del conjunto de barras.

Nota: Función Getter para la propiedad label.

Véase también setLabel().

QBrush QBarSet::labelBrush() const

Devuelve el pincel utilizado para dibujar los valores encima de este conjunto de barras.

Nota: Función Getter para la propiedad labelBrush.

Véase también setLabelBrush().

[signal] void QBarSet::labelBrushChanged()

Esta señal se emite cuando cambia el pincel utilizado para dibujar la etiqueta del conjunto de barras.

Nota: Señal notificadora para la propiedad labelBrush.

Véase también labelBrush.

[signal] void QBarSet::labelChanged()

Esta señal se emite cuando cambia la etiqueta del conjunto de barras.

Nota: Señal notificadora para la propiedad label.

Véase también label.

QColor QBarSet::labelColor()

Devuelve el color del texto del conjunto de barras.

Nota: Función Getter para la propiedad labelColor.

Véase también setLabelColor().

[signal] void QBarSet::labelColorChanged(QColor color)

Esta señal se emite cuando el color del texto (etiqueta) del conjunto de barras cambia a color.

Nota: Señal notificadora para la propiedad labelColor.

QFont QBarSet::labelFont() const

Devuelve la pluma utilizada para dibujar los valores en la parte superior de este conjunto de barras.

Nota: Función Getter para la propiedad labelFont.

Véase también setLabelFont().

[signal] void QBarSet::labelFontChanged()

Esta señal se emite cuando cambia la fuente de la etiqueta del conjunto de barras.

Nota: Señal notificadora para la propiedad labelFont.

Véase también labelBrush.

QPen QBarSet::pen() const

Devuelve la pluma utilizada para dibujar las líneas en el conjunto de barras.

Nota: Función Getter para la propiedad pen.

Véase también setPen().

[signal] void QBarSet::penChanged()

Esta señal se emite cuando cambia el lápiz utilizado para dibujar el conjunto de barras.

Nota: Señal notificadora para la propiedad pen.

Véase también pen.

[signal] void QBarSet::pressed(int index)

Esta señal se emite cuando el usuario hace clic en la barra especificada por index en un conjunto de barras y mantiene pulsado el botón del ratón.

[signal] void QBarSet::released(int index)

Esta señal se emite cuando el usuario suelta la presión del ratón sobre la barra especificada por index en un conjunto de barras.

void QBarSet::remove(const int index, const int count = 1)

Elimina el número de valores especificados por count del conjunto de barras empezando por el valor especificado por index.

Véase también insert().

void QBarSet::replace(const int index, const qreal value)

Añade el valor especificado por value a la barra fijada en la posición especificada por index.

[since 6.2] void QBarSet::selectAllBars()

Marca todas las barras de la serie como seleccionadas.

Esta función se introdujo en Qt 6.2.

Véase también setBarSelected().

[since 6.2] void QBarSet::selectBar(int index)

Marca la barra en index como seleccionada.

Esta función se introdujo en Qt 6.2.

Véase también setBarSelected().

[since 6.2] void QBarSet::selectBars(const QList<int> &indexes)

Marca como seleccionadas varias barras pasadas en una lista indexes.

Esta función se introdujo en Qt 6.2.

Véase también setBarSelected().

[since 6.2] QList<int> QBarSet::selectedBars() const

Devuelve una lista de barras marcadas como seleccionadas.

Esta función se introdujo en Qt 6.2.

Véase también setBarSelected().

[since 6.2] QColor QBarSet::selectedColor() const

Devuelve el color de las barras seleccionadas.

Es el color de relleno (pincel) de las barras marcadas como seleccionadas. Si no se especifica, se utiliza el valor de QBarSet::color por defecto.

Esta función se introdujo en Qt 6.2.

Véase también setSelectedColor() y color.

[since 6.2] void QBarSet::setBarSelected(int index, bool selected)

Marca la barra en index como seleccionada o deseleccionada según se especifique en selected.

Nota: Las barras seleccionadas se dibujan utilizando el color seleccionado si se ha especificado. Emite QBarSet::selectedBarsChanged.

Esta función se introdujo en Qt 6.2.

Véase también isBarSelected() y setSelectedColor().

void QBarSet::setBorderColor(QColor color)

Establece el color de la línea para la barra establecida en color.

Nota: Función Setter para la propiedad borderColor.

Véase también borderColor().

void QBarSet::setBrush(const QBrush &brush)

Establece el pincel utilizado para rellenar las barras del conjunto de barras en brush.

Nota: Función Setter para la propiedad brush.

Véase también brush().

void QBarSet::setColor(QColor color)

Establece el color de relleno para la barra establecida en color.

Nota: Función Setter para la propiedad color.

Véase también color().

void QBarSet::setLabel(const QString label)

Establece label como la nueva etiqueta para el conjunto de barras.

Nota: Función Setter para la propiedad label.

Véase también label().

void QBarSet::setLabelBrush(const QBrush &brush)

Establece el pincel utilizado para dibujar los valores en la parte superior de esta barra establecida en brush.

Nota: Función Setter para la propiedad labelBrush.

Véase también labelBrush().

void QBarSet::setLabelColor(QColor color)

Establece el color del texto para la barra establecida en color.

Nota: Función Setter para la propiedad labelColor.

Véase también labelColor().

void QBarSet::setLabelFont(const QFont &font)

Establece la fuente utilizada para dibujar los valores en la parte superior de esta barra establecida en font.

Nota: Función Setter para la propiedad labelFont.

Véase también labelFont().

void QBarSet::setPen(const QPen &pen)

Establece el lápiz utilizado para dibujar las líneas en la barra establecida en pen.

Nota: Función Setter para la propiedad pen.

Véase también pen().

[since 6.2] void QBarSet::setSelectedColor(const QColor &color)

Establece el color de las barras seleccionadas.

Esta función se introdujo en Qt 6.2.

Véase también selectedColor.

qreal QBarSet::sum() const

Devuelve la suma de todos los valores del conjunto de barras.

[since 6.2] void QBarSet::toggleSelection(const QList<int> &indexes)

Cambia el estado de selección de las barras en el indexes dado al opuesto.

Esta función se introdujo en Qt 6.2.

Véase también setBarSelected().

[signal] void QBarSet::valueChanged(int index)

Esta señal se emite cuando se modifica el valor en la posición especificada por index.

Véase también at().

[signal] void QBarSet::valuesAdded(int index, int count)

Esta señal se emite cuando se añaden nuevos valores al conjunto de barras. index indica la posición del primer valor insertado, y count es el número de valores insertados.

Véase también append() y insert().

[signal] void QBarSet::valuesRemoved(int index, int count)

Esta señal se emite cuando se eliminan valores del conjunto de barras. index indica la posición del primer valor eliminado, y count es el número de valores eliminados.

Véase también remove().

QBarSet &QBarSet::operator<<(const qreal &value)

Un operador práctico para añadir el valor real especificado por value al final del conjunto de barras.

Véase también append().

qreal QBarSet::operator[](const int index) const

Devuelve el valor del conjunto de barras especificado por index. Si el índice está fuera de los límites, se devuelve 0,0.

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