BarCategoryAxis QML Type

Fügt Kategorien zu den Achsen eines Diagramms hinzu. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder
• BarCategoryAxis ist Teil von Qt Graphs QML Types for 2D.

Eigenschaften

• categories : list
• count : int
• labelPosition : enumeration (since 6.11)
• max : string
• min : string

Signale

• categoriesChanged()
• categoryRangeChanged(string min, string max)
• countChanged()
• maxChanged(string max)
• minChanged(string min)

Methoden

• void append(list categories)
• void append(string category)
• string at(int index)
• void clear()
• void insert(int index, string category)
• void remove(int index)
• void remove(string category)
• void replace(string oldCategory, string newCategory)

Detaillierte Beschreibung

Der Typ BarCategoryAxis kann so eingerichtet werden, dass er eine Achsenlinie mit Tickmarks, Gitternetzlinien und Schattierungen anzeigt. Die Kategorien werden zwischen den Häkchen gezeichnet.

Das folgende QML-Snippet veranschaulicht die Verwendung von BarCategoryAxis:

GraphsView {
    anchors.fill: parent
    axisX: BarCategoryAxis {
        categories: ["2023", "2024", "2025"]
        lineVisible: false
    }
    axisY: ValueAxis { }
    BarSeries {
        BarSet {
            values: [7, 6, 9]
        }
    }
}

Dokumentation der Eigenschaft

categories : list

Die Kategorien einer Achse.

count : int [read-only]

Die Anzahl der Kategorien einer Achse.

labelPosition : enumeration [since 6.11]

Diese Eigenschaft wurde in Qt 6.11 eingeführt.

max : string

Der Höchstwert auf der Achse. Der angegebene Wert sollte in categories enthalten sein.

min : string

Der Mindestwert auf der Achse. Der angegebene Wert sollte in categories enthalten sein.

Signal Dokumentation

categoriesChanged()

Dieses Signal wird ausgelöst, wenn sich die Kategorien der Achse ändern.

categoryRangeChanged(string min, string max)

Dieses Signal wird ausgegeben, wenn sich der Bereich der Kategorien der Achse ändert. min und max sind das Minimum und Maximum des neuen Bereichs.

countChanged()

Dieses Signal wird ausgegeben, wenn sich die Anzahl der Kategorien einer Achse ändert.

maxChanged(string max)

Dieses Signal wird ausgegeben, wenn sich der Maximalwert der Achse auf max ändert.

minChanged(string min)

Dieses Signal wird ausgegeben, wenn sich der Mindestwert der Achse auf min ändert.

Dokumentation der Methode

void append(list categories)

Hängt categories an eine Achse an. Der Höchstwert auf der Achse wird so geändert, dass er mit der letzten Kategorie in categories übereinstimmt. Wenn zuvor keine Kategorien definiert waren, wird auch der Mindestwert auf der Achse so geändert, dass er mit der ersten Kategorie in categories übereinstimmt.

Eine Kategorie muss eine gültige QString sein und darf nicht dupliziert werden. Doppelte Kategorien werden nicht angehängt.

void append(string category)

Hängt category an eine Achse an. Der Höchstwert auf der Achse wird so geändert, dass er dem letzten category entspricht. Wenn zuvor keine Kategorien definiert waren, wird auch der Mindestwert auf der Achse so geändert, dass er category entspricht.

Eine Kategorie muss eine gültige QString sein und kann nicht dupliziert werden. Doppelte Kategorien werden nicht angehängt.

string at(int index)

Gibt die Kategorie unter index zurück.

void clear()

Entfernt alle Kategorien. Setzt die Maximal- und Minimalwerte des Achsenbereichs auf QString::null.

void insert(int index, string category)

Fügt category auf der Achse bei index ein. category muss ein gültiges QString sein und darf nicht dupliziert werden. Wenn category anderen Kategorien vorangestellt oder angehängt wird, werden die Mindest- und Höchstwerte auf der Achse entsprechend aktualisiert.

void remove(int index)

Entfernt eine Kategorie unter index von der Achse. Das Entfernen einer Kategorie, die derzeit den Höchst- oder Mindestwert auf der Achse festlegt, wirkt sich auf den Achsenbereich aus.

void remove(string category)

Entfernt category von der Achse. Das Entfernen einer Kategorie, die derzeit den Höchst- oder Mindestwert auf der Achse festlegt, wirkt sich auf den Achsenbereich aus.

void replace(string oldCategory, string newCategory)

Ersetzt oldCategory durch newCategory. Wenn oldCategory auf der Achse nicht vorhanden ist, wird nichts unternommen. newCategory muss eine gültige QString sein und kann nicht dupliziert werden. Wird die Mindest- oder Höchstkategorie ersetzt, werden die Mindest- und Höchstwerte auf der Achse entsprechend aktualisiert.