BarCategoryAxis QML Type

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

Import Statement:	`import QtGraphs`
In C++:	QBarCategoryAxis
Inherits:	AbstractAxis

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

Eigenschaften

categories : list
count : int
max : string
min : string

Signale

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

Methoden

append(list categories)
append(string category)
string at(int index)
clear()
insert(int index, string category)
remove(int index)
remove(string category)
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.

max : string

Der maximale Wert 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 ausgesendet, wenn sich die Kategorien der Achse ändern.

Hinweis: Der entsprechende Handler ist onCategoriesChanged.

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 das Maximum des neuen Bereichs.

Hinweis: Der entsprechende Handler ist onCategoryRangeChanged.

countChanged()

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

Hinweis: Der entsprechende Handler ist onCountChanged.

maxChanged(string max)

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

Hinweis: Der entsprechende Handler ist onMaxChanged.

minChanged(string min)

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

Hinweis: Der entsprechende Handler ist onMinChanged.

Methode Dokumentation

append(list categories)

Hängt categories an eine Achse an. Der Maximalwert auf der Achse wird so geändert, dass er mit der letzten Kategorie in categories übereinstimmt. Wenn vorher keine Kategorien definiert waren, wird auch der Minimalwert 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.

append(string category)

Hängt category an eine Achse an. Der Maximalwert auf der Achse wird so geändert, dass er mit der letzten category übereinstimmt. 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.

clear()

Entfernt alle Kategorien. Setzt den maximalen und minimalen Wert des Achsenbereichs auf QString::null.

insert(int index, string category)

Fügt category in die Achse bei index ein. category muss eine gültige 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.

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.

remove(string category)

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

replace(string oldCategory, string newCategory)

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

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