BarCategoryAxis QML Type

Añade categorías a los ejes de un gráfico. Más...

• Lista de todos los miembros, incluyendo los heredados
• BarCategoryAxis es parte de Qt Graphs QML Types for 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 puede configurarse para mostrar una línea de eje con marcas de tick, líneas de cuadrícula y sombras. Las categorías se dibujan entre las marcas.

El siguiente fragmento 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]

Esta propiedad se introdujo en Qt 6.11.

max : string

El valor máximo del eje. El valor dado debe estar contenido en categories.

min : string

El valor mínimo del eje. El valor dado debe estar contenido en categories.

Documentación de señales

categoriesChanged()

Esta señal se emite cuando cambian las categorías del eje.

categoryRangeChanged(string min, string max)

Esta señal se emite cuando cambia el rango de categorías del eje. min y max son el mínimo y el máximo del nuevo rango.

countChanged()

Esta señal se emite cuando cambia el número de categorías de un eje.

maxChanged(string max)

Esta señal se emite cuando el valor máximo del eje cambia a max.

minChanged(string min)

Esta señal se emite cuando el valor mínimo del eje cambia a min.

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 válida en QString 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 cambiará para coincidir con el último category. Si no se han definido categorías previamente, el valor mínimo del eje también cambiará para coincidir con category.

Una categoría debe ser válida en QString y no puede estar duplicada. Las categorías duplicadas no se añadirán.

string at(int index)

Devuelve la categoría en index.

void clear()

Elimina todas las categorías. Establece los valores máximo y mínimo del rango del eje a QString::null.

void insert(int index, string category)

Inserta category en el eje en index. category tiene que ser un QString válido y no puede estar duplicado. Si category se antepone o añade a otras categorías, los valores mínimo y máximo del eje se actualizan en consecuencia.

void remove(int index)

Elimina una categoría en index del eje. Eliminar una categoría que actualmente establece el valor máximo o mínimo en el eje afectará al rango del eje.

void remove(string category)

Elimina category del eje. Eliminar una categoría que actualmente establece el valor máximo o mínimo en el eje afectará al rango del eje.

void replace(string oldCategory, string newCategory)

Sustituye oldCategory por newCategory. Si oldCategory no existe en el eje, no se hace nada. newCategory tiene que 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.