En esta página

QAbstractBarSeries Class

La clase `QAbstractBarSeries` es una clase padre abstracta para todas las clases de series de barras. Más información...

Header: #include <QAbstractBarSeries>
In QML: AbstractBarSeries
Inherits: QAbstractSeries
Inherited By:

QBarSeries, QHorizontalBarSeries, QHorizontalPercentBarSeries, QHorizontalStackedBarSeries, QPercentBarSeries, and QStackedBarSeries

Status: Deprecated

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Tipos públicos

enum LabelsPosition { LabelsCenter, LabelsInsideEnd, LabelsInsideBase, LabelsOutsideEnd }

Propiedades

Funciones públicas

virtual ~QAbstractBarSeries()
bool append(QBarSet *set)
bool append(const QList<QBarSet *> &sets)
QList<QBarSet *> barSets() const
qreal barWidth() const
void clear()
int count() const
bool insert(int index, QBarSet *set)
bool isLabelsVisible() const
qreal labelsAngle() const
QString labelsFormat() const
QAbstractBarSeries::LabelsPosition labelsPosition() const
int labelsPrecision() const
bool remove(QBarSet *set)
void setBarWidth(qreal width)
void setLabelsAngle(qreal angle)
void setLabelsFormat(const QString &format)
void setLabelsPosition(QAbstractBarSeries::LabelsPosition position)
void setLabelsPrecision(int precision)
void setLabelsVisible(bool visible = true)
bool take(QBarSet *set)

Señales

void barsetsAdded(const QList<QBarSet *> &sets)
void barsetsRemoved(const QList<QBarSet *> &sets)
void clicked(int index, QBarSet *barset)
void countChanged()
void doubleClicked(int index, QBarSet *barset)
void hovered(bool status, int index, QBarSet *barset)
void labelsAngleChanged(qreal angle)
void labelsFormatChanged(const QString &format)
void labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)
void labelsPrecisionChanged(int precision)
void labelsVisibleChanged()
void pressed(int index, QBarSet *barset)
void released(int index, QBarSet *barset)

Descripción detallada

En los gráficos de barras, las barras se definen como conjuntos de barras que contienen un valor de datos para cada categoría. La posición de una barra viene determinada por la categoría y su altura, por el valor de datos. Las series de barras que contienen varios conjuntos de barras agrupan las barras que pertenecen a la misma categoría. La forma en que se muestran las barras viene determinada por la subclase de esta clase elegida para crear el gráfico de barras.

Si se utiliza una clase « QValueAxis » en lugar de « QBarCategoryAxis » para el eje principal de barras, estas se agrupan en torno al valor de índice de la categoría.

Consulta la Galería de gráficos con widgets para aprender a utilizar la clase ` QBarSeries ` para crear un gráfico de barras sencillo.

Gráfico de barras verticales que agrupa los valores mensuales de cinco personas, de enero a junio

Véase también QBarSet, QBarSeries, QStackedBarSeries, QPercentBarSeries, QHorizontalBarSeries, QHorizontalStackedBarSeries y QHorizontalPercentBarSeries.

Documentación sobre los tipos de miembros

enum QAbstractBarSeries::LabelsPosition

Este valor de enumeración describe la posición de las etiquetas de los valores de datos:

ConstanteValorDescripción
QAbstractBarSeries::LabelsCenter0La etiqueta se encuentra en el centro de la barra.
QAbstractBarSeries::LabelsInsideEnd1La etiqueta se encuentra dentro de la barra, en la parte superior.
QAbstractBarSeries::LabelsInsideBase2La etiqueta se encuentra en la parte inferior de la barra.
QAbstractBarSeries::LabelsOutsideEnd3La etiqueta se encuentra fuera de la barra, en la parte superior.

Documentación de la propiedad

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

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 Access:

qreal barWidth() const
void setBarWidth(qreal width)

Véase también QBarSeries.

[read-only] count : int

Esta propiedad indica el número de conjuntos de barras que hay en una serie de barras.

Funciones de acceso:

int count() const

Señal de notificación:

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 utilizado para mostrar las etiquetas en una serie de barras.

QAbstractBarSeries 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 Access:

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.

labelsPosition : LabelsPosition

Esta propiedad determina la posición de las etiquetas de valores.

Funciones de acceso:

QAbstractBarSeries::LabelsPosition labelsPosition() const
void setLabelsPosition(QAbstractBarSeries::LabelsPosition position)

Señal de notificación:

