CategoryAxis QML Type
„CategoryAxis“ platziert benannte Bereiche auf der Achse. Mehr...
| Import Statement: | import QtCharts 2.12 |
| In C++: | QCategoryAxis |
| Inherits: | |
| Status: | Deprecated |
Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.
Eigenschaften
- categoriesLabels : StringList
- count : int
- labelsPosition : enumeration
- startValue : int
Methoden
- void append(string label, real endValue)
- void remove(string label)
- void replace(string oldLabel, string newLabel)
Ausführliche Beschreibung
Dieser Typ kann verwendet werden, um die zugrunde liegenden Daten durch Hinzufügen beschrifteter Kategorien zu erläutern. Die Breiten der Kategoriebereiche können frei festgelegt werden.
Beispiel:

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 }
}
}Dokumentation zu Eigenschaften
categoriesLabels : StringList [read-only]
Die Kategoriebezeichnungen als Liste von Zeichenketten.
count : int [read-only]
Die Anzahl der Kategorien.
labelsPosition : enumeration
Die Position der Kategoriebezeichnungen. Die Bezeichnungen am Anfang und am Ende der Achsen können sich mit den Bezeichnungen anderer Achsen überschneiden, wenn sie auf den Wert ausgerichtet sind.
| Konstante | Beschreibung |
|---|---|
CategoryAxis.AxisLabelsPositionCenter | Die Beschriftungen werden innerhalb der Kategorie zentriert. |
CategoryAxis.AxisLabelsPositionOnValue | Die Beschriftungen werden am oberen Grenzwert der Kategorie positioniert. |
startValue : int
Das untere Ende der ersten Kategorie auf der Achse.
Methodendokumentation
void append(string label, real endValue)
Fügt der Achse eine neue Kategorie mit der Bezeichnung „ label “ hinzu. Eine Kategoriebezeichnung muss eindeutig sein. „ endValue “ gibt die Obergrenze der Kategorie an. Diese muss größer sein als die Obergrenze der vorherigen Kategorie. Andernfalls bricht die Methode ab, ohne eine neue Kategorie hinzuzufügen.
void remove(string label)
Entfernt eine Kategorie, die durch die Bezeichnung „ label “ angegeben ist, von der Achse.
void replace(string oldLabel, string newLabel)
Ersetzt eine vorhandene Kategoriebezeichnung, die durch ` oldLabel ` angegeben ist, durch ` newLabel`. Wenn die alte Bezeichnung nicht existiert, kehrt die Methode ohne Änderungen zurück.
© 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.