QBarSet Class
La clase QBarSet representa un conjunto de barras en un gráfico de barras. Más...
| Cabecera: | #include <QBarSet> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| En QML: | BarSet |
| Hereda: | QObject |
- Lista de todos los miembros, incluyendo los heredados
- QBarSet es parte de Qt Graphs C++ Classes for 2D.
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 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 QBarSeries.
Documentación de propiedades
borderColor : QColor
Esta propiedad contiene el color del borde del conjunto de barras.
Funciones de acceso:
| QColor | borderColor() const |
| void | setBorderColor(QColor color) |
Señal del notificador:
| void | borderColorChanged(QColor color) |
borderWidth : qreal
Esta propiedad contiene el ancho de la línea del borde. Por defecto, el ancho es -1, lo que significa que el ancho del borde está definido por el tema.
Funciones de acceso:
| qreal | borderWidth() const |
| void | setBorderWidth(qreal borderWidth) |
Señal del notificador:
| void | borderWidthChanged(qreal width) |
color : QColor
Esta propiedad contiene el color de relleno del conjunto de barras.
Funciones de acceso:
Señal del 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 puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Señal de notificador:
| void | countChanged() |
label : QString
Esta propiedad contiene la etiqueta del conjunto de barras.
Funciones de acceso:
Señal del notificador:
| void | labelChanged() |
labelColor : QColor
Esta propiedad contiene el color del texto (etiqueta) del conjunto de barras.
Funciones de acceso:
| QColor | labelColor() const |
| void | setLabelColor(QColor color) |
Señal del notificador:
| void | labelColorChanged(QColor color) |
[read-only] selectedBars : QList<qsizetype>
Esta propiedad contiene los índices de las barras actualmente seleccionadas.
Funciones de acceso:
| QList<qsizetype> | selectedBars() const |
Señal del notificador:
| 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 del notificador:
| 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 establece una lista de tipos reales como valores, éstos definen directamente los valores del conjunto de barras.
Si establece como valores una lista de tipos de puntos, la coordenada x del punto especifica su índice basado en cero en el conjunto de compases. 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, recibe el valor cero.
Funciones de acceso:
| QVariantList | values() const |
| void | setValues(const QVariantList &values) |
Señal del notificador:
| void | valuesChanged() |
Documentación de funciones miembro
[explicit] QBarSet::QBarSet(const QString &label, QObject *parent = nullptr)
Construye un conjunto de barras con la etiqueta label y el padre parent.
[override virtual noexcept] QBarSet::~QBarSet()
Elimina el juego de barras.
[invokable] void QBarSet::append(const QList<qreal> &values)
Añade la lista de valores reales especificada por values al final del conjunto de barras.
Nota: Esta función puede invocarse 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 puede invocarse 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 puede invocarse 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ón Getter para la propiedad borderColor.
Véase también setBorderColor().
[invokable] void QBarSet::clear()
Elimina todos los valores del conjunto.
Nota: Esta función puede invocarse 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ón Getter 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 puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Nota: Función Getter para la propiedad count.
[invokable] void QBarSet::deselectAllBars()
Deselecciona todos los compases del conjunto.
Nota: Emite QBarSet::selectedBarsChanged.
Nota: Esta función puede invocarse 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 : Emite QBarSet::selectedBarsChanged.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Véase también setBarSelected().
[invokable] void QBarSet::deselectBars(const QList<qsizetype> &indexes)
Marca múltiples barras pasadas en una lista indexes como deseleccionadas.
Nota: Emite QBarSet::selectedBarsChanged.
Nota: Esta función puede invocarse 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 puede invocarse 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 en el index dado está entre las barras seleccionadas y false en caso contrario.
Nota: Las barras seleccionadas se dibujan utilizando el color seleccionado si se especificó utilizando QBarSet::setSelectedColor.
Nota: Esta función puede invocarse 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ón Getter para la propiedad label.
Véase también setLabel().
QColor QBarSet::labelColor() const
Devuelve el color del texto del conjunto de barras.
Nota: Función Getter para la propiedad labelColor.
Véase también setLabelColor().
[invokable] void QBarSet::remove(qsizetype index, qsizetype count = 1)
Elimina el número de valores especificados por count del conjunto de barras empezando por el valor especificado por index.
Nota: Esta función puede invocarse 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 por value al conjunto de barras en la posición especificada por index.
Nota: Esta función puede invocarse 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 puede invocarse 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 en index como seleccionada.
Nota: Emite QBarSet::selectedBarsChanged.
Nota: Esta función puede invocarse 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 pasadas en una lista indexes.
Nota: Emite QBarSet::selectedBarsChanged.
Nota: Esta función puede invocarse 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ón Getter 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 de índices de barras seleccionadas.
Nota: Señal notificadora para la propiedad selectedBars.
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.
Nota: Función Getter para la propiedad selectedColor.
Véase también setSelectedColor() y color.
[invokable] void QBarSet::setBarSelected(qsizetype 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.
Nota: Esta función puede invocarse 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 para la barra establecida en color.
Nota: Función Setter para la propiedad borderColor.
Véase también borderColor().
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::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::setSelectedColor(QColor color)
Establece el color de las barras seleccionadas.
Nota: Función Setter 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 puede invocarse 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 dado al opuesto.
Nota: Emite QBarSet::selectedBarsChanged.
Nota: Esta función puede invocarse 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 barset.
[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éase 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 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[](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.
