BarSeries QML Type
Presenta los datos en gráficos de barras. Más...
| Import Statement: | import QtGraphs |
| In C++: | QBarSeries |
| Inherits: |
- Lista de todos los miembros, incluidos los heredados
- BarSeries es parte de Qt Graphs QML Types for 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
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 admite barras horizontales y barras agrupadas como apiladas.
Documentación de propiedades
barDelegate : Component
Un componente QML personalizado utilizado para visualizar cada una de las barras. Se crea una instancia de este componente para cada una de las barras. 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 |
|---|---|---|
| color | barColor | El color de relleno de la barra. Este valor proviene de GraphsTheme o de BarSet::color si BarSet anula el color. |
| color | barBorderColor | Color del borde de la barra. Este valor proviene de GraphsTheme o de BarSet::borderColor si BarSet anula el color. |
| real | barBorderWidth | Anchura del borde de la barra. Este valor procede de GraphsTheme o de BarSet::borderWidth si BarSet anula la anchura. |
| real | barValue | Valor de la barra. Este valor proviene de BarSet::values. |
| cadena | barLabel | La etiqueta de la barra. Este valor procede de BarSet::label. |
| bool | barSelected | Este valor es verdadero cuando la barra está seleccionada, lo que significa que el índice de la barra está en BarSet::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".
barSets : list<BarSet> [read-only]
Una lista de los decorados añadidos a la serie.
barWidth : real
La unidad de anchura es la unidad del eje x. La anchura mínima para las barras es cero, y los valores negativos se tratan como cero. Establecer la anchura a cero significa que la anchura 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 el tipo BarSeries, este valor especifica la anchura de un grupo de barras en lugar de la de una sola barra.
barsType : enumeration
El tipo de la serie de barras:
| Constante | Descripción |
|---|---|
BarSeries.BarsType.Groups | Las series de barras se agrupan por categoría. Este es el valor por defecto. |
BarSeries.BarsType.Stacked | Las series de barras se apilan una tras otra por categoría. |
BarSeries.BarsType.StackedPercent | 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. |
borderColors : list<color>
La lista de colores de borde que se utilizará 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 GraphsTheme::borderColors.
count : int [read-only]
El número de juegos de compases de una serie de compases.
labelsAngle : real
El ángulo de las etiquetas de valor en grados.
labelsFormat : string
Formato utilizado para mostrar etiquetas en una serie de barras.
Véase también QBarSeries::labelsFormat, labelsVisible, y labelsPosition.
labelsMargin : real
El margen de las etiquetas de valor en píxeles.
Este margen de lado se utiliza cuando labelsPosition se establece en algo distinto de LabelsPosition.Center. El valor predeterminado es 0.
labelsPosition : enumeration
Posición de las etiquetas de los valores de los datos:
| Constante | Descripción |
|---|---|
BarSeries.LabelsPosition.Center | La etiqueta está situada en el centro de la barra. |
BarSeries.LabelsPosition.InsideEnd | La etiqueta se encuentra en la parte superior de la barra. |
BarSeries.LabelsPosition.InsideBase | La etiqueta está situada en la parte inferior de la barra. |
BarSeries.LabelsPosition.OutsideEnd | La etiqueta está situada fuera de la barra en la parte superior. |
Véase también labelsVisible y labelsFormat.
labelsPrecision : real
La cantidad máxima de dígitos significativos mostrados 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 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 barDelegate.
Véase también barDelegate.
seriesColors : list<color>
La lista de colores base a utilizar 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 GraphsTheme::seriesColors.
Documentación de la señal
barsetsAdded()
Esta señal se emite cuando se añaden conjuntos de barras a la serie.
Nota: El manejador correspondiente es onBarsetsAdded.
barsetsRemoved()
Esta señal se emite cuando se eliminan conjuntos de barras de la serie.
Nota: El manejador correspondiente es onBarsetsRemoved.
clicked(int index, BarSet barset)
Esta señal se emite cuando el usuario hace clic o toca la barra especificada por index en el conjunto de barras especificado por barset.
Nota: El manejador 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 en el conjunto de barras especificado por barset. Esta señal se emite siempre después de clicked.
Nota: El manejador correspondiente es onDoubleClicked.
pressed(int index, BarSet barset)
Esta señal se emite cuando el usuario hace clic o toca la barra especificada por index en el conjunto de barras especificado por barset y mantiene pulsado el botón o el gesto del ratón.
Nota: El manejador correspondiente es onPressed.
released(int index, BarSet barset)
Esta señal se emite cuando el usuario suelta un botón o gesto del ratón previamente pulsado en la barra especificada por index en el conjunto de barras especificado por barset.
Nota: El manejador 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 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.
Véase también insert().
BarSet at(int index)
Devuelve la barra establecida 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 compases 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 por barset a una serie en la posición especificada por index. Si el conjunto es null o ya pertenece a la serie, el conjunto no se añade. Devuelve true si la inserción tiene éxito.
Véase también append().
bool remove(BarSet barset)
Elimina de la serie el conjunto de barras especificado por barset. Devuelve true si tiene éxito, 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, false en caso contrario.
void removeMultiple(int index, int count)
Elimina un intervalo de conjuntos de barras especificado en index y count. La llamada recorre todos los conjuntos aunque falle la eliminación de uno.
bool replace(list<BarSet> sets)
Sustituye completamente todo el juego de barras actual con sets. No es necesario que el tamaño coincida. Devuelve false si alguna de las barras establecidas en 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 tuvo éxito, false en caso contrario. oldSet se destruye si esto tiene éxito.
bool replace(int index, BarSet barset)
Reemplaza la barra establecida en la posición especificada por index de la serie y la sustituye por barset. Devuelve true si tiene éxito, 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.
