QBarCategoryAxis Class
Die Klasse „QBarCategoryAxis“ fügt den Achsen eines Diagramms Kategorien hinzu. Mehr...
| Überschrift: | #include <QBarCategoryAxis> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | BarCategoryAxis |
| Erbt von: | QAbstractAxis |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QBarCategoryAxis ist Teil der C++-Klassen für 2D unterQt Graphs .
Öffentliche Typen
(since 6.11) enum class | LabelPosition { Center, OnValue } |
Eigenschaften
|
Öffentliche Funktionen
| QBarCategoryAxis(QObject *parent = nullptr) | |
| virtual | ~QBarCategoryAxis() override |
| void | append(const QString &category) |
| void | append(const QStringList &categories) |
| QString | at(qsizetype index) const |
| QStringList | categories() |
| void | clear() |
| qsizetype | count() const |
| void | insert(qsizetype index, const QString &category) |
| QBarCategoryAxis::LabelPosition | labelPosition() const |
| QString | max() const |
| QString | min() const |
| void | remove(const QString &category) |
| void | remove(qsizetype index) |
| void | replace(const QString &oldCategory, const QString &newCategory) |
| void | setCategories(const QStringList &categories) |
| void | setLabelPosition(QBarCategoryAxis::LabelPosition position) |
| 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 | labelPositionChanged(QBarCategoryAxis::LabelPosition position) |
| void | maxChanged(const QString &max) |
| void | minChanged(const QString &min) |
Ausführliche Beschreibung
QBarCategoryAxis kann so eingerichtet werden, dass eine Achsenlinie mit Teilstrichen, Gitterlinien und Schattierungen angezeigt wird. Zwischen den Teilstrichen werden Kategorien eingezeichnet.
Dokumentation zu den Mitgliedstypen
[since 6.11] enum class QBarCategoryAxis::LabelPosition
Diese Enumeration beschreibt die Position der Kategoriebezeichnungen.
| Konstante | Wert | Beschreibung |
|---|---|---|
QBarCategoryAxis::LabelPosition::Center | 0 | Die Beschriftungen werden innerhalb der Kategorie zentriert. |
QBarCategoryAxis::LabelPosition::OnValue | 1 | Die Beschriftungen werden an der oberen Grenze der Kategorie positioniert. |
Diese Enumeration wurde in Qt 6.11 eingeführt.
Eigenschaftsdokumentation
categories : QStringList
Diese Eigenschaft enthält die Kategorien einer Achse.
Zugriffsfunktionen:
| QStringList | categories() |
| void | setCategories(const QStringList &categories) |
Benachrichtigungssignal:
| void | categoriesChanged() |
[read-only] count : qsizetype
Diese Eigenschaft gibt die Anzahl der Kategorien einer Achse an.
Zugriffsfunktionen:
| qsizetype | count() const |
Benachrichtigungssignal:
| void | countChanged() |
[since 6.11] labelPosition : LabelPosition
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 überlappen, wenn sie auf den Wert ausgerichtet sind.
Diese Aufzählung wurde in Qt 6.11 eingeführt.
Zugriffsfunktionen:
| QBarCategoryAxis::LabelPosition | labelPosition() const |
| void | setLabelPosition(QBarCategoryAxis::LabelPosition position) |
Notifier-Signal:
| void | labelPositionChanged(QBarCategoryAxis::LabelPosition position) |
max : QString
Diese Eigenschaft enthält den Maximalwert auf der Achse.
Der Maximalwert auf der Achse. Der angegebene Wert sollte in „ categories “ enthalten sein.
Zugriffsfunktionen:
Benachrichtigungssignal:
| void | maxChanged(const QString &max) |
min : QString
Diese Eigenschaft enthält den Minimalwert auf der Achse.
Der Minimalwert auf der Achse. Der angegebene Wert sollte in „ categories “ enthalten sein.
Zugriffsfunktionen:
Benachrichtigungssignal:
| void | minChanged(const QString &min) |
Dokumentation der Member-Funktionen
[explicit] QBarCategoryAxis::QBarCategoryAxis(QObject *parent = nullptr)
Erstellt ein Achsenobjekt, das ein untergeordnetes Element von „ parent “ ist.
[override virtual noexcept] QBarCategoryAxis::~QBarCategoryAxis()
Löscht das Achsenobjekt.
[invokable] 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ültiger QString sein und darf nicht doppelt vorhanden sein. Doppelte Kategorien werden nicht angehängt.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] 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 angehängt.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] QString QBarCategoryAxis::at(qsizetype index) const
Gibt die Kategorie unter index zurück.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
QStringList QBarCategoryAxis::categories()
Gibt die Kategorien zurück.
Hinweis: Getter -Funktion für die Eigenschaft „categories“.
Siehe auch ` setCategories()`.
[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.
qsizetype QBarCategoryAxis::count() const
Gibt die Anzahl der Kategorien zurück.
Hinweis: Getter -Funktion für die Eigenschaft „count“.
[invokable] void QBarCategoryAxis::insert(qsizetype index, const QString &category)
Fügt „ category “ zur Achse unter „ index “ ein. „ category “ muss ein gültiges „ QString “ sein und darf nicht doppelt vorhanden sein. Wenn „ category “ anderen Kategorien vorangestellt oder angehängt wird, werden die Minimal- und Maximalwerte auf der Achse entsprechend aktualisiert.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
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()“.
QString QBarCategoryAxis::min() const
Gibt die niedrigste Kategorie zurück.
Hinweis: Getter -Funktion für die Eigenschaft „min“.
Siehe auch „ setMin()“.
[invokable] void QBarCategoryAxis::remove(const QString &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.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QBarCategoryAxis::remove(qsizetype index)
Entfernt eine Kategorie unter index aus der Achse. Das Entfernen einer Kategorie, die derzeit den Maximal- oder Minimalwert auf der Achse festlegt, wirkt sich auf den Achsenbereich aus.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] void QBarCategoryAxis::replace(const QString &oldCategory, const QString &newCategory)
Ersetzt „ oldCategory “ durch „ newCategory “. Wenn „ oldCategory “ auf der Achse nicht vorhanden ist, erfolgt keine Änderung. „ newCategory “ muss ein gültiger „ QString “ sein und darf nicht doppelt vorhanden sein. Wenn die Minimal- oder Maximal-Kategorie ersetzt wird, werden die Minimal- und Maximalwerte auf der Achse entsprechend aktualisiert.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
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ültiges „ 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.
