BarSeries QML Type
Muestra los datos en gráficos de barras. Más...
| Import Statement: | import QtGraphs |
| In C++: | QBarSeries |
| Inherits: |
- Lista de todos los miembros, incluidos los miembros heredados
- BarSeries forma parte de «Qt Graphs » (Tipos QML para 2D).
Propiedades
- barDelegate : Component
- barSets : list<BarSet>
- barWidth : real
- barsType : enumeration
- borderColors : list<color>
- count : int
- labelsAngle : real
- labelsFormat : string
- labelsMargin : real
- labelsPosition : enumeration
- labelsPrecision : real
- labelsVisible : bool
- seriesColors : list<color>
Señales
- barsetsAdded()
- barsetsRemoved()
- clicked(int index, BarSet barset)
- doubleClicked(int index, BarSet barset)
- pressed(int index, BarSet barset)
- released(int index, BarSet barset)
Métodos
- bool append(BarSet barset)
- BarSet at(int index)
- Barset at(int index)
- void clear()
- int find(BarSet barset)
- BarSet insert(int index, BarSet barset)
- bool remove(BarSet barset)
- bool remove(int index)
- void removeMultiple(int index, int count)
- bool replace(list<BarSet> sets)
- bool replace(BarSet oldSet, BarSet newSet)
- bool replace(int index, BarSet barset)
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:
| Tipo | Nombre | Descripción |
|---|---|---|
| color | barColor | El color de relleno de la barra. Este valor procede bien de GraphsTheme o bien de BarSet::color si BarSet anula el color. |
| color | barBorderColor | El color del borde de la barra. Este valor procede de GraphsTheme o de BarSet::borderColor si BarSet anula el color. |
| real | barBorderWidth | El ancho del borde de la barra. Este valor procede de GraphsTheme o de BarSet::borderWidth si BarSet anula el ancho. |
| real | barValue | El valor de la barra. Este valor procede de BarSet::values. |
| cadena | barLabel | La etiqueta de la barra. Este valor procede de BarSet::label. |
| bool | barSelected | Este valor es «true» cuando la barra está seleccionada, lo que significa que el índice de la barra se encuentra en BarSet::selectedBars. |
| int | barIndex | Í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:
| Constante | Descripción |
|---|---|
BarSeries.BarsType.Groups | Los conjuntos de barras se agrupan por categoría. Este es el valor predeterminado. |
BarSeries.BarsType.Stacked | Los conjuntos de barras se apilan uno tras otro por categoría. |
BarSeries.BarsType.StackedPercent | Los 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:
| Constante | Descripción |
|---|---|
BarSeries.LabelsPosition.Center | La etiqueta se encuentra en el centro de la barra. |
BarSeries.LabelsPosition.InsideEnd | La etiqueta se encuentra en la parte superior, dentro de la barra. |
BarSeries.LabelsPosition.InsideBase | La etiqueta se encuentra dentro de la barra, en la parte inferior. |
BarSeries.LabelsPosition.OutsideEnd | La 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.