CategoryAxis QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

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)

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

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.

startValue : int

Das untere Ende der ersten Kategorie auf der Achse.

Methode Dokumentation

void 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 die Obergrenze der Kategorie an. Sie muss größer sein als die Obergrenze der vorherigen Kategorie. Andernfalls kehrt die Methode zurück, ohne eine neue Kategorie hinzuzufügen.

void remove(string label)

Entfernt eine durch das Label label angegebene Kategorie von der Achse.

void replace(string oldLabel, string newLabel)

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