En esta página

QBarSet Class

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

Encabezado: #include <QBarSet>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
En QML: BarSet
Heredan de: QObject

Propiedades

Funciones públicas

QBarSet(const QString &label, QObject *parent = nullptr)
virtual ~QBarSet() override
void append(const QList<qreal> &values)
void append(qreal value)
qreal at(qsizetype index) const
QColor borderColor() const
qreal borderWidth() const
void clear()
QColor color() const
qsizetype count() const
void deselectAllBars()
void deselectBar(qsizetype index)
void deselectBars(const QList<qsizetype> &indexes)
void insert(qsizetype index, qreal value)
bool isBarSelected(qsizetype index) const
QString label() const
QColor labelColor() const
void remove(qsizetype index, qsizetype count = 1)
void replace(qsizetype index, qreal value)
void selectAllBars()
void selectBar(qsizetype index)
void selectBars(const QList<qsizetype> &indexes)
QList<qsizetype> selectedBars() const
QColor selectedColor() const
void setBarSelected(qsizetype index, bool selected)
void setBorderColor(QColor color)
void setBorderWidth(qreal borderWidth)
void setColor(QColor color)
void setLabel(const QString &label)
void setLabelColor(QColor color)
void setSelectedColor(QColor color)
void setValues(const QVariantList &values)
qreal sum() const
void toggleSelection(const QList<qsizetype> &indexes)
QVariantList values() const
QBarSet &operator<<(qreal value)
qreal operator[](qsizetype index) const

Señales

