Back to Qt.io
Contact Us Blog Download Qt
En esta página

QAbstractBarSeries Class

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

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

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

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 por cada categoría. La posición de una barra viene especificada por la categoría y su altura por el valor de los datos. Las series de barras que contienen varios conjuntos de barras agrupan 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 QValueAxis en lugar de QBarCategoryAxis para el eje de barras principal, las barras se agrupan en torno al valor índice de la categoría.

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

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

Documentación de tipos de miembros

enum QAbstractBarSeries::LabelsPosition

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

ConstanteValorDescripción
QAbstractBarSeries::LabelsCenter0La etiqueta está situada en el centro de la barra.
QAbstractBarSeries::LabelsInsideEnd1La etiqueta está situada en la parte superior de la barra.
QAbstractBarSeries::LabelsInsideBase2La etiqueta está situada en la parte inferior de la barra.
QAbstractBarSeries::LabelsOutsideEnd3La etiqueta está situada fuera de la barra en la parte superior.

Documentación de propiedades

barWidth : qreal

Esta propiedad contiene 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 tratan como cero. Establecer el ancho a cero significa que el ancho de la barra en la pantalla es de un píxel independientemente de la escala del eje x. Las barras más anchas que cero se escalan utilizando la escala del eje x.

Nota: Cuando se utiliza con QBarSeries, este valor especifica la anchura de un grupo de barras en lugar de la de una sola barra.

Funciones de acceso:

qreal barWidth() const
void setBarWidth(qreal width)

Véase también QBarSeries.

[read-only] count : int

Esta propiedad contiene el número de conjuntos de compases de una serie de compases.

Funciones de acceso:

int count() const

Señal del notificador:

void countChanged()

labelsAngle : qreal

Esta propiedad contiene el ángulo de las etiquetas de valor en grados.

Funciones de acceso:

qreal labelsAngle() const
void setLabelsAngle(qreal angle)

Señal del notificador:

void labelsAngleChanged(qreal angle)

labelsFormat : QString

Esta propiedad contiene el formato utilizado para mostrar las etiquetas en una serie de barras.

QAbstractBarSeries admite la siguiente etiqueta de formato:

@valorEl valor de la barra

Por ejemplo, el siguiente uso de las etiquetas de formato producirí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. Para 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 cerca unas de otras, las etiquetas pueden solaparse.

Funciones de acceso:

QString labelsFormat() const
void setLabelsFormat(const QString &format)

Señal del notificador:

void labelsFormatChanged(const QString &format)

Véase también labelsVisible, labelsPosition, y labelsPrecision.

labelsPosition : LabelsPosition

Esta propiedad contiene la posición de las etiquetas de valor.

Funciones de acceso:

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

Señal del notificador:

void labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)

Véase también labelsVisible y labelsFormat.

labelsPrecision : int

Esta propiedad contiene la cantidad máxima de dígitos significativos mostrados en las etiquetas de valor.

El valor por defecto es 6.

Funciones de acceso:

int labelsPrecision() const
void setLabelsPrecision(int precision)

Señal del notificador:

void labelsPrecisionChanged(int precision)

labelsVisible : bool

Esta propiedad mantiene la visibilidad de las etiquetas de una serie de barras.

Funciones de acceso:

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

Señal del notificador:

void labelsVisibleChanged()

Documentación de funciones miembro

[virtual noexcept] QAbstractBarSeries::~QAbstractBarSeries()

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

bool QAbstractBarSeries::append(QBarSet *set)

Añade un conjunto de barras especificado por set a la serie de barras y toma posesión de él. Si el conjunto es nulo o ya pertenece a la serie, no se añadirá. Devuelve true si la adición 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 toma posesión de los conjuntos. Devuelve true si todos los conjuntos se han añadido correctamente. Si alguno de los conjuntos es nulo o ha sido añadido previamente a la serie, no se añade nada y esta función devuelve false. Si alguno de los conjuntos aparece en la lista más de una vez, no se añade nada y esta función devuelve false.

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

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

qreal QAbstractBarSeries::barWidth() const

Devuelve el ancho de las barras de la serie.

Nota: Función Getter para la propiedad barWidth.

Véase también setBarWidth().

[signal] void QAbstractBarSeries::barsetsAdded(const QList<QBarSet *> &sets)

Esta señal se emite cuando los conjuntos de barras especificados por sets se añaden a la serie.

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

[signal] void QAbstractBarSeries::barsetsRemoved(const QList<QBarSet *> &sets)

Esta señal se emite cuando los conjuntos de barras especificados por sets se eliminan de la serie.

Véase también remove().

void QAbstractBarSeries::clear()

Elimina todos los conjuntos de compases de la serie y los borra permanentemente.

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

Esta señal se emite cuando el usuario hace clic en la barra especificada por index en el 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ón Getter 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ñal notificadora 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 en el 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 en el conjunto de barras especificado por barset. Cuando el ratón se mueve sobre la barra, status se convierte en true, y cuando el ratón se aleja de nuevo, se convierte en false.

bool QAbstractBarSeries::insert(int index, QBarSet *set)

Inserta un conjunto de barras especificado por set a una serie en la posición especificada por index y toma posesión del conjunto. Si el conjunto es nulo o ya pertenece a la serie, no se añadirá. Devuelve true si la inserción tiene éxito.

bool QAbstractBarSeries::isLabelsVisible() const

Devuelve la visibilidad de las etiquetas.

Nota: Función Getter para la propiedad labelsVisible.

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

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

Nota: Señal notificadora para la propiedad labelsAngle.

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

Esta señal se emite cuando cambia la format de etiquetas de valores de datos.

Nota: Señal notificadora para la propiedad labelsFormat.

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

Esta señal se emite cuando cambia el position de las etiquetas de valor.

Nota: Señal notificadora para la propiedad labelsPosition.

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

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

Nota: Señal notificadora para la propiedad labelsPrecision.

[signal] void QAbstractBarSeries::labelsVisibleChanged()

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

Nota: Señal notificadora 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 en el 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 la presió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 elimina permanentemente si la eliminación tiene é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ón Setter 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ón Setter para la propiedad labelsVisible.

Véase también isLabelsVisible().

bool QAbstractBarSeries::take(QBarSet *set)

Toma un único set de la serie. No borra el objeto conjunto de barras.

Nota: La serie sigue siendo el objeto padre del conjunto de compases. Debe establecer el objeto padre para tomar la propiedad completa.

Devuelve true si la operación de toma tiene éxito.

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