Sur cette page

CategoryAxis QML Type

CategoryAxis place des plages nommées sur l'axe. Plus d'informations...

Import Statement: import QtCharts 2.11
In C++: QCategoryAxis
Inherits:

AbstractAxis

Propriétés

Méthodes

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

Description détaillée

Ce type peut être utilisé pour expliquer les données sous-jacentes en ajoutant des catégories étiquetées. La largeur des catégories peut être spécifiée librement.

Par exemple, ce type de documentation peut être utilisé pour expliquer les données sous-jacentes en ajoutant des catégories étiquetées :

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 biens

categoriesLabels : StringList [read-only]

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

count : int [read-only]

Le nombre de catégories.

labelsPosition : enumeration

La position des étiquettes des catégories. Les étiquettes au début et à la fin des axes peuvent chevaucher les étiquettes d'autres axes lorsqu'elles sont positionnées sur la valeur.

ConstanteDescription
CategoryAxis.AxisLabelsPositionCenterLes étiquettes sont centrées sur la catégorie.
CategoryAxis.AxisLabelsPositionOnValueLes étiquettes sont positionnées à la limite supérieure de la catégorie.

startValue : int

La limite inférieure de la première catégorie de l'axe.

Documentation de la méthode

void append(string label, real endValue)

Ajoute une nouvelle catégorie à l'axe avec l'étiquette label. L'étiquette d'une catégorie doit être unique. endValue indique 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 renvoie sans ajouter de nouvelle catégorie.

void remove(string label)

Supprime de l'axe une catégorie spécifiée par l'étiquette label.

void replace(string oldLabel, string newLabel)

Remplace une étiquette de catégorie existante spécifiée par oldLabel par newLabel. Si l'ancienne étiquette n'existe pas, la méthode renvoie sans apporter de modifications.

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