AbstractBarSeries QML Type
Un tipo padre abstracto para todos los tipos de series de barras. Más información...
| Import Statement: | import QtCharts 2.12 |
| In C++: | QAbstractBarSeries |
| Inherits: | |
| Inherited By: | BarSeries, HorizontalBarSeries, HorizontalPercentBarSeries, HorizontalStackedBarSeries, PercentBarSeries, and StackedBarSeries |
| Status: | Deprecated |
Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.
Propiedades
- axisX : AbstractAxis
- axisXTop : AbstractAxis
- axisY : AbstractAxis
- axisYRight : AbstractAxis
- barWidth : real
- count : int
- labelsAngle : real
- labelsFormat : string
- labelsPosition : enumeration
- labelsPrecision : real
- labelsVisible : bool
Señales
- barsetsAdded()
- barsetsRemoved()
- clicked(int index, BarSet barset)
- doubleClicked(int index, BarSet barset)
- hovered(bool status, int index, BarSet barset)
- pressed(int index, BarSet barset)
- released(int index, BarSet barset)
Métodos
- BarSet append(string label, VariantList values)
- BarSet at(int index)
- void clear()
- BarSet insert(int index, string label, VariantList values)
- bool remove(BarSet barset)
Descripción detallada
En los gráficos de barras, las barras se definen como conjuntos de barras que contienen un valor de datos para cada categoría. La posición de una barra viene determinada por la categoría y su altura, por el valor de datos. Las series de barras que contienen varios conjuntos de barras agrupan las barras que pertenecen a la misma categoría. La forma en que se muestran las barras viene determinada por el tipo elegido para crear el gráfico de barras: « BarSeries », « StackedBarSeries », « PercentBarSeries », « HorizontalBarSeries », « HorizontalStackedBarSeries » o « HorizontalPercentBarSeries ».
Si se utiliza el tipo « ValueAxis » en lugar del tipo « BarCategoryAxis » para el eje principal de la barra, las barras se agrupan en torno al valor de índice de la categoría.
El siguiente fragmento de código QML muestra cómo utilizar los tipos ` BarSeries ` y ` BarCategoryAxis ` para crear un gráfico de barras sencillo:
ChartView {
title: "Bar Chart"
anchors.fill: parent
legend.alignment: Qt.AlignBottom
antialiasing: true
BarSeries {
id: mySeries
axisX: BarCategoryAxis { categories: ["2007", "2008", "2009", "2010", "2011", "2012" ] }
BarSet { label: "Bob"; values: [2, 2, 3, 4, 5, 6] }
BarSet { label: "Susan"; values: [5, 1, 2, 4, 1, 7] }
BarSet { label: "James"; values: [3, 5, 8, 13, 5, 8] }
}
}
Documentación de propiedades
axisX : AbstractAxis
El eje X utilizado para la serie. Si no se definen ni «axisX» ni « axisXTop », se crea un «BarCategoryAxis» para la serie.
Véase también axisXTop.
axisXTop : AbstractAxis
El eje x utilizado para la serie, trazado sobre la vista del gráfico.
Nota: Solose puede especificar « axisX » o «axisXTop», pero no ambos.
Véase también ` axisX`.
axisY : AbstractAxis
El eje Y utilizado para la serie. Si no se definen ni «axisY» ni « axisYRight », se crea un «ValueAxis» para la serie.
Véase también axisYRight.
axisYRight : AbstractAxis
El eje Y utilizado para la serie, situado a la derecha de la vista del gráfico.
Nota: Solopuedes especificar « axisY » o «axisYRight», pero no ambos.
Véase también ` axisY`.
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.
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.
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, expresado en grados.
labelsFormat : string
El formato utilizado para mostrar las etiquetas en una serie de barras.
Véase también QAbstractBarSeries::labelsFormat, labelsVisible y labelsPosition.
labelsPosition : enumeration
La posición de las etiquetas de los valores de los datos:
| Constante | Descripción |
|---|---|
AbstractBarSeries.LabelsCenter | La etiqueta se encuentra en el centro de la barra. |
AbstractBarSeries.LabelsInsideEnd | La etiqueta se encuentra en la parte superior de la barra. |
AbstractBarSeries.LabelsInsideBase | La etiqueta se encuentra dentro de la barra, en la parte inferior. |
AbstractBarSeries.LabelsOutsideEnd | 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.
Documentación de Signal
barsetsAdded()
Esta señal se emite cuando se añaden conjuntos de barras a la serie.
El controlador de señales correspondiente es onBarsetsAdded.
Nota: El controlador correspondiente es onBarsetsAdded.
barsetsRemoved()
Esta señal se emite cuando se eliminan conjuntos de barras de la serie.
El gestor de señales correspondiente es onBarsetsRemoved.
Nota: El controlador correspondiente es onBarsetsRemoved.
clicked(int index, BarSet barset)
Esta señal se emite cuando el usuario hace clic en la barra especificada por index dentro del conjunto de barras especificado por barset.
El controlador de señal correspondiente es onClicked.
Nota: El controlador correspondiente es onClicked.
doubleClicked(int index, BarSet barset)
Esta señal se emite cuando el usuario hace doble clic en la barra especificada por index dentro del conjunto de barras especificado por barset.
El controlador de señales correspondiente es onDoubleClicked.
Nota: El controlador correspondiente es onDoubleClicked.
hovered(bool status, int index, BarSet barset)
Esta señal se emite cuando se pasa el ratón por encima de la barra especificada en index, dentro del conjunto de barras especificado en barset. Cuando el ratón se desplaza sobre la barra, status cambia a true, y cuando el ratón se aleja de nuevo, cambia a false.
El controlador de señales correspondiente es onHovered.
Nota: El controlador correspondiente es onHovered.
pressed(int index, BarSet barset)
Esta señal se emite cuando el usuario hace clic en la barra especificada por index dentro del conjunto de barras especificado por barset y mantiene pulsado el botón del ratón.
El controlador de señal correspondiente es onPressed.
Nota: El controlador correspondiente es onPressed.
released(int index, BarSet barset)
Esta señal se emite cuando el usuario suelta el botón del ratón sobre la barra especificada por index en el conjunto de barras especificado por barset.
El controlador de señal correspondiente es onReleased.
Nota: El controlador correspondiente es onReleased.
Documentación de métodos
BarSet append(string label, VariantList values)
Añade al índice un nuevo conjunto de barras con « label » y « values ». « values » es una lista de valores reales.
Por ejemplo:
myBarSeries.append("set 1", [0, 0.2, 0.2, 0.5, 0.4, 1.5, 0.9]);BarSet at(int index)
Devuelve el conjunto de barras definido en index. Devuelve null si el índice no es válido.
void clear()
Elimina todos los conjuntos de barras de la serie.
BarSet insert(int index, string label, VariantList values)
Añade un nuevo conjunto de barras con label y values a index. values puede ser una lista de valores reales o una lista de tipos XYPoint.
Si el valor del índice es igual o inferior a cero, el nuevo conjunto de barras se añade al principio de la serie de barras. Si el valor del índice es igual o superior al número de conjuntos de barras de la serie, el nuevo conjunto de barras se añade al final de la serie.
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.
© 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.