En esta página

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

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:

ConstanteValorDescripción
QBarSeries::BarsType::Groups0Los conjuntos de barras se agrupan por categoría.
QBarSeries::BarsType::Stacked1Los conjuntos de barras se apilan uno tras otro por categoría.
QBarSeries::BarsType::StackedPercent2Los 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:

ConstanteValorDescripción
QBarSeries::LabelsPosition::Center0La etiqueta se encuentra en el centro de la barra.
QBarSeries::LabelsPosition::InsideEnd1La etiqueta se encuentra dentro de la barra, en la parte superior.
QBarSeries::LabelsPosition::InsideBase2La etiqueta se encuentra en la parte inferior de la barra.
QBarSeries::LabelsPosition::OutsideEnd3La 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:

TipoNombreDescripción
QColorbarColorEl color de relleno de la barra. Este valor procede de la propiedad « QGraphsTheme » o de « QBarSet::color » si la propiedad « QBarSet » anula el color.
QColorbarBorderColorEl color del borde de la barra. Este valor procede de QGraphsTheme o de QBarSet::borderColor si QBarSet anula el color.
qrealbarBorderWidthEl ancho del borde de la barra. Este valor procede de QGraphsTheme o de QBarSet::borderWidth si QBarSet anula el ancho.
qrealbarValueEl valor de la barra. Este valor procede de QBarSet::values.
QStringbarLabelLa etiqueta de la barra. Este valor procede de QBarSet::label.
boolbarSelectedEste valor es «true» cuando la barra está seleccionada, lo que significa que el índice de la barra está en QBarSet::selectedBars.
intbarIndexÍ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:

@valueEl 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.