BarCategoryAxis QML Type

Ajoute des catégories aux axes d'un graphique. En savoir plus...

• Liste de tous les membres, y compris les membres hérités
• BarCategoryAxis fait partie des types QML 2D d'Qt Graphs .

Propriétés

• categories : list
• count : int
• labelPosition : enumeration (since 6.11)
• max : string
• min : string

Signaux

• categoriesChanged()
• categoryRangeChanged(string min, string max)
• countChanged()
• maxChanged(string max)
• minChanged(string min)

Méthodes

• 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)

Description détaillée

Le type BarCategoryAxis peut être configuré pour afficher une ligne d'axe avec des graduations, des lignes de quadrillage et des ombrages. Les catégories sont tracées entre les graduations.

L'extrait de code QML suivant illustre l'utilisation de BarCategoryAxis :

GraphsView {
    anchors.fill: parent
    axisX: BarCategoryAxis {
        categories: ["2023", "2024", "2025"]
        lineVisible: false
    }
    axisY: ValueAxis { }
    BarSeries {
        BarSet {
            values: [7, 6, 9]
        }
    }
}

Documentation des propriétés

categories : list

Les catégories d'un axe.

count : int [read-only]

Le nombre de catégories d'un axe.

labelPosition : enumeration [since 6.11]

Cette propriété a été introduite dans Qt 6.11.

max : string

La valeur maximale sur l'axe. La valeur indiquée doit figurer dans categories.

min : string

La valeur minimale de l'axe. La valeur indiquée doit figurer dans categories.

Documentation sur les signaux

categoriesChanged()

Ce signal est émis lorsque les catégories de l'axe changent.

categoryRangeChanged(string min, string max)

Ce signal est émis lorsque l'intervalle des catégories de l'axe change. min et max correspondent respectivement aux valeurs minimale et maximale du nouvel intervalle.

countChanged()

Ce signal est émis lorsque le nombre de catégories d'un axe change.

maxChanged(string max)

Ce signal est émis lorsque la valeur maximale de l'axe passe à max.

minChanged(string min)

Ce signal est émis lorsque la valeur minimale de l'axe passe à min.

Documentation de la méthode

void append(list categories)

Ajoute categories à un axe. La valeur maximale de l'axe sera modifiée pour correspondre à la dernière catégorie de categories. Si aucune catégorie n'a été définie auparavant, la valeur minimale de l'axe sera également modifiée pour correspondre à la première catégorie de categories.

Une catégorie doit être une valeur valide de type QString et ne peut pas être dupliquée. Les catégories dupliquées ne seront pas ajoutées.

void append(string category)

Ajoute category à un axe. La valeur maximale de l'axe sera modifiée pour correspondre à la dernière category. Si aucune catégorie n'a été définie auparavant, la valeur minimale de l'axe sera également modifiée pour correspondre à category.

Une catégorie doit être une QString valide et ne peut pas être dupliquée. Les catégories dupliquées ne seront pas ajoutées.

string at(int index)

Renvoie la catégorie disponible à l'adresse index.

void clear()

Supprime toutes les catégories. Définit les valeurs maximale et minimale de l'intervalle de l'axe sur QString::null.

void insert(int index, string category)

Ajoute l'category e « » à l'axe « index ». « category » doit être une QString valide et ne doit pas être dupliquée. Si « category » est ajouté au début ou à la fin d'autres catégories, les valeurs minimales et maximales de l'axe sont mises à jour en conséquence.

void remove(int index)

Supprime une catégorie de l'axe à l'adresse index. La suppression d'une catégorie qui définit actuellement la valeur maximale ou minimale de l'axe aura une incidence sur l'étendue de l'axe.

void remove(string category)

Supprime la catégorie « category » de l'axe. La suppression d'une catégorie qui définit actuellement la valeur maximale ou minimale de l'axe aura une incidence sur l'étendue de l'axe.

void replace(string oldCategory, string newCategory)

Remplace oldCategory par newCategory. Si oldCategory n'existe pas sur l'axe, aucune action n'est effectuée. newCategory doit être une adresse QString valide et ne doit pas être dupliquée. Si la catégorie minimale ou maximale est remplacée, les valeurs minimales et maximales de l'axe sont mises à jour en conséquence.