En esta página

BarSeries QML Type

Muestra los datos en gráficos de barras. Más...

Import Statement: import QtGraphs
In C++: QBarSeries
Inherits:

AbstractSeries

Propiedades

Señales

Métodos

Descripción detallada

Por defecto, representa los datos 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.

Documentación de propiedades

barDelegate : Component

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
colorbarColorEl color de relleno de la barra. Este valor procede bien de GraphsTheme o bien de BarSet::color si BarSet anula el color.
colorbarBorderColorEl color del borde de la barra. Este valor procede de GraphsTheme o de BarSet::borderColor si BarSet anula el color.
realbarBorderWidthEl ancho del borde de la barra. Este valor procede de GraphsTheme o de BarSet::borderWidth si BarSet anula el ancho.
realbarValueEl valor de la barra. Este valor procede de BarSet::values.
cadenabarLabelLa etiqueta de la barra. Este valor procede de BarSet::label.
boolbarSelectedEste valor es «true» cuando la barra está seleccionada, lo que significa que el índice de la barra se encuentra en BarSet::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 estas propiedades, añade una propiedad con el nombre definido a tu componente personalizado. Por ejemplo, "property color barColor" y "property real barValue".

barSets : list<BarSet> [read-only]

Una lista de los conjuntos añadidos a la serie.

barWidth : real

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.

Por defecto, el valor de 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 el tipo « BarSeries », este valor especifica el ancho de un grupo de barras en lugar del de una sola barra.

barsType : enumeration

El tipo de la serie de barras:

ConstanteDescripción
BarSeries.BarsType.GroupsLos conjuntos de barras se agrupan por categoría. Este es el valor predeterminado.
BarSeries.BarsType.StackedLos conjuntos de barras se apilan uno tras otro por categoría.
BarSeries.BarsType.StackedPercentLos 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.

borderColors : list<color>

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 empezar por el primer color de la lista. Si no se especifica (valor por defecto), se utilizarán los colores de la lista « GraphsTheme::borderColors ».

count : int [read-only]

El número de conjuntos de barras que hay en una serie de barras.

labelsAngle : real

El ángulo de las etiquetas de valores en grados.

labelsFormat : string

El formato utilizado para mostrar las etiquetas en una serie de barras.

Véase también QBarSeries::labelsFormat, labelsVisible y labelsPosition.

labelsMargin : real

El margen de las etiquetas de valores en píxeles.

Este margen lateral se utiliza cuando la opción « labelsPosition » está configurada en un valor distinto de « LabelsPosition.Center ». El valor por defecto es « 0 ».

labelsPosition : enumeration

La posición de las etiquetas de los valores de los datos:

ConstanteDescripción
BarSeries.LabelsPosition.CenterLa etiqueta se encuentra en el centro de la barra.
BarSeries.LabelsPosition.InsideEndLa etiqueta se encuentra en la parte superior, dentro de la barra.
BarSeries.LabelsPosition.InsideBaseLa etiqueta se encuentra dentro de la barra, en la parte inferior.
BarSeries.LabelsPosition.OutsideEndLa etiqueta se encuentra fuera de la barra, en la parte superior.

Véase también labelsVisible y labelsFormat.

labelsPrecision : real

El número máximo de dígitos significativos que se muestran en las etiquetas de valor.

El valor por defecto es 6.

labelsVisible : bool

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.

Véase también « barDelegate ».

seriesColors : list<color>

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 GraphsTheme::seriesColors.

Documentación de Signal

barsetsAdded()

Esta señal se emite cuando se añaden conjuntos de barras a la serie.

Nota: El controlador correspondiente es onBarsetsAdded.

barsetsRemoved()

Esta señal se emite cuando se eliminan conjuntos de barras de la serie.

Nota: El controlador correspondiente es onBarsetsRemoved.

clicked(int index, BarSet barset)

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

Nota: El controlador correspondiente es onClicked.

doubleClicked(int index, BarSet barset)

Esta señal se emite cuando el usuario hace doble clic o doble toque en la barra especificada por index dentro del conjunto de barras especificado por barset. Esta señal siempre se produce después de clicked.

Nota: El controlador correspondiente es onDoubleClicked.

pressed(int index, BarSet barset)

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

Nota: El controlador correspondiente es onPressed.

released(int index, BarSet barset)

Esta señal se emite cuando el usuario suelta un botón del ratón que había pulsado previamente o realiza un gesto en la barra especificada por index, dentro del conjunto de barras especificado por barset.

Nota: El controlador correspondiente es onReleased.

Documentación del método

bool append(BarSet barset)

Añade un conjunto de barras especificado por ` barset ` 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 adición se ha realizado correctamente.

Véase también insert().

BarSet at(int index)

Devuelve el conjunto de barras establecido en index. Devuelve null si el índice no es válido.

Barset at(int index)

Devuelve el conjunto de barras especificado por ` index ` de la serie. En caso contrario, devuelve ` null `.

void clear()

Elimina todos los conjuntos de barras de la serie.

int find(BarSet barset)

Devuelve el índice del conjunto de barras especificado por « barset » de la serie. Devuelve « -1 » si no se encuentra.

BarSet insert(int index, BarSet barset)

Inserta un conjunto de barras especificado en barset en una serie, en la posición indicada en index. Si el conjunto es null o ya forma parte de la serie, no se añade. Devuelve true si la inserción se realiza correctamente.

Véase también append().

bool remove(BarSet barset)

Elimina de la serie el conjunto de barras especificado por ` barset `. Devuelve ` true ` si la operación se realiza correctamente, y ` false ` en caso contrario.

bool remove(int index)

Elimina de la serie el conjunto de barras especificado por ` index `. Devuelve ` true ` si la eliminación se ha realizado correctamente y ` false ` en caso contrario.

void removeMultiple(int index, int count)

Elimina un conjunto de conjuntos de barras según lo especificado en index y count. La llamada recorre todos los conjuntos, incluso si falla la eliminación de uno de ellos.

bool replace(list<BarSet> sets)

Sustituye por completo todo el conjunto de barras actual por el de sets. No es necesario que el tamaño coincida. Devuelve «false» si alguna de las barras del conjunto de sets no es válida.

bool replace(BarSet oldSet, BarSet newSet)

Sustituye el conjunto de barras especificado por « oldSet » por «newSet». Devuelve « true » si la eliminación se ha realizado correctamente; en caso contrario, devuelve « false ». « oldSet » se elimina si la operación se ha realizado correctamente.

bool replace(int index, BarSet barset)

Sustituye la barra situada en la posición especificada por ` index ` de la serie y la reemplaza por ` barset`. Devuelve ` true ` si la operación se realiza correctamente, y ` false ` en caso contrario.

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