void borderColorChanged(QColor color)
void borderWidthChanged(qreal width)
void colorChanged(QColor color)
void countChanged()
void labelChanged()
void labelColorChanged(QColor color)
void selectedBarsChanged(const QList<qsizetype> &indexes)
void selectedColorChanged(QColor color)
void update()
void updatedBars()
void valueAdded(qsizetype index, qsizetype count)
void valueChanged(qsizetype index)
void valueRemoved(qsizetype index, qsizetype count)
void valuesAdded(qsizetype index, qsizetype count)
void valuesChanged()
void valuesRemoved(qsizetype index, qsizetype 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. Para los valores que faltan en el centro 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 QBarSeries.

Documentación de propiedades

borderColor : QColor

Esta propiedad establece el color del borde del conjunto de barras.

Funciones de acceso:

QColor borderColor() const
void setBorderColor(QColor color)

Señal de notificador:

void borderColorChanged(QColor color)

borderWidth : qreal

Esta propiedad establece el ancho de la línea del borde. Por defecto, el ancho es -1, lo que significa que el ancho del borde lo define el tema.

Funciones de acceso:

qreal borderWidth() const
void setBorderWidth(qreal borderWidth)

Señal de Notifier:

void borderWidthChanged(qreal width)

color : QColor

Esta propiedad contiene el color de relleno del conjunto de barras.

Funciones de acceso:

QColor color() const
void setColor(QColor color)

Señal de notificador:

void colorChanged(QColor color)

[read-only] count : qsizetype

Esta propiedad contiene el número de valores del conjunto de barras.

Funciones de acceso:

qsizetype count() const[see note below]

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Señal de notificación:

void countChanged()

label : QString

Esta propiedad contiene la etiqueta del conjunto de barras.

Funciones de acceso:

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

Señal de notificación:

void labelChanged()

labelColor : QColor

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

Funciones de acceso:

QColor labelColor() const
void setLabelColor(QColor color)

Señal de notificación:

void labelColorChanged(QColor color)

[read-only] selectedBars : QList<qsizetype>

Esta propiedad contiene los índices de las barras que están seleccionadas actualmente.

Funciones de acceso:

QList<qsizetype> selectedBars() const

Señal de notificación:

void selectedBarsChanged(const QList<qsizetype> &indexes)

selectedColor : QColor

Esta propiedad contiene el color de relleno del conjunto seleccionado.

Funciones de acceso:

QColor selectedColor() const
void setSelectedColor(QColor color)

Señal de notificación:

void selectedColorChanged(QColor color)

values : QVariantList

Esta propiedad contiene los valores del conjunto de barras.

Puede establecer como valores una lista de tipos « real » o « point ».

Si se establece una lista de tipos reales como valores, estos definen directamente los valores del conjunto de barras.

Si se establece como valores una lista de tipos de punto, la coordenada x del punto especifica su índice, basado en cero, en el conjunto de barras. El tamaño del conjunto de barras es el valor más alto de la coordenada x + 1. Si falta un punto para cualquier coordenada x entre cero y el valor más alto, se le asigna el valor cero.

Funciones de acceso:

QVariantList values() const
void setValues(const QVariantList &values)

Señal de notificación:

void valuesChanged()

Documentación de 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 ».

[override virtual noexcept] QBarSet::~QBarSet()

Elimina el conjunto de barras.

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

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

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también append ().

[invokable] void QBarSet::append(qreal value)

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

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] qreal QBarSet::at(qsizetype 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.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

QColor QBarSet::borderColor() const

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

Nota: Funcióngetter para la propiedad borderColor.

Véase también setBorderColor().

[invokable] void QBarSet::clear()

Elimina todos los valores del conjunto.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

QColor QBarSet::color() const

Devuelve el color de relleno del conjunto de barras.

Nota: Funcióngetter para la propiedad color.

Véase también setColor().

[invokable] qsizetype QBarSet::count() const

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

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Nota: Funcióngetter para la propiedad count.

[invokable] void QBarSet::deselectAllBars()

Deselecciona todas las barras del conjunto.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también setBarSelected().

[invokable] void QBarSet::deselectBar(qsizetype index)

Deselecciona la barra en index.

Nota: Esta función se puede invocar a través del sistema de metaoobjetos y desde QML. Véase Q_INVOKABLE.

Véase también setBarSelected().

[invokable] void QBarSet::deselectBars(const QList<qsizetype> &indexes)

Marca como deseleccionadas varias barras pasadas en una lista de indexes.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también setBarSelected().

[invokable] void QBarSet::insert(qsizetype index, 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.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también remove().

[invokable] bool QBarSet::isBarSelected(qsizetype 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.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

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().

QColor QBarSet::labelColor() const

Devuelve el color del texto del conjunto de barras.

Nota: Funcióngetter para la propiedad labelColor.

Véase también setLabelColor().

[invokable] void QBarSet::remove(qsizetype index, qsizetype count = 1)

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

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también insert().

[invokable] void QBarSet::replace(qsizetype index, qreal value)

Añade el valor especificado en value a la barra situada en la posición indicada en index.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QBarSet::selectAllBars()

Marca todas las barras del conjunto como seleccionadas.

Nota: Emite « QBarSet::selectedBarsChanged ».

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también setBarSelected().

[invokable] void QBarSet::selectBar(qsizetype index)

Marca la barra de index como seleccionada.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también setBarSelected().

[invokable] void QBarSet::selectBars(const QList<qsizetype> &indexes)

Marca como seleccionadas varias barras que se han pasado en una lista indexes.

Nota: Emite « QBarSet::selectedBarsChanged ».

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también setBarSelected().

QList<qsizetype> QBarSet::selectedBars() const

Devuelve una lista de barras marcadas como seleccionadas.

Nota: Funcióngetter para la propiedad selectedBars.

Véase también setBarSelected().

[signal] void QBarSet::selectedBarsChanged(const QList<qsizetype> &indexes)

Esta señal se emite cuando cambia la barra seleccionada. ` indexes ` es una lista que contiene los índices de las barras seleccionadas.

Nota: Señalde notificación para la propiedad ` selectedBars`.

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

Nota: Funcióngetter para la propiedad selectedColor.

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

[invokable] void QBarSet::setBarSelected(qsizetype index, bool selected)

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

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

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

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 asignación para la propiedad ` borderColor`.

Véase también ` borderColor()`.

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::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::setSelectedColor(QColor color)

Establece el valor de la propiedad « color » de las barras seleccionadas.

Nota: Funciónde configuración para la propiedad « selectedColor ».

Véase también selectedColor.

[invokable] qreal QBarSet::sum() const

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

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QBarSet::toggleSelection(const QList<qsizetype> &indexes)

Cambia el estado de selección de las barras en el indexes indicado por el contrario.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también setBarSelected().

[signal] void QBarSet::update()

Esta señal se emite cuando se actualiza el juego de barras.

[signal] void QBarSet::updatedBars()

Esta señal se emite cuando se actualizan las barras de este conjunto.

[signal] void QBarSet::valueAdded(qsizetype index, qsizetype 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.

[signal] void QBarSet::valueChanged(qsizetype 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::valueRemoved(qsizetype index, qsizetype 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.

[signal] void QBarSet::valuesAdded(qsizetype index, qsizetype 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(qsizetype index, qsizetype 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<<(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[](qsizetype 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.