QBarSet Class
La clase QBarSet representa un conjunto de barras en un gráfico de barras. Más información...
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
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 para cada categoría. Se supone que el primer valor de un conjunto pertenece a la primera categoría, el segundo a la segunda categoría, 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. En el caso de valores que faltan en medio de un conjunto, se utiliza el valor numérico cero. No se muestran las etiquetas de los conjuntos con valor cero.
Véase también QAbstractBarSeries, QBarSeries, QStackedBarSeries, QPercentBarSeries, QHorizontalBarSeries, QHorizontalStackedBarSeries y QHorizontalPercentBarSeries.
Documentación de la propiedad
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 de notificación:
| void | borderColorChanged(QColor color) |
brush : QBrush
Esta propiedad contiene el pincel utilizado para rellenar las barras del conjunto de barras.
Funciones de acceso:
Señal del notificador:
| void | brushChanged() |
color : QColor
Esta propiedad contiene el color de relleno (pincel) del conjunto de barras.
Funciones de acceso:
Señal de notificador:
| void | colorChanged(QColor color) |
label : QString
Esta propiedad contiene la etiqueta del conjunto de barras.
Funciones de acceso:
Señal de notificación:
| 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 de notificador:
| void | labelBrushChanged() |
labelColor : QColor
Esta propiedad define el color del texto (etiqueta) del conjunto de barras.
Funciones de acceso:
| QColor | labelColor() |
| void | setLabelColor(QColor color) |
Señal de notificación:
| void | labelColorChanged(QColor color) |
labelFont : QFont
Esta propiedad determina la fuente que se utiliza para dibujar la etiqueta del conjunto de barras.
Funciones de acceso:
| QFont | labelFont() const |
| void | setLabelFont(const QFont &font) |
Señal de notificación:
| void | labelFontChanged() |
pen : QPen
Esta propiedad contiene el lápiz utilizado para dibujar las líneas de las barras en el conjunto de barras.
Funciones de acceso:
Señal de notificación:
| void | penChanged() |
Documentación de las funciones de miembro
[explicit] QBarSet::QBarSet(const QString label, QObject *parent = nullptr)
Crea un conjunto de barras con la etiqueta « label » y el elemento principal « parent ».
[virtual noexcept] QBarSet::~QBarSet()
Elimina el conjunto 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 en « 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óngetter 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 (del trazo) del conjunto de barras cambia a color.
Nota: Señalde notificación para la propiedad borderColor.
QBrush QBarSet::brush() const
Devuelve el pincel utilizado para rellenar las barras del conjunto de barras.
Nota: Funcióngetter 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ñalde notificación 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 » dentro de un conjunto de barras.
QColor QBarSet::color()
Devuelve el color de relleno del conjunto de barras.
Nota: Funcióngetter 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ñalde notificación para la propiedad color.
int QBarSet::count() const
Devuelve el número de valores que contiene un conjunto de barras.
[since 6.2] void QBarSet::deselectAllBars()
Deselecciona todas las barras de la serie.
Nota: Emite un evento « QBarSet::selectedBarsChanged ».
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.
Nota: Emite « QBarSet::selectedBarsChanged ».
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 como deseleccionadas varias barras pasadas en una lista de indexes.
Nota: Emite QBarSet::selectedBarsChanged.
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 » dentro de 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 desplaza sobre la barra, « status » cambia a « true », y cuando el ratón se aleja de nuevo, cambia a « 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 situada en la dirección ` index ` se encuentra entre las barras seleccionadas y ` false ` en caso contrario.
Nota: Las barrasseleccionadas se dibujan con el color seleccionado si este se ha especificado mediante 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óngetter para la propiedad «label».
Véase también ` setLabel()`.
QBrush QBarSet::labelBrush() const
Devuelve el pincel utilizado para dibujar los valores sobre este conjunto de barras.
Nota: Funcióngetter 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ñalde notificación 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ñalde notificación para la propiedad label.
Véase también label.
QColor QBarSet::labelColor()
Devuelve el color del texto del conjunto de barras.
Nota: Funcióngetter 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ñalde notificación para la propiedad labelColor.
QFont QBarSet::labelFont() const
Devuelve el lápiz utilizado para dibujar valores sobre este conjunto de barras.
Nota: Funcióngetter 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ñalde notificación para la propiedad « labelFont ».
Véase también labelBrush.
QPen QBarSet::pen() const
Devuelve el lápiz utilizado para dibujar las líneas del conjunto de barras.
Nota: Funcióngetter 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ñalde notificación 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 » dentro de 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 el botó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 del conjunto de barras el número de valores especificado en count, empezando por el valor especificado en index.
Véase también insert().
void QBarSet::replace(const int index, const qreal value)
Añade el valor especificado en value a la barra situada en la posición indicada en index.
[since 6.2] void QBarSet::selectAllBars()
Marca todas las barras de la serie como seleccionadas.
Nota: Emite « QBarSet::selectedBarsChanged ».
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 de index como seleccionada.
Nota: Emite QBarSet::selectedBarsChanged.
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 que se han pasado en una lista de tipo « indexes ».
Nota: Emite QBarSet::selectedBarsChanged.
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.
Se trata del color de relleno (pincel) de las barras marcadas como seleccionadas. Si no se especifica, se utiliza como valor por defecto el valor de ` QBarSet::color `.
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 de index como seleccionada o deseleccionada, según se especifique en selected.
Nota: Las barrasseleccionadas se dibujan con 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 del conjunto de barras en color.
Nota: Funciónde configuración 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ónde asignación para la propiedad « brush ».
Véase también brush().
void QBarSet::setColor(QColor color)
Establece el color de relleno del conjunto de barras en color.
Nota: Funciónde asignación para la propiedad color.
Véase también ` color()`.
void QBarSet::setLabel(const QString label)
Establece « label » como la nueva etiqueta del conjunto de barras.
Nota: Funciónde asignación para la propiedad label.
Véase también label().
void QBarSet::setLabelBrush(const QBrush &brush)
Establece el pincel utilizado para dibujar valores sobre este conjunto de barras en « brush ».
Nota: Funciónde asignación para la propiedad labelBrush.
Véase también ` labelBrush()`.
void QBarSet::setLabelColor(QColor color)
Establece el color del texto de la barra definida en color.
Nota: Funciónde asignación para la propiedad ` labelColor`.
Véase también ` labelColor()`.
void QBarSet::setLabelFont(const QFont &font)
Establece la fuente utilizada para mostrar los valores sobre este conjunto de barras en font.
Nota: Funciónde asignación 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 del conjunto de barras en « pen ».
Nota: Funciónde asignación para la propiedad pen.
Véase también pen().
[since 6.2] void QBarSet::setSelectedColor(const QColor &color)
Establece el valor de « 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 la dirección indexes indicada al estado opuesto.
Nota: Emite el evento « QBarSet::selectedBarsChanged ».
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éanse 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 de conveniencia 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 rango, 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.