BarCategoryAxis QML Type

Ajoute des catégories aux axes d'un graphique. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités
• BarCategoryAxis fait partie de Qt Graphs QML Types for 2D.

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 marques de pointage, des lignes de grille et des nuances. Les catégories sont dessinées entre les tiques.

L'extrait 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 sur les 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 donnée doit être contenue dans categories.

min : string

La valeur minimale sur l'axe. La valeur donnée doit être contenue 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 la plage de catégories de l'axe change. min et max sont les valeurs min et max de la nouvelle plage.

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 catégorie valide QString et ne peut ê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 être dupliquée. Les catégories dupliquées ne seront pas ajoutées.

string at(int index)

Renvoie la catégorie à index.

void clear()

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

void insert(int index, string category)

Insère category dans l'axe à index. category doit être un QString valide et ne peut être dupliqué. Si category est ajouté ou annexé à 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 affectera la portée de l'axe.

void remove(string category)

Supprime 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 la portée de l'axe.

void replace(string oldCategory, string newCategory)

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