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.

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:
| Constante | Valor | Descripción |
|---|---|---|
QAbstractBarSeries::LabelsCenter | 0 | La etiqueta se encuentra en el centro de la barra. |
QAbstractBarSeries::LabelsInsideEnd | 1 | La etiqueta se encuentra dentro de la barra, en la parte superior. |
QAbstractBarSeries::LabelsInsideBase | 2 | La etiqueta se encuentra en la parte inferior de la barra. |
QAbstractBarSeries::LabelsOutsideEnd | 3 | La 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:
| @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 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:
| void | labelsVisibleChanged() |
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.