CategoryAxis QML Type

CategoryAxis place des plages nommées sur l'axe. En savoir plus…

Ce type est obsolète. Nous déconseillons fortement de l'utiliser dans les nouveaux codes.

• Liste de tous les membres, y compris les membres hérités

Propriétés

• categoriesLabels : StringList
• count : int
• labelsPosition : enumeration
• startValue : int

Méthodes

• void append(string label, real endValue)
• void remove(string label)
• void replace(string oldLabel, string newLabel)

Description détaillée

Ce type permet d'expliquer les données sous-jacentes en ajoutant des catégories étiquetées. La largeur des plages de catégories peut être définie librement.

Par exemple :

ChartView {
    title: "Numerical Data for Dummies"
    anchors.fill: parent
    legend.visible: false
    antialiasing: true

    LineSeries {
        axisY: CategoryAxis {
            min: 0
            max: 30
            CategoryRange {
                label: "critical"
                endValue: 2
            }
            CategoryRange {
                label: "low"
                endValue: 4
            }
            CategoryRange {
                label: "normal"
                endValue: 7
            }
            CategoryRange {
                label: "high"
                endValue: 15
            }
            CategoryRange {
                label: "extremely high"
                endValue: 30
            }
        }

        XYPoint { x: 0; y: 4.3 }
        XYPoint { x: 1; y: 4.1 }
        XYPoint { x: 2; y: 4.7 }
        XYPoint { x: 3; y: 3.9 }
        XYPoint { x: 4; y: 5.2 }
    }
}

Documentation sur les propriétés

categoriesLabels : StringList [read-only]

Les libellés des catégories sous forme de liste de chaînes de caractères.

count : int [read-only]

Le nombre de catégories.

labelsPosition : enumeration

Position des libellés de catégorie. Les libellés situés au début et à la fin des axes peuvent chevaucher ceux d’autres axes lorsqu’ils sont positionnés sur la valeur.

startValue : int

L'extrémité inférieure de la première catégorie sur l'axe.

Documentation sur les méthodes

void append(string label, real endValue)

Ajoute une nouvelle catégorie à l'axe avec l'étiquette label. Une étiquette de catégorie doit être unique. endValue spécifie la limite supérieure de la catégorie. Elle doit être supérieure à la limite supérieure de la catégorie précédente. Sinon, la méthode se termine sans ajouter de nouvelle catégorie.

void remove(string label)

Supprime de l'axe la catégorie spécifiée par l'étiquette « label ».

void replace(string oldLabel, string newLabel)

Remplace le libellé d'une catégorie existante, spécifié par ` oldLabel `, par ` newLabel`. Si l'ancien libellé n'existe pas, la méthode se termine sans effectuer de modification.