QAbstractAxis Class
Die Klasse „QAbstractAxis“ ist eine Basisklasse für spezialisierte Achsenklassen. Mehr...
| Header: | #include <QAbstractAxis> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | AbstractAxis |
| Erbt von: | QObject |
| Vererbt an: | QBarCategoryAxis, „ QDateTimeAxis “, „ QLogValueAxis “ und QValueAxis |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QAbstractAxis ist Teil der C++-Klassen vonQt Graphs für 2D.
Öffentliche Typen
| enum class | AxisType { Value, BarCategory, DateTime, LogValue } |
Eigenschaften
|
|
Öffentliche Funktionen
| virtual | ~QAbstractAxis() override |
| Qt::Alignment | alignment() const |
| QColor | color() const |
| void | hide() |
| bool | isGridVisible() const |
| bool | isLineVisible() const |
| bool | isSubGridVisible() const |
| bool | isTitleVisible() const |
| bool | isVisible() const |
| QQmlComponent * | labelDelegate() const |
| qreal | labelsAngle() const |
| bool | labelsVisible() const |
| void | setAlignment(Qt::Alignment alignment) |
| void | setColor(QColor color) |
| void | setGridVisible(bool visible = true) |
| void | setLabelDelegate(QQmlComponent *newLabelDelegate) |
| void | setLabelsAngle(qreal angle) |
| void | setLabelsVisible(bool visible = true) |
| void | setLineVisible(bool visible = true) |
| void | setMax(const QVariant &max) |
| void | setMin(const QVariant &min) |
| void | setRange(const QVariant &min, const QVariant &max) |
| void | setSubColor(QColor color) |
| void | setSubGridVisible(bool visible = true) |
| void | setTextElideMode(Qt::TextElideMode elideMode) |
| void | setTitleColor(QColor color) |
| void | setTitleFont(const QFont &font) |
| void | setTitleText(const QString &title) |
| void | setTitleVisible(bool visible = true) |
| void | setVisible(bool visible = true) |
| void | show() |
| QColor | subColor() const |
| Qt::TextElideMode | textElideMode() const |
| QColor | titleColor() const |
| QFont | titleFont() const |
| QString | titleText() const |
| virtual QAbstractAxis::AxisType | type() const = 0 |
Signale
| void | alignmentChanged(Qt::Alignment alignment) |
| void | colorChanged(QColor newColor) |
| void | gridVisibleChanged(bool visible) |
| void | labelDelegateChanged() |
| void | labelsAngleChanged(qreal angle) |
| void | labelsVisibleChanged(bool visible) |
| void | lineVisibleChanged(bool visible) |
| void | subColorChanged(QColor newColor) |
| void | subGridVisibleChanged(bool visible) |
| void | textElideModeChanged(Qt::TextElideMode elideMode) |
| void | titleColorChanged(QColor color) |
| void | titleFontChanged(const QFont &font) |
| void | titleTextChanged(const QString &title) |
| void | titleVisibleChanged(bool visible) |
| void | update() |
| void | visibleChanged(bool visible) |
Detaillierte Beschreibung
Jede Reihe kann nur an eine horizontale und eine vertikale Achse gebunden werden.
Die Eigenschaften und die Sichtbarkeit verschiedener Achsenelemente wie Achsenlinie, Titel, Beschriftungen und Gitterlinien lassen sich individuell steuern.
Dokumentation zum Mitgliedstyp
enum class QAbstractAxis::AxisType
Dieser Enum-Typ gibt den Typ des Achsenobjekts an.
| Konstante | Wert |
|---|---|
QAbstractAxis::AxisType::Value | 0 |
QAbstractAxis::AxisType::BarCategory | 1 |
QAbstractAxis::AxisType::DateTime | 2 |
QAbstractAxis::AxisType::LogValue (since Qt 6.12) | 3 |
Eigenschaftsdokumentation
[since 6.9] alignment : Qt::Alignment
Diese Eigenschaft gibt die Ausrichtung der Achse an.
Mögliche Werte sind „ Qt::AlignLeft “, „ Qt::AlignRight “, „ Qt::AlignBottom “ oder „ Qt::AlignTop “.
Diese Aufzählung wurde in Qt 6.9 eingeführt.
Zugriffsfunktionen:
| Qt::Alignment | alignment() const |
| void | setAlignment(Qt::Alignment alignment) |
Notifier-Signal:
| void | alignmentChanged(Qt::Alignment alignment) |
color : QColor
Diese Eigenschaft legt die Farbe fest, die zum Zeichnen der Hauptskalenstriche und der Achsenlinie verwendet wird.
Sie überschreibt die Themenfarbe, selbst wenn sich das Thema ändert.
Zugriffsfunktionen:
| QColor | color() const |
| void | setColor(QColor color) |
Notifier-Signal:
| void | colorChanged(QColor newColor) |
gridVisible : bool
Diese Eigenschaft legt die Sichtbarkeit der Gitterlinien fest. Standardmäßig lautet der Wert „ true “.
Zugriffsfunktionen:
| bool | isGridVisible() const |
| void | setGridVisible(bool visible = true) |
Benachrichtigungssignal:
| void | gridVisibleChanged(bool visible) |
labelDelegate : QQmlComponent*
Diese Eigenschaft enthält eine benutzerdefinierte QML-Komponente, die als Beschriftung für die Achse verwendet wird. Diese Komponente sollte entweder eine „ Text “-Komponente sein oder den Text „property string text“ enthalten, damit dieser Eigenschaft der Wert der Beschriftung zugewiesen wird.
Zugriffsfunktionen:
| QQmlComponent * | labelDelegate() const |
| void | setLabelDelegate(QQmlComponent *newLabelDelegate) |
Notifier-Signal:
| void | labelDelegateChanged() |
labelsAngle : qreal
Diese Eigenschaft gibt den Winkel der Achsenbeschriftungen in Grad an.
Zugriffsfunktionen:
| qreal | labelsAngle() const |
| void | setLabelsAngle(qreal angle) |
Benachrichtigungssignal:
| void | labelsAngleChanged(qreal angle) |
labelsVisible : bool
Diese Eigenschaft legt fest, ob Achsenbeschriftungen sichtbar sind. Standardmäßig lautet der Wert „ true “.
Zugriffsfunktionen:
| bool | labelsVisible() const |
| void | setLabelsVisible(bool visible = true) |
Benachrichtigungssignal:
| void | labelsVisibleChanged(bool visible) |
lineVisible : bool
Diese Eigenschaft legt die Sichtbarkeit der Achsenlinie fest. Standardmäßig lautet der Wert „ true “.
Zugriffsfunktionen:
| bool | isLineVisible() const |
| void | setLineVisible(bool visible = true) |
Benachrichtigungssignal:
| void | lineVisibleChanged(bool visible) |
subColor : QColor
Diese Eigenschaft legt die Farbe fest, mit der die Untermarkierungen gezeichnet werden.
Sie überschreibt die Themenfarbe, selbst wenn sich das Thema ändert.
Zugriffsfunktionen:
| QColor | subColor() const |
| void | setSubColor(QColor color) |
Notifier-Signal:
| void | subColorChanged(QColor newColor) |
subGridVisible : bool
Diese Eigenschaft legt die Sichtbarkeit der Untergitterlinien fest.
Gilt nur für Achsen, die Untergitterlinien unterstützen. Standardmäßig lautet der Wert „ true “.
Zugriffsfunktionen:
| bool | isSubGridVisible() const |
| void | setSubGridVisible(bool visible = true) |
Benachrichtigungssignal:
| void | subGridVisibleChanged(bool visible) |
[since 6.10] textElideMode : Qt::TextElideMode
Diese Eigenschaft legt die Position der Auslassungspunkte bei Textüberlauf fest.
Mögliche Werte sind „ Qt::ElideLeft “, „ Qt::ElideRight “, „ Qt::ElideMiddle “ oder „ Qt::ElideNone “. Standardmäßig lautet der Wert „ Qt::ElideNone “.
Diese Aufzählung wurde in Qt 6.10 eingeführt.
Zugriffsfunktionen:
| Qt::TextElideMode | textElideMode() const |
| void | setTextElideMode(Qt::TextElideMode elideMode) |
Notifier-Signal:
| void | textElideModeChanged(Qt::TextElideMode elideMode) |
titleColor : QColor
Diese Eigenschaft legt die Farbe fest, mit der der Titeltext dargestellt wird.
Zugriffsfunktionen:
| QColor | titleColor() const |
| void | setTitleColor(QColor color) |
Notifier-Signal:
| void | titleColorChanged(QColor color) |
titleFont : QFont
Diese Eigenschaft legt die Schriftart des Achsen-Titels fest.
Zugriffsfunktionen:
| QFont | titleFont() const |
| void | setTitleFont(const QFont &font) |
Benachrichtigungssignal:
| void | titleFontChanged(const QFont &font) |
titleText : QString
Diese Eigenschaft enthält die Bezeichnung der Achse.
Standardmäßig leer. Achsenüberschriften unterstützen HTML-Formatierung.
Zugriffsfunktionen:
| QString | titleText() const |
| void | setTitleText(const QString &title) |
Benachrichtigungssignal:
| void | titleTextChanged(const QString &title) |
titleVisible : bool
Diese Eigenschaft legt die Sichtbarkeit des Achsen-Titels fest.
Standardmäßig lautet der Wert „ true “.
Zugriffsfunktionen:
| bool | isTitleVisible() const |
| void | setTitleVisible(bool visible = true) |
Benachrichtigungssignal:
| void | titleVisibleChanged(bool visible) |
visible : bool
Diese Eigenschaft legt die Sichtbarkeit der Achse fest. Standardmäßig lautet der Wert „ true “.
Zugriffsfunktionen:
| bool | isVisible() const |
| void | setVisible(bool visible = true) |
Benachrichtigungssignal:
| void | visibleChanged(bool visible) |
Dokumentation der Member-Funktionen
[override virtual noexcept] QAbstractAxis::~QAbstractAxis()
Löscht das Achsenobjekt. Wenn die Achse zu einem Diagramm hinzugefügt wird, übernimmt das Diagrammobjekt die Verantwortung dafür.
void QAbstractAxis::hide()
Blendet die Achsen, Beschriftungen und Gitterlinien aus.
void QAbstractAxis::setLineVisible(bool visible = true)
Legt fest, ob die Achsenlinie und die Skalenmarkierungen „ visible “ sind.
Hinweis: Setter -Funktion für die Eigenschaft „ lineVisible “.
Siehe auch „ isLineVisible()“.
void QAbstractAxis::setMax(const QVariant &max)
Legt den maximalen Wert fest, der auf der Achse angezeigt wird. Je nach dem tatsächlichen Achstyp wird der Parameter „ max “ in den entsprechenden Werttyp umgewandelt. Ist die Umwandlung nicht möglich, hat der Funktionsaufruf keine Auswirkung.
void QAbstractAxis::setMin(const QVariant &min)
Legt den auf der Achse angezeigten Mindestwert fest. Je nach dem tatsächlichen Achstyp wird der Parameter „ min “ in den entsprechenden Wertetyp umgewandelt. Ist die Umwandlung nicht möglich, hat der Funktionsaufruf keine Auswirkung.
void QAbstractAxis::setRange(const QVariant &min, const QVariant &max)
Legt den auf der Achse angezeigten Bereich fest. Je nach dem tatsächlichen Achstyp werden die Parameter „ min “ und „ max “ in entsprechende Werttypen umgewandelt. Ist die Umwandlung nicht möglich, hat der Funktionsaufruf keine Auswirkung.
void QAbstractAxis::setTitleColor(QColor color)
Legt die Farbe fest, die zum Zeichnen von Titeln verwendet wird: color.
Hinweis: Setter -Funktion für die Eigenschaft ` titleColor`.
Siehe auch „ titleColor()“.
void QAbstractAxis::setTitleFont(const QFont &font)
Legt die Schriftart fest, die zum Zeichnen von Titeln verwendet wird: font.
Hinweis: Setter -Funktion für die Eigenschaft „ titleFont “.
Siehe auch „ titleFont()“.
void QAbstractAxis::setVisible(bool visible = true)
Setzt die Sichtbarkeit der Achse, der Beschriftungen und der Gitterlinien auf „ visible “.
Hinweis: Setter -Funktion für die Eigenschaft „ visible “.
Siehe auch „ isVisible()“.
void QAbstractAxis::show()
Blendet die Achsen, Beschriftungen und Gitterlinien ein.
QColor QAbstractAxis::titleColor() const
Gibt die Farbe zurück, die zum Zeichnen von Titeln verwendet wird.
Hinweis: Getter -Funktion für die Eigenschaft „titleColor“.
Siehe auch „ setTitleColor()“.
QFont QAbstractAxis::titleFont() const
Gibt die Schriftart zurück, die zum Zeichnen von Titeln verwendet wird.
Hinweis: Getter -Funktion für die Eigenschaft „titleFont“.
Siehe auch „ setTitleFont()“.
[pure virtual] QAbstractAxis::AxisType QAbstractAxis::type() const
Gibt den Typ der Achse zurück.
[signal] void QAbstractAxis::update()
Dieses Signal wird ausgegeben, wenn die Achse aktualisiert werden muss.
© 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.
