QBarSeries Class
La clase QBarSeries presenta los datos en gráficos de barras. Más...
| Cabecera: | #include <QBarSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| En QML: | BarSeries |
| Hereda: | QAbstractSeries |
- Lista de todos los miembros, incluyendo los heredados
- QBarSeries es parte de Qt Graphs C++ Classes for 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 dibuja los datos por defecto como una serie de barras agrupadas por categoría, con una barra por categoría de cada conjunto de barras añadido a la serie. También soporta barras horizontales y barras agrupadas como apiladas.
GraphsView Una serie de barras necesita que el eje x se establezca en BarCategoryAxis y el eje y en ValueAxis.
Véase también QBarSet y QAbstractSeries.
Documentación de tipos de miembros
enum class QBarSeries::BarsType
Este valor enum describe el tipo de la serie de barras:
| Constante | Valor | Descripción |
|---|---|---|
QBarSeries::BarsType::Groups | 0 | Las series de barras se agrupan por categoría. |
QBarSeries::BarsType::Stacked | 1 | Las series de barras se apilan una tras otra por categoría. |
QBarSeries::BarsType::StackedPercent | 2 | Los conjuntos de barras se apilan uno tras otro por categoría. El tamaño del segmento corresponde al porcentaje del valor del segmento comparado con el valor total de todos los segmentos de la pila. |
enum class QBarSeries::LabelsPosition
Este valor enum describe la posición de las etiquetas de los valores de datos:
| Constante | Valor | Descripción |
|---|---|---|
QBarSeries::LabelsPosition::Center | 0 | La etiqueta está situada en el centro de la barra. |
QBarSeries::LabelsPosition::InsideEnd | 1 | La etiqueta está situada en la parte superior de la barra. |
QBarSeries::LabelsPosition::InsideBase | 2 | La etiqueta está situada en la parte inferior de la barra. |
QBarSeries::LabelsPosition::OutsideEnd | 3 | La etiqueta está situada fuera de la barra en la parte superior. |
Documentación de propiedades
barDelegate : QQmlComponent*
Esta propiedad contiene un componente QML personalizado utilizado 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 rectangular por defecto 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 QGraphsTheme o de QBarSet::color si QBarSet anula el color. |
| QColor | barBorderColor | Color del borde de la barra. Este valor procede de QGraphsTheme o de QBarSet::borderColor si QBarSet anula el color. |
| qreal | barBorderWidth | Anchura del borde de la barra. Este valor procede de QGraphsTheme o de QBarSet::borderWidth si QBarSet anula la anchura. |
| qreal | barValue | Valor de la barra. Este valor proviene de QBarSet::values. |
| QString | barLabel | La etiqueta de la barra. Este valor procede de QBarSet::label. |
| bool | barSelected | Este valor es verdadero cuando la barra está seleccionada, lo que significa que el índice de la barra está en QBarSet::selectedBars. |
| int | barIndex | Índice de la barra, de 0 a la cantidad de barras - 1. [desde 6.9] |
Para utilizar cualquiera de ellas, añada la propiedad con el nombre definido en su componente personalizado. Por ejemplo "property color barColor" y "property real barValue".
Funciones de acceso:
| QQmlComponent * | barDelegate() const |
| void | setBarDelegate(QQmlComponent *newBarDelegate) |
Notificador de señal:
| void | barDelegateChanged() |
[read-only] barSets : QList<QBarSet *>
Esta propiedad contiene una lista de conjuntos añadidos a la serie.
Funciones de acceso:
| QList<QBarSet *> | barSets() const |
Señal del notificador:
| void | barSetsChanged() |
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.
Por defecto, el barWidth es 0.5 (las barras ocuparán el 50% del ancho disponible). Los valores válidos van de 0.0 (0%) a 1.0 (100%).
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) |
Señal del notificador:
| void | barWidthChanged() |
Véase también QBarSeries.
barsType : BarsType
Esta propiedad contiene el tipo de la serie de barras.
Funciones de acceso:
| QBarSeries::BarsType | barsType() const |
| void | setBarsType(QBarSeries::BarsType type) |
Señal del notificador:
| 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 envuelve y comienza de nuevo con el primer color de la lista. Si no se establece (por defecto), se utilizarán los colores de QGraphsTheme::borderColors.
Funciones de acceso:
| QList<QColor> | borderColors() const |
| void | setBorderColors(const QList<QColor> &newBorderColors) |
Señal de aviso:
| void | borderColorsChanged() |
[read-only] count : qsizetype
Esta propiedad contiene el número de conjuntos de compases de una serie de compases.
Funciones de acceso:
| qsizetype | count() const | [see note below] |
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Señal de 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.
QBarSeries admite la siguiente etiqueta de formato:
| @valor | El 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.
labelsMargin : qreal
Esta propiedad contiene el margen de las etiquetas de valor en píxeles.
Este margen de lado se utiliza cuando labelsPosition se establece a algo distinto de LabelsPosition.Center. El valor por defecto es 0.
Funciones de acceso:
| qreal | labelsMargin() const |
| void | setLabelsMargin(qreal margin) |
Señal del notificador:
| void | labelsMarginChanged(qreal margin) |
labelsPosition : LabelsPosition
Esta propiedad contiene la posición de las etiquetas de valor.
Funciones de acceso:
| QBarSeries::LabelsPosition | labelsPosition() const |
| void | setLabelsPosition(QBarSeries::LabelsPosition position) |
Señal del notificador:
| void | labelsPositionChanged(QBarSeries::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 contiene la visibilidad de las etiquetas en una serie de barras. La visibilidad de la etiqueta por defecto es false.
Nota: La etiqueta por defecto sólo muestra el valor de la serie. Puede crear etiquetas personalizadas con un barDelegate.
Funciones de acceso:
| bool | labelsVisible() const |
| void | setLabelsVisible(bool visible = true) |
Señal de notificador:
| 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 envuelve y comienza de nuevo con el primer color de la lista. Si no se establece (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 aviso:
| void | seriesColorsChanged() |
Documentación de funciones miembro
[explicit] QBarSeries::QBarSeries(QObject *parent = nullptr)
Construye una serie de barras vacía que es QObject e hija de parent.
[invokable] bool QBarSeries::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 tuvo éxito.
Nota: Esta función puede invocarse 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 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.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] QBarSet *QBarSeries::at(qsizetype index)
Recupera el BarSet especificado en la ubicación index. Devuelve null si no se ha encontrado BarSet.
Nota: Esta función puede invocarse 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 compases de una serie de compases. Mantiene la propiedad de los conjuntos de barras.
Nota: Función Getter para la propiedad barSets.
qreal QBarSeries::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 QBarSeries::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 QBarSeries::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().
[invokable] void QBarSeries::clear()
Elimina todos los conjuntos de barras de la serie y los borra permanentemente.
Nota: Esta función puede invocarse 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 puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Nota: Función Getter 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 puede invocarse 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 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.
Nota: Esta función puede invocarse 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ón Getter 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ñal notificadora 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 elimina permanentemente si la eliminación tiene éxito. Devuelve true si se ha eliminado el conjunto.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] bool QBarSeries::remove(qsizetype index)
Elimina el BarSet en la ubicación index. El BarSet se eliminará de forma permanente.
Nota: Esta función puede invocarse 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 empezando por index hasta un número de count. Los BarSets se eliminarán permanentemente.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] bool QBarSeries::replace(const QList<QBarSet *> &sets)
Reemplaza toda la lista BarSet dentro de este BarSeries con los BarSets especificados por sets. Todos los BarSets originales se eliminarán permanentemente. Devuelve true si se han reemplazado todos los BarSets.
Nota: Esta función puede invocarse 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 por oldValue por el de newValue. El BarSet en oldValue será eliminado permanentemente si se encuentra dentro de la serie. Devuelve true si la sustitución tiene éxito.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QBarSeries::replace(qsizetype index, QBarSet *set)
Sustituye el BarSet presente en index por set. El BarSet original será eliminado permanentemente.
Nota: Esta función puede invocarse 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ón Setter 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ón Setter 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 barset. index es el índice del barset en la serie. El número de los valores añadidos se indica count. barset es un puntero al conjunto modificado.
[signal] void QBarSeries::setValueChanged(qsizetype index, QBarSet *barset)
Esta señal se emite cuando se cambia el valor de un barset. index es el índice del barset en la serie. barset es un puntero a la serie modificada.
[signal] void QBarSeries::setValueRemoved(qsizetype index, qsizetype count, QBarSet *barset)
Esta señal se emite cuando se modifica el valor de un barset. index es el índice del barset en la serie. El número de los valores eliminados se indica count. barset es un puntero al conjunto modificado.
[invokable] bool QBarSeries::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.
Nota: Esta función puede invocarse 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 a 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.
