QBarCategoryAxis Class
Die Klasse „QBarCategoryAxis“ fügt den Achsen eines Diagramms Kategorien hinzu. Mehr dazu...
| Header: | #include <QBarCategoryAxis> |
| In QML: | BarCategoryAxis |
| Inherits: | QAbstractAxis |
| Status: | Deprecated |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Eigenschaften
- categories : QStringList
- count : int
- max : QString
- min : QString
Öffentliche Funktionen
| QBarCategoryAxis(QObject *parent = nullptr) | |
| virtual | ~QBarCategoryAxis() |
| void | append(const QString &category) |
| void | append(const QStringList &categories) |
| QString | at(int index) const |
| QStringList | categories() |
| void | clear() |
| int | count() const |
| void | insert(int index, const QString &category) |
| QString | max() const |
| QString | min() const |
| void | remove(const QString &category) |
| void | replace(const QString &oldCategory, const QString &newCategory) |
| void | setCategories(const QStringList &categories) |
| void | setMax(const QString &max) |
| void | setMin(const QString &min) |
| void | setRange(const QString &minCategory, const QString &maxCategory) |
Neu implementierte öffentliche Funktionen
| virtual QAbstractAxis::AxisType | type() const override |
Signale
| void | categoriesChanged() |
| void | countChanged() |
| void | maxChanged(const QString &max) |
| void | minChanged(const QString &min) |
| void | rangeChanged(const QString &min, const QString &max) |
Ausführliche Beschreibung
QBarCategoryAxis kann so eingerichtet werden, dass eine Achsenlinie mit Teilstrichen, Gitterlinien und Schattierungen angezeigt wird. Zwischen den Teilstrichen werden Kategorien eingezeichnet. Die Klasse kann auch mit einer Linienreihe verwendet werden, wie in der Galerie „Diagramme mit Widgets“ gezeigt wird.
Der folgende Code veranschaulicht die Verwendung von QBarCategoryAxis:
QChartView *chartView = new QChartView;
QBarSeries *series = new QBarSeries;
// ...
chartView->chart()->addSeries(series);
chartView->chart()->createDefaultAxes();
QBarCategoryAxis *axisX = new QBarCategoryAxis;
QStringList categories;
categories << "Jan" << "Feb" << "Mar" << "Apr" << "May" << "Jun";
axisX->append(categories);
axisX->setRange("Feb", "May");
chartView->chart()->setAxisX(axisX, series);Dokumentation zu den Eigenschaften
categories : QStringList
Diese Eigenschaft enthält die Kategorien einer Achse.
Zugriffsfunktionen:
| QStringList | categories() |
| void | setCategories(const QStringList &categories) |
Benachrichtigungssignal:
| void | categoriesChanged() |
[read-only] count : int
Diese Eigenschaft gibt die Anzahl der Kategorien einer Achse an.
Zugriffsfunktionen:
| int | count() const |
Benachrichtigungssignal:
| void | countChanged() |
max : QString
Diese Eigenschaft enthält den Maximalwert auf der Achse.
Zugriffsfunktionen:
Benachrichtigungssignal:
| void | maxChanged(const QString &max) |
min : QString
Diese Eigenschaft enthält den Minimalwert auf der Achse.
Zugriffsfunktionen:
Benachrichtigungssignal:
| void | minChanged(const QString &min) |
Dokumentation der Mitgliedsfunktionen
[explicit] QBarCategoryAxis::QBarCategoryAxis(QObject *parent = nullptr)
Erstellt ein Achsenobjekt, das ein untergeordnetes Element von „ parent “ ist.
[virtual noexcept] QBarCategoryAxis::~QBarCategoryAxis()
Löscht das Achsenobjekt.
void QBarCategoryAxis::append(const QString &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ültiges QString sein und darf nicht doppelt vorhanden sein. Doppelte Kategorien werden nicht hinzugefügt.
void QBarCategoryAxis::append(const QStringList &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ültiges „ QString “ sein und darf nicht doppelt vorhanden sein. Doppelte Kategorien werden nicht hinzugefügt.
QString QBarCategoryAxis::at(int index) const
Gibt die Kategorie unter index zurück. Der Index muss gültig sein.
QStringList QBarCategoryAxis::categories()
Gibt die Kategorien zurück.
Hinweis: Getter -Funktion für die Eigenschaft „categories“.
Siehe auch ` setCategories()`.
[signal] void QBarCategoryAxis::categoriesChanged()
Dieses Signal wird ausgegeben, wenn sich die Kategorien der Achse ändern.
Hinweis: Notifier -Signal für die Eigenschaft „ categories “.
[invokable] void QBarCategoryAxis::clear()
Entfernt alle Kategorien. Setzt den Maximal- und Minimalwert des Achsenbereichs auf QString::null.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
int QBarCategoryAxis::count() const
Gibt die Anzahl der Kategorien zurück.
Hinweis: Getter -Funktion für die Eigenschaft „count“.
[signal] void QBarCategoryAxis::countChanged()
Dieses Signal wird ausgelöst, wenn sich die Anzahl der Kategorien einer Achse ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft „ count “.
void QBarCategoryAxis::insert(int index, const QString &category)
Fügt „ category “ zur Achse unter „ index “ ein. „ category “ muss ein gültiges „ QString “ sein und darf nicht doppelt vorkommen. Wenn „ category “ anderen Kategorien vorangestellt oder angehängt wird, werden die Minimal- und Maximalwerte auf der Achse entsprechend aktualisiert.
QString QBarCategoryAxis::max() const
Gibt die Kategorie mit dem höchsten Wert zurück.
Hinweis: Getter -Funktion für die Eigenschaft „max“.
Siehe auch „ setMax()“.
[signal] void QBarCategoryAxis::maxChanged(const QString &max)
Dieses Signal wird ausgelöst, wenn sich der Wert „ max “ der Achse ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft „ max “.
QString QBarCategoryAxis::min() const
Gibt die niedrigste Kategorie zurück.
Hinweis: Getter -Funktion für die Eigenschaft „min“.
Siehe auch „ setMin()“.
[signal] void QBarCategoryAxis::minChanged(const QString &min)
Dieses Signal wird ausgelöst, wenn sich der Wert der Eigenschaft „ min “ der Achse ändert.
Hinweis: Benachrichtigungssignal für die Eigenschaft „ min “.
[signal] void QBarCategoryAxis::rangeChanged(const QString &min, const QString &max)
Dieses Signal wird ausgelöst, wenn sich der Wert von „ min “ oder „ max “ der Achse ändert.
void QBarCategoryAxis::remove(const QString &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 QBarCategoryAxis::replace(const QString &oldCategory, const QString &newCategory)
Ersetzt „ oldCategory “ durch „ newCategory “. Falls „ oldCategory “ auf der Achse nicht vorhanden ist, erfolgt keine Änderung. „ newCategory “ muss ein gültiger „ QString “ sein und darf nicht doppelt vorhanden sein. Wird die Minimal- oder Maximal-Kategorie ersetzt, werden die Minimal- und Maximalwerte auf der Achse entsprechend aktualisiert.
void QBarCategoryAxis::setCategories(const QStringList &categories)
Legt „ categories “ fest und verwirft die alten Werte. Der Achsenbereich wird so angepasst, dass er mit der ersten und letzten Kategorie in „ categories “ übereinstimmt.
Eine Kategorie muss ein gültiger Wert aus „ QString “ sein und darf nicht doppelt vorkommen.
Hinweis: Setter -Funktion für die Eigenschaft „ categories “.
Siehe auch categories().
void QBarCategoryAxis::setMax(const QString &max)
Setzt die maximale Kategorie auf „ max “.
Hinweis: Setter -Funktion für die Eigenschaft „ max “.
Siehe auch „ max()“.
void QBarCategoryAxis::setMin(const QString &min)
Legt die Mindestkategorie auf „ min “ fest.
Hinweis: Setter -Funktion für die Eigenschaft „ min “.
Siehe auch „ min()“.
void QBarCategoryAxis::setRange(const QString &minCategory, const QString &maxCategory)
Legt den Achsenbereich von minCategory bis maxCategory fest.
[override virtual] QAbstractAxis::AxisType QBarCategoryAxis::type() const
Implementiert neu: ` QAbstractAxis::type()` const.
Gibt den Typ der Achse zurück.
© 2026 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.
