Back to Qt.io
Contact Us Blog Download Qt

QCategoryAxis Class

Die Klasse QCategoryAxis platziert benannte Bereiche auf der Achse. Mehr...

Header: #include <QCategoryAxis>
In QML: CategoryAxis
Inherits: QValueAxis

Öffentliche Typen

enum AxisLabelsPosition { AxisLabelsPositionCenter, AxisLabelsPositionOnValue }

Eigenschaften

Öffentliche Funktionen

QCategoryAxis(QObject *parent = nullptr)
virtual ~QCategoryAxis()
void append(const QString &categoryLabel, qreal categoryEndValue)
QStringList categoriesLabels()
int count() const
qreal endValue(const QString &categoryLabel) const
QCategoryAxis::AxisLabelsPosition labelsPosition() const
void remove(const QString &categoryLabel)
void replaceLabel(const QString &oldLabel, const QString &newLabel)
void setLabelsPosition(QCategoryAxis::AxisLabelsPosition position)
void setStartValue(qreal min)
qreal startValue(const QString &categoryLabel = QString()) const

Reimplementierte öffentliche Funktionen

virtual QAbstractAxis::AxisType type() const override

Signale

void categoriesChanged()
void labelsPositionChanged(QCategoryAxis::AxisLabelsPosition position)

Detaillierte Beschreibung

Diese Klasse kann verwendet werden, um die zugrundeliegenden Daten durch Hinzufügen von beschrifteten Kategorien zu erklären. Im Gegensatz zu QBarCategoryAxis können bei QCategoryAxis die Breiten der Kategoriebereiche frei festgelegt werden.

Beispielcode für die Verwendung von QCategoryAxis:

QChartView *chartView = new QChartView;
QLineSeries *series = new QLineSeries;
// ...
chartView->chart()->addSeries(series);

QCategoryAxis *axisY = new QCategoryAxis;
axisY->setMin(0);
axisY->setMax(52);
axisY->setStartValue(15);
axisY->append("First", 20);
axisY->append("Second", 37);
axisY->append("Third", 52);
chartView->chart()->setAxisY(axisY, series);

Member Type Dokumentation

enum QCategoryAxis::AxisLabelsPosition

Diese Aufzählung beschreibt die Position der Kategoriebezeichnungen.

KonstanteWertBeschreibung
QCategoryAxis::AxisLabelsPositionCenter0x0Die Beschriftungen werden auf die Kategorie zentriert.
QCategoryAxis::AxisLabelsPositionOnValue0x1Die Beschriftungen werden an der oberen Grenze der Kategorie positioniert.

Eigenschaft Dokumentation

[read-only] categoriesLabels : const QStringList

Diese Eigenschaft enthält die Kategoriebezeichnungen in Form einer Stringliste.

Zugriffsfunktionen:

QStringList categoriesLabels()

[read-only] count : const int

Diese Eigenschaft enthält die Anzahl der Kategorien.

Zugriffsfunktionen:

int count() const

labelsPosition : AxisLabelsPosition

Diese Eigenschaft enthält die Position der Kategoriebeschriftungen. Die Beschriftungen am Anfang und am Ende der Achsen können sich mit den Beschriftungen anderer Achsen überschneiden, wenn sie auf dem Wert positioniert sind.

Zugriffsfunktionen:

QCategoryAxis::AxisLabelsPosition labelsPosition() const
void setLabelsPosition(QCategoryAxis::AxisLabelsPosition position)

Melder-Signal:

void labelsPositionChanged(QCategoryAxis::AxisLabelsPosition position)

startValue : qreal

Diese Eigenschaft enthält das untere Ende der ersten Kategorie auf der Achse.

Zugriffsfunktionen:

qreal startValue(const QString &categoryLabel = QString()) const
void setStartValue(qreal min)

Dokumentation der Mitgliedsfunktionen

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

Konstruiert ein Achsenobjekt, das ein Kind von parent ist.

[virtual noexcept] QCategoryAxis::~QCategoryAxis()

Zerstört das Objekt.

void QCategoryAxis::append(const QString &categoryLabel, qreal categoryEndValue)

Fügt eine neue Kategorie mit der Bezeichnung categoryLabel an die Achse an. Eine Kategoriebezeichnung muss eindeutig sein. categoryEndValue gibt die Obergrenze der Kategorie an. Sie muss größer sein als die Obergrenze der vorherigen Kategorie. Andernfalls kehrt die Methode zurück, ohne eine neue Kategorie hinzuzufügen.

[signal] void QCategoryAxis::categoriesChanged()

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

QStringList QCategoryAxis::categoriesLabels()

Gibt die Liste der Bezeichnungen der Kategorien zurück.

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

int QCategoryAxis::count() const

Gibt die Anzahl der Kategorien zurück.

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

qreal QCategoryAxis::endValue(const QString &categoryLabel) const

Gibt den oberen Grenzwert der durch categoryLabel angegebenen Kategorie zurück.

void QCategoryAxis::remove(const QString &categoryLabel)

Entfernt eine durch das Label categoryLabel angegebene Kategorie von der Achse.

void QCategoryAxis::replaceLabel(const QString &oldLabel, const QString &newLabel)

Ersetzt eine bestehende Kategoriebezeichnung, die durch oldLabel angegeben wird, durch newLabel. Wenn die alte Bezeichnung nicht existiert, kehrt die Methode zurück, ohne Änderungen vorzunehmen.

void QCategoryAxis::setStartValue(qreal min)

Setzt min auf den unteren Grenzwert der ersten Kategorie auf der Achse. Wenn der Achse bereits Kategorien hinzugefügt wurden, muss der übergebene Wert kleiner als der obere Grenzwert des bereits definierten ersten Kategoriebereichs sein. Andernfalls wird nichts unternommen.

Hinweis: Setter-Funktion für die Eigenschaft startValue.

Siehe auch startValue().

qreal QCategoryAxis::startValue(const QString &categoryLabel = QString()) const

Liefert den unteren Grenzwert der durch categoryLabel angegebenen Kategorie.

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

Siehe auch setStartValue().

[override virtual] QAbstractAxis::AxisType QCategoryAxis::type() const

Reimplements: QValueAxis::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.