QCategoryAxis Class
Die Klasse „QCategoryAxis“ platziert benannte Bereiche auf der Achse. Mehr...
| Header: | #include <QCategoryAxis> |
| In QML: | CategoryAxis |
| Inherits: | QValueAxis |
| Status: | Deprecated |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Öffentliche Typen
| enum | AxisLabelsPosition { AxisLabelsPositionCenter, AxisLabelsPositionOnValue } |
Eigenschaften
- categoriesLabels : QStringList
- count : int
- labelsPosition : AxisLabelsPosition
- startValue : qreal
Ö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 |
Neu implementierte öffentliche Funktionen
| virtual QAbstractAxis::AxisType | type() const override |
Signale
| void | categoriesChanged() |
| void | labelsPositionChanged(QCategoryAxis::AxisLabelsPosition position) |
Ausführliche Beschreibung
Diese Klasse kann verwendet werden, um die zugrunde liegenden Daten durch Hinzufügen beschrifteter Kategorien zu erläutern. Im Gegensatz zu „ QBarCategoryAxis “ ermöglicht „QCategoryAxis“ die freie Festlegung der Breiten der Kategoriebereiche.
Beispielcode zur 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);Dokumentation zu den Mitgliedstypen
enum QCategoryAxis::AxisLabelsPosition
Diese Enumeration beschreibt die Position der Kategoriebezeichnungen.
| Konstante | Wert | Beschreibung |
|---|---|---|
QCategoryAxis::AxisLabelsPositionCenter | 0x0 | Die Beschriftungen werden innerhalb der Kategorie zentriert. |
QCategoryAxis::AxisLabelsPositionOnValue | 0x1 | Die Beschriftungen werden an der oberen Grenze der Kategorie positioniert. |
Eigenschaftsdokumentation
[read-only] categoriesLabels : QStringList
Diese Eigenschaft enthält die Kategoriebezeichnungen als Zeichenfolgenliste.
Zugriffsfunktionen:
| QStringList | categoriesLabels() |
[read-only] count : int
Diese Eigenschaft gibt die Anzahl der Kategorien an.
Zugriffsfunktionen:
| int | count() const |
labelsPosition : AxisLabelsPosition
Diese Eigenschaft legt die Position der Kategoriebezeichnungen fest. Die Bezeichnungen am Anfang und am Ende der Achsen können sich mit den Bezeichnungen anderer Achsen überschneiden, wenn sie auf den Wert ausgerichtet sind.
Zugriffsfunktionen:
| QCategoryAxis::AxisLabelsPosition | labelsPosition() const |
| void | setLabelsPosition(QCategoryAxis::AxisLabelsPosition position) |
Benachrichtigungssignal:
| void | labelsPositionChanged(QCategoryAxis::AxisLabelsPosition position) |
startValue : qreal
Diese Eigenschaft bestimmt den unteren Grenzwert der ersten Kategorie auf der Achse.
Zugriffsfunktionen:
| qreal | startValue(const QString &categoryLabel = QString()) const |
| void | setStartValue(qreal min) |
Dokumentation zu den Member-Funktionen
[explicit] QCategoryAxis::QCategoryAxis(QObject *parent = nullptr)
Erstellt ein Achsenobjekt, das ein untergeordnetes Element von „ parent “ ist.
[virtual noexcept] QCategoryAxis::~QCategoryAxis()
Löscht das Objekt.
void QCategoryAxis::append(const QString &categoryLabel, qreal categoryEndValue)
Fügt der Achse eine neue Kategorie mit der Bezeichnung „ categoryLabel “ hinzu. Eine Kategoriebezeichnung muss eindeutig sein. „ categoryEndValue “ gibt die Obergrenze der Kategorie an. Sie muss größer sein als die Obergrenze der vorherigen Kategorie. Andernfalls bricht die Methode ab, 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 die Obergrenze der durch ` categoryLabel` angegebenen Kategorie zurück.
void QCategoryAxis::remove(const QString &categoryLabel)
Entfernt eine Kategorie, die durch die Bezeichnung „ categoryLabel “ angegeben ist, von der Achse.
void QCategoryAxis::replaceLabel(const QString &oldLabel, const QString &newLabel)
Ersetzt eine vorhandene Kategoriebezeichnung, die durch ` oldLabel ` angegeben ist, durch ` newLabel`. Wenn die alte Bezeichnung nicht existiert, kehrt die Methode ohne Änderungen zurück.
void QCategoryAxis::setStartValue(qreal min)
Legt „ min “ als untere Grenze der ersten Kategorie auf der Achse fest. Wenn der Achse bereits Kategorien hinzugefügt wurden, muss der übergebene Wert kleiner sein als der obere Grenzwert des bereits definierten Bereichs der ersten Kategorie. Andernfalls erfolgt keine Änderung.
Hinweis: Setter -Funktion für die Eigenschaft ` startValue`.
Siehe auch ` startValue()`.
qreal QCategoryAxis::startValue(const QString &categoryLabel = QString()) const
Gibt die untere Grenze der durch ` categoryLabel` angegebenen Kategorie zurück.
Hinweis: Getter -Funktion für die Eigenschaft „startValue“.
Siehe auch „ setStartValue()“.
[override virtual] QAbstractAxis::AxisType QCategoryAxis::type() const
Implementiert: ` QValueAxis::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.
