QValueAxis Class
Die Klasse „QValueAxis“ fügt den Achsen eines Diagramms Werte hinzu. Mehr dazu...
| Header: | #include <QValueAxis> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | ValueAxis |
| Erbt von: | QAbstractAxis |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QValueAxis ist Teil der C++-Klassen für 2D unterQt Graphs .
Eigenschaften
|
|
Öffentliche Funktionen
| QValueAxis(QObject *parent = nullptr) | |
| virtual | ~QValueAxis() override |
| int | labelDecimals() const |
| QString | labelFormat() const |
| QString | labelPostFormat() const |
| qreal | max() const |
| qreal | min() const |
| qreal | pan() const |
| void | setLabelDecimals(int decimals) |
| void | setLabelFormat(const QString &format) |
| void | setLabelPostFormat(const QString &format) |
| void | setMax(qreal max) |
| void | setMin(qreal min) |
| void | setPan(qreal pan) |
| void | setRange(qreal min, qreal max) |
| void | setSubTickCount(qsizetype count) |
| void | setTickAnchor(qreal anchor) |
| void | setTickInterval(qreal interval) |
| void | setZoom(qreal zoom) |
| qsizetype | subTickCount() const |
| qreal | tickAnchor() const |
| qreal | tickInterval() const |
| qreal | visualMax() const |
| qreal | visualMin() const |
| qreal | zoom() const |
Neu implementierte öffentliche Funktionen
| virtual QAbstractAxis::AxisType | type() const override |
Signale
| void | labelDecimalsChanged(int decimals) |
| void | labelFormatChanged(const QString &format) |
| void | labelPostFormatChanged(const QString &format) |
| void | maxChanged(qreal max) |
| void | minChanged(qreal min) |
| void | panChanged(qreal pan) |
| void | subTickCountChanged(qsizetype subTickCount) |
| void | tickAnchorChanged(qreal tickAnchor) |
| void | tickIntervalChanged(qreal tickInterval) |
| void | visualMaxChanged(qreal newVisualMax) |
| void | visualMinChanged(qreal newVisualMin) |
| void | zoomChanged(qreal zoom) |
Ausführliche Beschreibung
Eine Werteachse kann so eingerichtet werden, dass sie eine Achsenlinie mit Skalenmarkierungen, Gitterlinien und Schattierungen anzeigt. Die Werte auf der Achse werden an den Positionen der Skalenmarkierungen dargestellt.
Eigenschaftsdokumentation
labelDecimals : int
Diese Eigenschaft gibt die Anzahl der Dezimalstellen an, die für die Anzeige der Beschriftungen verwendet werden. Bei der Einstellung -1 wird die Anzahl der Dezimalstellen automatisch entsprechend dem Wertebereich angepasst. Der Standardwert ist -1.
Zugriffsfunktionen:
| int | labelDecimals() const |
| void | setLabelDecimals(int decimals) |
Benachrichtigungssignal:
| void | labelDecimalsChanged(int decimals) |
labelFormat : QString
Diese Eigenschaft enthält das Beschriftungsformat der Achse.
Die Formatzeichenfolge unterstützt die folgenden Konvertierungsspezifizierer, Längenmodifikatoren und Flags, die von der Funktion ` printf() ` in der Standard-C++-Bibliothek bereitgestellt werden: d, i, o, x, X, f, F, e, E, g, G, c. Anschließend wird die formatierte Zeichenfolge durch die Funktion ` QValueAxis::labelPostFormat` verarbeitet.
Der Standardwert ist leer; in diesem Fall wird das Format „f“ verwendet.
Zugriffsfunktionen:
| QString | labelFormat() const |
| void | setLabelFormat(const QString &format) |
Benachrichtigungssignal:
| void | labelFormatChanged(const QString &format) |
Siehe auch QString::asprintf().
[since 6.12] labelPostFormat : QString
Diese Eigenschaft enthält das Post-Format der Achsenbeschriftung.
Die Beschriftung durchläuft zunächst „ QValueAxis::labelFormat “, um den Wert zu formatieren, und anschließend diese Eigenschaft.
Der Standardwert lautet „%1“.
Diese Aufzählung wurde in Qt 6.12 eingeführt.
Zugriffsfunktionen:
| QString | labelPostFormat() const |
| void | setLabelPostFormat(const QString &format) |
Notifier-Signal:
| void | labelPostFormatChanged(const QString &format) |
Siehe auch QString::arg().
max : qreal
Diese Eigenschaft gibt den Maximalwert auf der Achse an.
Beim Festlegen dieser Eigenschaft wird der Minimalwert gegebenenfalls angepasst, um sicherzustellen, dass der Bereich gültig bleibt. Der Standardwert ist 10,0
Zugriffsfunktionen:
| qreal | max() const |
| void | setMax(qreal max) |
Benachrichtigungssignal:
| void | maxChanged(qreal max) |
min : qreal
Diese Eigenschaft enthält den Minimalwert auf der Achse.
Beim Festlegen dieser Eigenschaft wird der Maximalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt. Der Standardwert ist 0,0
Zugriffsfunktionen:
| qreal | min() const |
| void | setMin(qreal min) |
Benachrichtigungssignal:
| void | minChanged(qreal min) |
[since 6.9] pan : qreal
Diese Eigenschaft enthält den Pan-Wert der Achse.
Der Pan-Wert verschiebt den Mittelpunkt der Achse, ohne die Abstände des Rasters und der Beschriftungen zu beeinflussen. Der Standardwert ist 0.
Diese Aufzählung wurde in Qt 6.9 eingeführt.
Zugriffsfunktionen:
| qreal | pan() const |
| void | setPan(qreal pan) |
Notifier-Signal:
| void | panChanged(qreal pan) |
subTickCount : qsizetype
Diese Eigenschaft gibt die Anzahl der Unterteilstriche auf der Achse an. Sie gibt an, wie viele Unterteilstriche zwischen den Hauptlinien im Diagramm gezeichnet werden. Für Unterteilstriche werden keine Beschriftungen angezeigt. Der Standardwert ist 0.
Zugriffsfunktionen:
| qsizetype | subTickCount() const |
| void | setSubTickCount(qsizetype count) |
Benachrichtigungssignal:
| void | subTickCountChanged(qsizetype subTickCount) |
tickAnchor : qreal
Diese Eigenschaft enthält den Basiswert, von dem aus die dynamisch platzierten Skalenmarkierungen und Beschriftungen beginnen. Der Standardwert ist 0.
Zugriffsfunktionen:
| qreal | tickAnchor() const |
| void | setTickAnchor(qreal anchor) |
Benachrichtigungssignal:
| void | tickAnchorChanged(qreal tickAnchor) |
tickInterval : qreal
Diese Eigenschaft legt den Abstand zwischen dynamisch platzierten Skalenmarkierungen und Beschriftungen fest. Der Standardwert ist 0, was bedeutet, dass die Abstände automatisch auf der Grundlage des minimalen und maximalen Bereichs berechnet werden.
Zugriffsfunktionen:
| qreal | tickInterval() const |
| void | setTickInterval(qreal interval) |
Benachrichtigungssignal:
| void | tickIntervalChanged(qreal tickInterval) |
[read-only, since 6.11] visualMax : qreal
Diese Eigenschaft enthält den visuell maximalen Wert der Achse.
Diese Eigenschaft enthält einen visuellen Maximalwert der Achse, wenn die Achse verschoben oder gezoomt wurde. Der Standardwert ist QValueAxis::max
Diese Aufzählung wurde in Qt 6.11 eingeführt.
Zugriffsfunktionen:
| qreal | visualMax() const |
Notifier-Signal:
| void | visualMaxChanged(qreal newVisualMax) |
[read-only, since 6.11] visualMin : qreal
Diese Eigenschaft enthält den visuellen Mindestwert der Achse.
Diese Eigenschaft enthält den visuellen Mindestwert der Achse, wenn die Achse verschoben oder gezoomt wurde. Der Standardwert ist QValueAxis::min
Diese Enumeration wurde in Qt 6.11 eingeführt.
Zugriffsfunktionen:
| qreal | visualMin() const |
Notifier-Signal:
| void | visualMinChanged(qreal newVisualMin) |
[since 6.9] zoom : qreal
Diese Eigenschaft enthält den Zoomwert der Achse.
Der Zoomwert vergrößert oder verkleinert die Achse und damit das Diagramm, ohne die Abstände der Rasterlinien und Beschriftungen zu beeinflussen. Der Standardwert ist 1.
Diese Enumeration wurde in Qt 6.9 eingeführt.
Zugriffsfunktionen:
| qreal | zoom() const |
| void | setZoom(qreal zoom) |
Notifier-Signal:
| void | zoomChanged(qreal zoom) |
Dokumentation der Member-Funktionen
[explicit] QValueAxis::QValueAxis(QObject *parent = nullptr)
Erstellt ein Achsenobjekt, das ein untergeordnetes Element von „ parent “ ist.
[override virtual noexcept] QValueAxis::~QValueAxis()
Löscht das Objekt.
void QValueAxis::setRange(qreal min, qreal max)
Legt den Bereich von min bis max auf der Achse fest. Ist min größer als max, kehrt diese Funktion ohne Änderungen zurück.
[override virtual] QAbstractAxis::AxisType QValueAxis::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.
