Auf dieser Seite

CategoryAxis QML Type

„CategoryAxis“ platziert benannte Bereiche auf der Achse. Mehr...

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

AbstractAxis

Status: Deprecated

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

Eigenschaften

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:

Liniendiagramm mit einer Kategorieachse, deren Beschriftung „kritisch“, „niedrig“, „normal“, „hoch“ und „extrem hoch“ lautet

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.

KonstanteBeschreibung
CategoryAxis.AxisLabelsPositionCenterDie Beschriftungen werden innerhalb der Kategorie zentriert.
CategoryAxis.AxisLabelsPositionOnValueDie 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.