BarCategoryAxis QML Type
Añade categorías a los ejes de un gráfico. Más...
| Import Statement: | import QtGraphs |
| In C++: | QBarCategoryAxis |
| Inherits: |
- Lista de todos los miembros, incluidos los miembros heredados
- BarCategoryAxis forma parte de los tipos QML deQt Graphs para 2D.
Propiedades
- categories : list
- count : int
- labelPosition : enumeration
(since 6.11) - max : string
- min : string
Señales
- categoriesChanged()
- categoryRangeChanged(string min, string max)
- countChanged()
- maxChanged(string max)
- minChanged(string min)
Métodos
- void append(list categories)
- void append(string category)
- string at(int index)
- void clear()
- void insert(int index, string category)
- void remove(int index)
- void remove(string category)
- void replace(string oldCategory, string newCategory)
Descripción detallada
El tipo BarCategoryAxis se puede configurar para mostrar una línea de eje con marcas de escala, líneas de cuadrícula y sombreados. Las categorías se dibujan entre las marcas de escala.
El siguiente fragmento de código QML ilustra cómo utilizar BarCategoryAxis:
GraphsView {
anchors.fill: parent
axisX: BarCategoryAxis {
categories: ["2023", "2024", "2025"]
lineVisible: false
}
axisY: ValueAxis { }
BarSeries {
BarSet {
values: [7, 6, 9]
}
}
}Documentación de propiedades
categories : list
Las categorías de un eje.
count : int [read-only]
El número de categorías de un eje.
labelPosition : enumeration [since 6.11]
| Constante | Descripción |
|---|---|
BarCategoryAxis.Center | Las etiquetas se centran en la categoría. |
BarCategoryAxis.OnValue | Las etiquetas se sitúan en el límite superior de la categoría. |
Esta propiedad se introdujo en Qt 6.11.
max : string
El valor máximo del eje. El valor indicado debe estar incluido en categories.
min : string
El valor mínimo del eje. El valor indicado debe estar incluido en categories.
Documentación de Signal
categoriesChanged()
Esta señal se emite cuando cambian las categorías del eje.
Nota: El controlador correspondiente es onCategoriesChanged.
categoryRangeChanged(string min, string max)
Esta señal se emite cuando cambia el rango de categorías del eje. min y max son los valores mínimo y máximo del nuevo rango.
Nota: El controlador correspondiente es onCategoryRangeChanged.
countChanged()
Esta señal se emite cuando cambia el número de categorías de un eje.
Nota: El controlador correspondiente es onCountChanged.
maxChanged(string max)
Esta señal se emite cuando el valor máximo del eje cambia a max.
Nota: El controlador correspondiente es onMaxChanged.
minChanged(string min)
Esta señal se emite cuando el valor mínimo del eje cambia a min.
Nota: El controlador correspondiente es onMinChanged.
Documentación del método
void append(list categories)
Añade categories a un eje. El valor máximo del eje se modificará para que coincida con la última categoría de categories. Si no se han definido categorías previamente, el valor mínimo del eje también se modificará para que coincida con la primera categoría de categories.
Una categoría debe ser un QString válido y no puede estar duplicada. Las categorías duplicadas no se añadirán.
void append(string category)
Añade category a un eje. El valor máximo del eje se modificará para que coincida con el último category. Si no se han definido categorías previamente, el valor mínimo del eje también se modificará para que coincida con category.
Una categoría debe ser un QString válido y no puede estar duplicada. Las categorías duplicadas no se añadirán.
string at(int index)
Devuelve la categoría de index.
void clear()
Elimina todas las categorías. Establece los valores máximo y mínimo del rango del eje en QString::null.
void insert(int index, string category)
Inserta « category » en el eje en « index ». « category » debe ser un « QString » válido y no puede estar duplicado. Si « category » se añade al principio o al final de otras categorías, los valores mínimo y máximo del eje se actualizan en consecuencia.
void remove(int index)
Elimina del eje una categoría de index. Si se elimina una categoría que actualmente establece el valor máximo o mínimo del eje, esto afectará al rango del eje.
void remove(string category)
Elimina « category » del eje. Si se elimina una categoría que actualmente establece el valor máximo o mínimo del eje, esto afectará al rango del eje.
void replace(string oldCategory, string newCategory)
Sustituye oldCategory por newCategory. Si oldCategory no existe en el eje, no se realiza ninguna acción. newCategory debe ser un QString válido y no puede estar duplicado. Si se sustituye la categoría mínima o máxima, los valores mínimo y máximo del eje se actualizan en consecuencia.
© 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.