QBarSeries Class
La clase QBarSeries muestra los datos en gráficos de barras. Más información...
| Encabezado: | #include <QBarSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| En QML: | BarSeries |
| Heredan de: | QAbstractSeries |
- Lista de todos los miembros, incluidos los heredados
- QBarSeries forma parte de las clases de C++ de «Qt Graphs » para 2D.
Tipos públicos
| enum class | BarsType { Groups, Stacked, StackedPercent } |
| enum class | LabelsPosition { Center, InsideEnd, InsideBase, OutsideEnd } |
Propiedades
|
|
Funciones públicas
| QBarSeries(QObject *parent = nullptr) | |
| bool | append(QBarSet *set) |
| bool | append(const QList<QBarSet *> &sets) |
| QBarSet * | at(qsizetype index) |
| QQmlComponent * | barDelegate() const |
| QList<QBarSet *> | barSets() const |
| qreal | barWidth() const |
| QBarSeries::BarsType | barsType() const |
| QList<QColor> | borderColors() const |
| void | clear() |
| qsizetype | count() const |
| qsizetype | find(QBarSet *set) const |
| bool | insert(qsizetype index, QBarSet *set) |
| qreal | labelsAngle() const |
| QString | labelsFormat() const |
| qreal | labelsMargin() const |
| QBarSeries::LabelsPosition | labelsPosition() const |
| int | labelsPrecision() const |
| bool | labelsVisible() const |
| bool | remove(QBarSet *set) |
| bool | remove(qsizetype index) |
| void | removeMultiple(qsizetype index, qsizetype count) |
| bool | replace(const QList<QBarSet *> &sets) |
| bool | replace(QBarSet *oldValue, QBarSet *newValue) |
| void | replace(qsizetype index, QBarSet *set) |
| QList<QColor> | seriesColors() const |
| void | setBarDelegate(QQmlComponent *newBarDelegate) |
| void | setBarWidth(qreal width) |
| void | setBarsType(QBarSeries::BarsType type) |
| void | setBorderColors(const QList<QColor> &newBorderColors) |
| void | setLabelsAngle(qreal angle) |
| void | setLabelsFormat(const QString &format) |
| void | setLabelsMargin(qreal margin) |
| void | setLabelsPosition(QBarSeries::LabelsPosition position) |
| void | setLabelsPrecision(int precision) |
| void | setLabelsVisible(bool visible = true) |
| void | setSeriesColors(const QList<QColor> &newSeriesColors) |
| bool | take(QBarSet *set) |
Funciones públicas reimplementadas
| virtual QAbstractSeries::SeriesType | type() const override |
Señales
| void | barDelegateChanged() |
| void | barSetsChanged() |
| void | barWidthChanged() |
| void | barsTypeChanged(QBarSeries::BarsType type) |
| void | barsetsAdded(const QList<QBarSet *> &sets) |
| void | barsetsRemoved(const QList<QBarSet *> &sets) |
| void | borderColorsChanged() |
| void | countChanged() |
| void | labelsAngleChanged(qreal angle) |
| void | labelsFormatChanged(const QString &format) |
| void | labelsMarginChanged(qreal margin) |
| void | labelsPositionChanged(QBarSeries::LabelsPosition position) |
| void | labelsPrecisionChanged(int precision) |
| void | labelsVisibleChanged(bool visible) |
| void | seriesColorsChanged() |
| void | setValueAdded(qsizetype index, qsizetype count, QBarSet *barset) |
| void | setValueChanged(qsizetype index, QBarSet *barset) |
| void | setValueRemoved(qsizetype index, qsizetype count, QBarSet *barset) |
| void | updatedBars() |
Descripción detallada
Esta clase representa los datos, por defecto, como una serie de barras agrupadas por categoría, añadiendo a la serie una barra por categoría de cada conjunto de barras. También admite barras horizontales y la agrupación de barras apiladas.
Una serie de barras requiere que el eje X de « GraphsView » se establezca en « BarCategoryAxis » y que el eje Y se establezca en « ValueAxis ».
Véase también QBarSet y QAbstractSeries.
Documentación sobre tipos de miembros
enum class QBarSeries::BarsType
Este valor de enumeración describe el tipo de la serie de barras:
| Constante | Valor | Descripción |
|---|---|---|
QBarSeries::BarsType::Groups | 0 | Los conjuntos de barras se agrupan por categoría. |
QBarSeries::BarsType::Stacked | 1 | Los conjuntos de barras se apilan uno tras otro por categoría. |
QBarSeries::BarsType::StackedPercent | 2 | Los conjuntos de barras se apilan uno tras otro por categoría. El tamaño del segmento se corresponde con el porcentaje del valor del segmento en comparación con el valor total de todos los segmentos de la pila. |
enum class QBarSeries::LabelsPosition
Este valor de enumeración describe la posición de las etiquetas de los valores de datos:
| Constante | Valor | Descripción |
|---|---|---|
QBarSeries::LabelsPosition::Center | 0 | La etiqueta se encuentra en el centro de la barra. |
QBarSeries::LabelsPosition::InsideEnd | 1 | La etiqueta se encuentra dentro de la barra, en la parte superior. |
QBarSeries::LabelsPosition::InsideBase | 2 | La etiqueta se encuentra en la parte inferior de la barra. |
QBarSeries::LabelsPosition::OutsideEnd | 3 | La etiqueta se encuentra fuera de la barra, en la parte superior. |
Documentación de la propiedad
barDelegate : QQmlComponent*
Esta propiedad contiene un componente QML personalizado que se utiliza para visualizar cada una de las barras. Se crea una instancia de este componente para cada barra. Cuando no se define, se utiliza una visualización predeterminada en forma de rectángulo para las barras.
Las propiedades dinámicas disponibles para este componente son:
| Tipo | Nombre | Descripción |
|---|---|---|
| QColor | barColor | El color de relleno de la barra. Este valor procede de la propiedad « QGraphsTheme » o de « QBarSet::color » si la propiedad « QBarSet » anula el color. |
| QColor | barBorderColor | El color del borde de la barra. Este valor procede de QGraphsTheme o de QBarSet::borderColor si QBarSet anula el color. |
| qreal | barBorderWidth | El ancho del borde de la barra. Este valor procede de QGraphsTheme o de QBarSet::borderWidth si QBarSet anula el ancho. |
| qreal | barValue | El valor de la barra. Este valor procede de QBarSet::values. |
| QString | barLabel | La etiqueta de la barra. Este valor procede de QBarSet::label. |
| bool | barSelected | Este valor es «true» cuando la barra está seleccionada, lo que significa que el índice de la barra está en QBarSet::selectedBars. |
| int | barIndex | Índice de la barra, desde 0 hasta el número total de barras menos 1. [desde la versión 6.9] |
Para utilizar cualquiera de ellas, añade una propiedad con el nombre definido a tu componente personalizado. Por ejemplo, "property color barColor" y "property real barValue".
Funciones de acceso:
| QQmlComponent * | barDelegate() const |
| void | setBarDelegate(QQmlComponent *newBarDelegate) |
Señal del notificador:
| void | barDelegateChanged() |
[read-only] barSets : QList<QBarSet *>
Esta propiedad contiene una lista de los conjuntos añadidos a la serie.
Funciones de acceso:
| QList<QBarSet *> | barSets() const |
Señal de notificación:
| void | barSetsChanged() |
barWidth : qreal
Esta propiedad define el ancho de las barras de la serie.
La unidad de anchura es la unidad del eje x. La anchura mínima de las barras es cero, y los valores negativos se consideran cero. Establecer la anchura en cero significa que la anchura de la barra en la pantalla es de un píxel, independientemente de la escala del eje x. Las barras con una anchura superior a cero se escalan según la escala del eje x.
Por defecto, barWidth es 0,5 (las barras ocuparán el 50 % del ancho disponible). Los valores válidos oscilan entre 0,0 (0 %) y 1,0 (100 %).
Nota: Cuando se utiliza con ` QBarSeries`, este valor especifica el ancho de un grupo de barras en lugar del de una sola barra.
Funciones de acceso:
| qreal | barWidth() const |
| void | setBarWidth(qreal width) |
Señal de notificación:
| void | barWidthChanged() |
Véase también QBarSeries.
barsType : BarsType
Esta propiedad indica el tipo de la serie de barras.
Funciones de acceso:
| QBarSeries::BarsType | barsType() const |
| void | setBarsType(QBarSeries::BarsType type) |
Señal de notificación:
| void | barsTypeChanged(QBarSeries::BarsType type) |
borderColors : QList<QColor>
Esta propiedad contiene la lista de colores de borde que se utilizarán para todos los objetos de la serie.
Si hay más series que colores, la lista de colores se reinicia y vuelve a comenzar con el primer color de la lista. Si no se configura (valor por defecto), se utilizarán los colores de la paleta « QGraphsTheme::borderColors ».
Funciones de acceso:
| QList<QColor> | borderColors() const |
| void | setBorderColors(const QList<QColor> &newBorderColors) |
Señal de notificación:
| void | borderColorsChanged() |
[read-only] count : qsizetype
Esta propiedad indica el número de conjuntos de barras que hay en una serie 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 notificador:
| void | countChanged() |
labelsAngle : qreal
Esta propiedad indica el ángulo de las etiquetas de valores en grados.
Funciones de acceso:
| qreal | labelsAngle() const |
| void | setLabelsAngle(qreal angle) |
Señal de notificación:
| void | labelsAngleChanged(qreal angle) |
labelsFormat : QString
Esta propiedad define el formato que se utiliza para mostrar las etiquetas en una serie de barras.
QBarSeries Admite la siguiente etiqueta de formato:
| @value | El valor de la barra |
Por ejemplo, el siguiente uso de las etiquetas de formato generaría etiquetas que muestran el valor seguido de la unidad (u):
series->setLabelsFormat("@value u");Por defecto, las etiquetas muestran el valor de la barra. En el caso de las series de barras porcentuales, se añade % después del valor. Las etiquetas se muestran en el área del gráfico; si las barras están muy juntas, es posible que las etiquetas se superpongan.
Funciones de acceso:
| QString | labelsFormat() const |
| void | setLabelsFormat(const QString &format) |
Señal de notificación:
| void | labelsFormatChanged(const QString &format) |
Véase también labelsVisible, labelsPosition y labelsPrecision.
labelsMargin : qreal
Esta propiedad establece el margen de las etiquetas de valores en píxeles.
Este margen lateral se utiliza cuando la propiedad « labelsPosition » se establece en un valor distinto de « LabelsPosition.Center ». El valor por defecto es « 0 ».
Funciones de acceso:
| qreal | labelsMargin() const |
| void | setLabelsMargin(qreal margin) |
Señal de notificador:
| void | labelsMarginChanged(qreal margin) |
labelsPosition : LabelsPosition
Esta propiedad determina la posición de las etiquetas de valor.
Funciones de acceso:
| QBarSeries::LabelsPosition | labelsPosition() const |
| void | setLabelsPosition(QBarSeries::LabelsPosition position) |
Señal de notificación:
| void | labelsPositionChanged(QBarSeries::LabelsPosition position) |
Véase también labelsVisible y labelsFormat.
labelsPrecision : int
Esta propiedad establece el número máximo de dígitos significativos que se muestran en las etiquetas de valor.
El valor por defecto es 6.
Funciones de acceso:
| int | labelsPrecision() const |
| void | setLabelsPrecision(int precision) |
Señal de notificación:
| void | labelsPrecisionChanged(int precision) |
labelsVisible : bool
Esta propiedad determina la visibilidad de las etiquetas en una serie de barras. La visibilidad predeterminada de las etiquetas es « false ».
Nota: La etiqueta predeterminada solo muestra el valor del conjunto. Puedes crear etiquetas personalizadas con un « barDelegate ».
Funciones de acceso:
| bool | labelsVisible() const |
| void | setLabelsVisible(bool visible = true) |
Señal de notificación:
| void | labelsVisibleChanged(bool visible) |
Véase también « barDelegate ».
seriesColors : QList<QColor>
Esta propiedad contiene la lista de colores base que se utilizarán para todos los objetos de la serie.
Si hay más series que colores, la lista de colores se reinicia y vuelve a empezar por el primer color de la lista. Si no se configura (valor por defecto), se utilizarán los colores de QGraphsTheme::seriesColors.
Funciones de acceso:
| QList<QColor> | seriesColors() const |
| void | setSeriesColors(const QList<QColor> &newSeriesColors) |
Señal de notificación:
| void | seriesColorsChanged() |
Documentación de funciones de miembro
[explicit] QBarSeries::QBarSeries(QObject *parent = nullptr)
Crea una serie de barras vacía que es un « QObject » y un elemento secundario de « parent ».
[invokable] bool QBarSeries::append(QBarSet *set)
Añade un conjunto de barras especificado por ` set ` a la serie de barras y asume la propiedad de la misma. Si el conjunto es nulo o ya pertenece a la serie, no se añadirá. Devuelve ` true ` si la operación de añadir se ha realizado correctamente.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] bool QBarSeries::append(const QList<QBarSet *> &sets)
Añade una lista de conjuntos de barras especificados por sets a una serie de barras y asume la propiedad de dichos conjuntos. Devuelve « true » si todos los conjuntos se han añadido correctamente. Si alguno de los conjuntos es nulo o ya se había añadido previamente a la serie, no se añade nada y esta función devuelve « false ». Si alguno de los conjuntos aparece más de una vez en la lista, no se añade nada y esta función devuelve « false ».
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] QBarSet *QBarSeries::at(qsizetype index)
Recupera el objeto « BarSet » especificado en la ubicación index. Devuelve «null» si no se ha encontrado ningún objeto « BarSet ».
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
QList<QBarSet *> QBarSeries::barSets() const
Devuelve una lista de conjuntos de barras de una serie de barras. Mantiene la propiedad de los conjuntos de barras.
Nota: Funcióngetter para la propiedad barSets.
qreal QBarSeries::barWidth() const
Devuelve el ancho de las barras de la serie.
Nota: Funcióngetter para la propiedad barWidth.
Véase también setBarWidth().
[signal] void QBarSeries::barsetsAdded(const QList<QBarSet *> &sets)
Esta señal se emite cuando se añaden a la serie las barras especificadas en sets.
Véase también append() y insert().
[signal] void QBarSeries::barsetsRemoved(const QList<QBarSet *> &sets)
Esta señal se emite cuando las barras especificadas en sets se eliminan de la serie.
Véase también remove().
[invokable] void QBarSeries::clear()
Elimina todos los conjuntos de barras de la serie y los borra de forma permanente.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] qsizetype QBarSeries::count() const
Devuelve el número de conjuntos de barras de una serie 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] qsizetype QBarSeries::find(QBarSet *set) const
Devuelve el índice del primer « BarSet » encontrado, tal y como se define en set. Devuelve -1 si no se ha encontrado ningún « BarSet ».
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] bool QBarSeries::insert(qsizetype index, QBarSet *set)
Inserta un conjunto de barras especificado por ` set ` en una serie, en la posición indicada por ` index `, y asume la propiedad del conjunto. Si el conjunto es nulo o ya pertenece a la serie, no se añadirá. Devuelve ` true ` si la inserción se realiza correctamente.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
bool QBarSeries::labelsVisible() const
Devuelve la visibilidad de las etiquetas.
Nota: Funcióngetter para la propiedad labelsVisible.
Véase también setLabelsVisible().
[signal] void QBarSeries::labelsVisibleChanged(bool visible)
Esta señal se emite cuando la visibilidad de las etiquetas cambia a « visible ».
Nota: Señalde notificador para la propiedad labelsVisible.
Véase también labelsVisible() y setLabelsVisible().
[invokable] bool QBarSeries::remove(QBarSet *set)
Elimina el conjunto de barras especificado por ` set ` de la serie y lo borra definitivamente si la eliminación se realiza con éxito. Devuelve ` true ` si se ha eliminado el conjunto.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] bool QBarSeries::remove(qsizetype index)
Elimina el objeto « BarSet » de la ubicación index. El objeto « BarSet » se eliminará de forma definitiva.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QBarSeries::removeMultiple(qsizetype index, qsizetype count)
Elimina varios BarSets de la serie, desde el index hasta el número indicado en count. Los BarSets se eliminarán de forma permanente.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] bool QBarSeries::replace(const QList<QBarSet *> &sets)
Sustituye toda la lista « BarSet » contenida en este « BarSeries » por los «BarSets» especificados en « sets ». Todos los «BarSets» originales se eliminarán de forma permanente. Devuelve « true » si se sustituyen todos los «BarSets».
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] bool QBarSeries::replace(QBarSet *oldValue, QBarSet *newValue)
Sustituye el « BarSet » especificado en oldValue por el de newValue. El « BarSet » de oldValue se eliminará de forma definitiva si se encuentra dentro de la serie. Devuelve true si la sustitución se realiza correctamente.
Nota: Esta función se puede invocar a través del sistema de metaojetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QBarSeries::replace(qsizetype index, QBarSet *set)
Sustituye la página « BarSet », disponible en index, por set. La página original BarSet se eliminará definitivamente.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
void QBarSeries::setBarWidth(qreal width)
Establece el ancho de las barras de la serie en width.
Nota: Funciónde configuración para la propiedad barWidth.
Véase también ` barWidth()`.
void QBarSeries::setLabelsVisible(bool visible = true)
Establece la visibilidad de las etiquetas de una serie de barras en « visible ».
Nota: Funciónde configuración para la propiedad ` labelsVisible`.
Véase también ` labelsVisible()`.
[signal] void QBarSeries::setValueAdded(qsizetype index, qsizetype count, QBarSet *barset)
Esta señal se emite cuando se modifica el valor de un conjunto de barras. ` index ` es el índice del conjunto de barras en la serie. El número de valores añadidos se indica en ` count`. ` barset ` es un puntero al conjunto modificado.
[signal] void QBarSeries::setValueChanged(qsizetype index, QBarSet *barset)
Esta señal se emite cuando se modifica el valor de un conjunto de barras. ` index ` es el índice del conjunto de barras en la serie. ` barset ` es un puntero al conjunto modificado.
[signal] void QBarSeries::setValueRemoved(qsizetype index, qsizetype count, QBarSet *barset)
Esta señal se emite cuando se modifica el valor de un conjunto de barras. ` index ` es el índice del conjunto de barras en la serie. El número de valores eliminados se indica en ` count`. ` barset ` es un puntero al conjunto modificado.
[invokable] bool QBarSeries::take(QBarSet *set)
Selecciona un único « set » de la serie. No elimina el objeto «bar set».
Nota: La serie sigue siendo el objeto padre del conjunto de barras. Debes establecer el objeto padre para que asuma la propiedad total.
Devuelve un ` true ` si la operación «take» se realiza correctamente.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[override virtual] QAbstractSeries::SeriesType QBarSeries::type() const
Reimplementa una función de acceso para la propiedad: QAbstractSeries::type.
Devuelve la serie de barras.
[signal] void QBarSeries::updatedBars()
Esta señal se emite cuando se actualizan las barras.
© 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.