BarCategoryAxis QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder
• „BarCategoryAxis“ ist Teil der „Qt Graphs “-QML-Typen für 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)

Ausführliche Beschreibung

Der Typ „BarCategoryAxis“ kann so eingerichtet werden, dass eine Achsenlinie mit Teilstrichen, Gitterlinien und Schattierungen angezeigt wird. Zwischen den Teilstrichen werden Kategorien eingezeichnet.

Der folgende QML-Ausschnitt 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 zu den Eigenschaften

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 Maximalwert auf der Achse. Der angegebene Wert sollte in „ categories “ enthalten sein.

min : string

Der Minimalwert auf der Achse. Der angegebene Wert sollte in „ categories “ enthalten sein.

Signaldokumentation

categoriesChanged()

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

categoryRangeChanged(string min, string max)

Dieses Signal wird ausgelöst, wenn sich der Wertebereich der Achse ändert. min und max sind der Minimal- und Maximalwert des neuen Wertebereichs.

countChanged()

Dieses Signal wird ausgelöst, wenn sich die Anzahl der Kategorien einer Achse ändert.

maxChanged(string max)

Dieses Signal wird ausgelöst, wenn sich der Maximalwert der Achse auf max ändert.

minChanged(string min)

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

Methodendokumentation

void append(list categories)

Fügt categories zu einer Achse hinzu. Der Maximalwert der Achse wird so angepasst, dass er der letzten Kategorie in categories entspricht. Wenn zuvor keine Kategorien definiert wurden, wird auch der Minimalwert der Achse so angepasst, dass er der ersten Kategorie in categories entspricht.

Eine Kategorie muss ein gültiger QString sein und darf nicht doppelt vorhanden sein. Doppelte Kategorien werden nicht hinzugefügt.

void append(string category)

Fügt „ category “ zu einer Achse hinzu. Der Maximalwert der Achse wird so angepasst, dass er mit dem letzten Wert unter category übereinstimmt. Wenn zuvor keine Kategorien definiert wurden, wird auch der Minimalwert der Achse so angepasst, dass er mit dem Wert unter category übereinstimmt.

Eine Kategorie muss ein gültiger QString sein und darf nicht doppelt vorkommen. Doppelte Kategorien werden nicht hinzugefügt.

string at(int index)

Gibt die Kategorie unter index zurück.

void clear()

Entfernt alle Kategorien. Setzt den Maximal- und Minimalwert des Achsenbereichs auf QString::null.

void insert(int index, string category)

Fügt „ category “ zur Achse unter „ index “ ein. „ category “ muss eine gültige „ QString “ sein und darf nicht doppelt vorhanden sein. Wenn „ category “ anderen Kategorien vorangestellt oder angehängt wird, werden die Minimal- und Maximalwerte auf der Achse entsprechend aktualisiert.

void remove(int index)

Entfernt eine Kategorie unter index aus der Achse. Das Entfernen einer Kategorie, die derzeit den Maximal- oder Minimalwert auf der Achse festlegt, wirkt sich auf den Achsenbereich aus.

void remove(string category)

Entfernt „ category “ aus der Achse. Das Entfernen einer Kategorie, die derzeit den Maximal- oder Minimalwert 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, erfolgt keine Änderung. „ newCategory “ muss ein gültiges „ QString “ sein und darf nicht doppelt vorhanden sein. Wenn die Minimal- oder Maximal-Kategorie ersetzt wird, werden die Minimal- und Maximalwerte auf der Achse entsprechend aktualisiert.