CategoryAxis QML Type

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

Import Statement:	`import QtCharts 2.8`
In C++:	QCategoryAxis
Inherits:	AbstractAxis

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Methoden

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

Detaillierte Beschreibung

Dieser Typ kann verwendet werden, um die zugrunde liegenden Daten durch Hinzufügen von beschrifteten Kategorien zu erklären. Die Breite der Kategoriebereiche kann frei festgelegt werden.

Ein 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 }
    }
}

Eigenschaft Dokumentation

categoriesLabels : StringList [read-only]

Die Kategoriebezeichnungen als Liste von Strings.

count : int [read-only]

Die Anzahl der Kategorien.

labelsPosition : enumeration

Die Position der Kategoriebeschriftungen. Die Beschriftungen am Anfang und am Ende der Achsen können sich mit den Beschriftungen anderer Achsen überschneiden, wenn sie auf dem Wert positioniert sind.

Konstante	Beschreibung
`CategoryAxis.AxisLabelsPositionCenter`	Die Beschriftungen werden auf die Kategorie zentriert.
`CategoryAxis.AxisLabelsPositionOnValue`	Die Beschriftungen werden an der oberen Grenze der Kategorie positioniert.

startValue : int

Das untere Ende der ersten Kategorie auf der Achse.

Methode Dokumentation

append(string label, real endValue)

Fügt eine neue Kategorie mit der Bezeichnung label an die Achse an. Eine Kategoriebezeichnung muss eindeutig sein. endValue gibt das obere Ende der Kategorie an. Sie muss größer sein als die obere Grenze der vorherigen Kategorie. Andernfalls kehrt die Methode zurück, ohne eine neue Kategorie hinzuzufügen.

remove(string label)

Entfernt eine durch die Bezeichnung label angegebene Kategorie von der Achse.

replace(string oldLabel, string newLabel)

Ersetzt eine bestehende Kategoriebezeichnung, die durch oldLabel angegeben ist, durch newLabel. Wenn die alte Bezeichnung nicht existiert, kehrt die Methode zurück, ohne Änderungen vorzunehmen.

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