BarCategoryAxis QML Type

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

Import Statement: import QtGraphs
In C++: QBarCategoryAxis
Inherits:

AbstractAxis

Propriétés

Signaux

Méthodes

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 de la propriété

categories : list

Les catégories d'un axe.


count : int [read-only]

Le nombre de catégories d'un axe.


max : string

La valeur maximale de l'axe. La valeur donnée doit être contenue dans categories.


min : string

La valeur minimale de l'axe. La valeur donnée doit être contenue dans categories.


Signal Documentation

categoriesChanged()

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

Remarque : le gestionnaire correspondant est onCategoriesChanged.


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.

Remarque : Le gestionnaire correspondant est onCategoryRangeChanged.


countChanged()

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

Remarque : Le gestionnaire correspondant est onCountChanged.


maxChanged(string max)

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

Remarque : Le gestionnaire correspondant est onMaxChanged.


minChanged(string min)

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

Remarque : Le gestionnaire correspondant est onMinChanged.


Documentation de la méthode

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.


append(string category)

Ajoute category à un axe. La valeur maximale de l'axe sera modifiée pour correspondre à la dernière catégorie de 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.


clear()

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


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é à d'autres catégories, les valeurs minimales et maximales de l'axe sont mises à jour en conséquence.


remove(int index)

Supprime de l'axe la catégorie index. 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.


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


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 pas être dupliqué. Si la catégorie minimum ou maximum est remplacée, les valeurs minimum et maximum de l'axe sont mises à jour en conséquence.


© 2025 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.