Back to Qt.io
Contact Us Blog Download Qt

QBarCategoryAxis Class

Die Klasse QBarCategoryAxis fügt Kategorien zu den Achsen eines Diagramms hinzu. Mehr...

Header: #include <QBarCategoryAxis>
In QML: BarCategoryAxis
Inherits: QAbstractAxis

Eigenschaften

Ö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)

Reimplementierte ö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)

Detaillierte Beschreibung

QBarCategoryAxis kann so eingerichtet werden, dass eine Achsenlinie mit Tickmarks, Gitternetzlinien und Schattierungen angezeigt wird. Die Kategorien werden zwischen den Ticks gezeichnet. Es kann auch mit einer Linienreihe verwendet werden, wie in der Charts with Widgets Gallery gezeigt.

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 der Eigenschaft

categories : QStringList

Diese Eigenschaft enthält die Kategorien einer Achse.

Zugriffsfunktionen:

QStringList categories()
void setCategories(const QStringList &categories)

Melder-Signal:

void categoriesChanged()

[read-only] count : const int

Diese Eigenschaft enthält die Anzahl der Kategorien einer Achse.

Zugriffsfunktionen:

int count() const

Melder-Signal:

void countChanged()

max : QString

Diese Eigenschaft enthält den Höchstwert auf der Achse.

Zugriffsfunktionen:

QString max() const
void setMax(const QString &max)

Melder-Signal:

void maxChanged(const QString &max)

min : QString

Diese Eigenschaft enthält den Mindestwert auf der Achse.

Zugriffsfunktionen:

QString min() const
void setMin(const QString &min)

Benachrichtigungssignal:

void minChanged(const QString &min)

Member Function Dokumentation

[explicit] QBarCategoryAxis::QBarCategoryAxis(QObject *parent = nullptr)

Konstruiert ein Achsenobjekt, das das Kind von parent ist.

[virtual noexcept] QBarCategoryAxis::~QBarCategoryAxis()

Zerstört das Achsenobjekt.

void QBarCategoryAxis::append(const QString &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.

void QBarCategoryAxis::append(const QStringList &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.

QString QBarCategoryAxis::at(int index) const

Gibt die Kategorie unter index zurück. Der Index muss gültig sein.

QStringList QBarCategoryAxis::categories()

Gibt Kategorien zurück.

Hinweis: Getter-Funktion für Eigenschaftskategorien.

Siehe auch setCategories().

[signal] void QBarCategoryAxis::categoriesChanged()

Dieses Signal wird ausgesendet, wenn sich die Kategorien der Achse ändern.

Hinweis: Meldesignal für die Eigenschaft categories.

[invokable] void QBarCategoryAxis::clear()

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

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus 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 ausgesendet, wenn sich die Anzahl der Kategorien einer Achse ändert.

Hinweis: Meldesignal für die Eigenschaft count.

void QBarCategoryAxis::insert(int index, const QString &category)

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

QString QBarCategoryAxis::max() const

Gibt die maximale Kategorie zurück.

Hinweis: Getter-Funktion für die Eigenschaft max.

Siehe auch setMax().

[signal] void QBarCategoryAxis::maxChanged(const QString &max)

Dieses Signal wird ausgesendet, wenn sich der max Wert der Achse ändert.

Hinweis: Meldersignal für die Eigenschaft max.

QString QBarCategoryAxis::min() const

Gibt die minimale Kategorie zurück.

Hinweis: Getter-Funktion für die Eigenschaft min.

Siehe auch setMin().

[signal] void QBarCategoryAxis::minChanged(const QString &min)

Dieses Signal wird ausgesendet, wenn sich der min Wert der Achse ändert.

Hinweis: Meldersignal für die Eigenschaft min.

[signal] void QBarCategoryAxis::rangeChanged(const QString &min, const QString &max)

Dieses Signal wird ausgegeben, wenn sich der min oder max Wert der Achse ändert.

void QBarCategoryAxis::remove(const QString &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 QBarCategoryAxis::replace(const QString &oldCategory, const QString &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.

void QBarCategoryAxis::setCategories(const QStringList &categories)

Legt categories fest und verwirft die alten Einträge. Der Achsenbereich wird so angepasst, dass er mit der ersten und letzten Kategorie in categories übereinstimmt.

Eine Kategorie muss eine gültige QString sein und kann nicht dupliziert werden.

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)

Setzt die Mindestkategorie auf min.

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

Reimplements: QAbstractAxis::type() const.

Gibt den Typ der Achse zurück.

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