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 |
- Lista de todos los miembros, incluidos los heredados
- QBarSet forma parte de las clases C++ de «Qt Graphs » para 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 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:
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:
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: 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::deselectBar(qsizetype index)
Deselecciona la barra en index.
Nota: Emite QBarSet::selectedBarsChanged.
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: 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::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: 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::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: 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().
[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.