void labelsPositionChanged(QAbstractBarSeries::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 controla la visibilidad de las etiquetas en una serie de barras.

Funciones de acceso:

bool isLabelsVisible() const
void setLabelsVisible(bool visible = true)

Señal de notificador:

Documentación de funciones de miembro

[virtual noexcept] QAbstractBarSeries::~QAbstractBarSeries()

Elimina la serie de barras abstracta y los conjuntos de barras que le pertenecen.

bool QAbstractBarSeries::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.

bool QAbstractBarSeries::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 ».

QList<QBarSet *> QAbstractBarSeries::barSets() const

Devuelve una lista de conjuntos de barras de una serie de barras. Mantiene la propiedad de los conjuntos de barras.

qreal QAbstractBarSeries::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 QAbstractBarSeries::barsetsAdded(const QList<QBarSet *> &sets)

Esta señal se emite cuando se añaden a la serie los intervalos especificados en sets.

Véase también « append()» y « insert()».

[signal] void QAbstractBarSeries::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().

void QAbstractBarSeries::clear()

Elimina todos los conjuntos de barras de la serie y los borra de forma definitiva.

[signal] void QAbstractBarSeries::clicked(int index, QBarSet *barset)

Esta señal se emite cuando el usuario hace clic en la barra especificada por index dentro del conjunto de barras especificado por barset.

int QAbstractBarSeries::count() const

Devuelve el número de conjuntos de barras de una serie de barras.

Nota: Funcióngetter para la propiedad «count».

[signal] void QAbstractBarSeries::countChanged()

Esta señal se emite cuando se modifica el número de conjuntos de barras, por ejemplo, mediante append() o remove().

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

[signal] void QAbstractBarSeries::doubleClicked(int index, QBarSet *barset)

Esta señal se emite cuando el usuario hace doble clic en la barra especificada por index dentro del conjunto de barras especificado por barset.

[signal] void QAbstractBarSeries::hovered(bool status, int index, QBarSet *barset)

Esta señal se emite cuando se pasa el ratón por encima de la barra especificada por index dentro del conjunto de barras especificado por barset. Cuando el ratón se desplaza sobre la barra, status cambia a true, y cuando el ratón se aleja de nuevo, cambia a false.

bool QAbstractBarSeries::insert(int 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 de dicho 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.

bool QAbstractBarSeries::isLabelsVisible() const

Devuelve la visibilidad de las etiquetas.

Nota: Funcióngetter para la propiedad « labelsVisible ».

[signal] void QAbstractBarSeries::labelsAngleChanged(qreal angle)

Esta señal se emite cuando cambia la propiedad « angle » de las etiquetas de valor.

Nota: Señalde notificación para la propiedad « labelsAngle ».

[signal] void QAbstractBarSeries::labelsFormatChanged(const QString &format)

Esta señal se emite cuando cambia el valor de la propiedad « format » de las etiquetas de datos.

Nota: Señalde notificación para la propiedad « labelsFormat ».

[signal] void QAbstractBarSeries::labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)

Esta señal se emite cuando cambia la propiedad « position » de las etiquetas de valor.

Nota: Señalde notificación para la propiedad « labelsPosition ».

[signal] void QAbstractBarSeries::labelsPrecisionChanged(int precision)

Esta señal se emite cuando cambia la propiedad « precision » de las etiquetas de valor.

Nota: Señalde notificación para la propiedad « labelsPrecision ».

[signal] void QAbstractBarSeries::labelsVisibleChanged()

Esta señal se emite cuando cambia la visibilidad de las etiquetas.

Nota: Señalde notificador para la propiedad ` labelsVisible`.

Véase también ` isLabelsVisible()` y ` setLabelsVisible()`.

[signal] void QAbstractBarSeries::pressed(int index, QBarSet *barset)

Esta señal se emite cuando el usuario hace clic en la barra especificada por « index » dentro del conjunto de barras especificado por « barset » y mantiene pulsado el botón del ratón.

[signal] void QAbstractBarSeries::released(int index, QBarSet *barset)

Esta señal se emite cuando el usuario suelta el botón del ratón sobre la barra especificada por index en el conjunto de barras especificado por barset.

bool QAbstractBarSeries::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.

void QAbstractBarSeries::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 QAbstractBarSeries::setLabelsVisible(bool visible = true)

Establece la visibilidad de las etiquetas de una serie de barras en « visible ».

Nota: Funciónde asignación para la propiedad « labelsVisible ».

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

bool QAbstractBarSeries::take(QBarSet *set)

Selecciona un único conjunto de barras ( 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 ` true ` si la operación de toma se realiza correctamente.

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