Back to Qt.io
Contact Us Blog Download Qt
Auf dieser Seite

QLogValueAxis Class

Die Klasse „QLogValueAxis“ fügt den Achsen eines Diagramms logarithmische Werte hinzu. Mehr...

Header: #include <QLogValueAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
Seit: Qt 6.12
In QML: LogValueAxis
Erbt von: QAbstractAxis

Eigenschaften

Öffentliche Funktionen

QLogValueAxis(QObject *parent = nullptr)
virtual ~QLogValueAxis() override
qreal base() const
QString labelFormat() const
QString labelPostFormat() const
int labelPrecision() const
qreal max() const
qreal min() const
qreal pan() const
void setBase(qreal base)
void setLabelFormat(const QString &format)
void setLabelPostFormat(const QString &format)
void setLabelPrecision(int decimals)
void setMax(qreal max)
void setMin(qreal min)
void setPan(qreal pan)
void setRange(qreal min, qreal max)
void setSubTickCount(qsizetype count)
void setZoom(qreal zoom)
qsizetype subTickCount() const
qsizetype tickCount() const
qreal visualMax() const
qreal visualMin() const
qreal zoom() const

Neu implementierte öffentliche Funktionen

virtual QAbstractAxis::AxisType type() const override

Signale

void baseChanged(qreal base)
void labelFormatChanged(const QString &format)
void labelPostFormatChanged(const QString &format)
void labelPrecisionChanged(int precision)
void maxChanged(qreal max)
void minChanged(qreal min)
void panChanged(qreal pan)
void subTickCountChanged(qsizetype subTickCount)
void tickCountChanged(qsizetype tickCount)
void visualMaxChanged(qreal visualMax)
void visualMinChanged(qreal visualMin)
void zoomChanged(qreal zoom)

Neu implementierte geschützte Funktionen

virtual bool event(QEvent *event) override

Ausführliche Beschreibung

Eine logarithmische 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 eingezeichnet.

Dokumentation der Eigenschaften

base : qreal

Diese Basis des Logarithmus.

Der Wert muss größer als 0 sein und darf nicht gleich 1 sein. Der Standardwert ist 10,0

Zugriffsfunktionen:

qreal base() const
void setBase(qreal base)

Benachrichtigungssignal:

void baseChanged(qreal base)

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 ` QLogValueAxis::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 „ QLogValueAxis::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().

labelPrecision : int

Diese Eigenschaft gibt die maximale Anzahl der signifikanten Stellen an, die für die Anzeige der Beschriftungen verwendet werden. Der Standardwert ist 6. Eine negative Genauigkeit wird zugunsten des Standardwerts 6 ignoriert.

Zugriffsfunktionen:

int labelPrecision() const
void setLabelPrecision(int decimals)

Benachrichtigungssignal:

void labelPrecisionChanged(int precision)

max : qreal

Diese Eigenschaft gibt den Maximalwert auf der Achse an.

Beim Festlegen dieser Eigenschaft wird der Minimalwert bei Bedarf 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)

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.

Zugriffsfunktionen:

qreal pan() const
void setPan(qreal pan)

Benachrichtigungssignal:

void panChanged(qreal pan)

subTickCount : qsizetype

Diese Eigenschaft enthält die Anzahl der Unterteiler auf der Achse. Sie gibt an, wie viele Unterteiler zwischen den Hauptlinien im Diagramm gezeichnet werden. Für Unterteiler werden keine Beschriftungen gezeichnet. Wenn Sie den Wert auf -1 setzen, wird die Anzahl der Unterteiler auf den nächstgelegenen ganzzahligen Wert der Logarithmusbasis gesetzt. Der Standardwert ist -1.

Zugriffsfunktionen:

qsizetype subTickCount() const
void setSubTickCount(qsizetype count)

Benachrichtigungssignal:

void subTickCountChanged(qsizetype subTickCount)

[read-only] tickCount : int

Diese Eigenschaft gibt die Anzahl der Skalenmarkierungen auf der Achse an. Dieser Wert ist schreibgeschützt.

Zugriffsfunktionen:

qsizetype tickCount() const

Benachrichtigungssignal:

void tickCountChanged(qsizetype tickCount)

[read-only] visualMax : qreal

Diese Eigenschaft enthält den visuell maximalen Wert der Achse.

Diese Eigenschaft enthält den visuellen Maximalwert der Achse, wenn die Achse verschoben oder gezoomt wurde. Der Standardwert ist QLogValueAxis::max

Zugriffsfunktionen:

qreal visualMax() const

Benachrichtigungssignal:

void visualMaxChanged(qreal visualMax)

[read-only] visualMin : qreal

Diese Eigenschaft enthält den visuellen Mindestwert der Achse.

Diese Eigenschaft enthält einen visuellen Minimalwert der Achse, wenn die Achse verschoben oder gezoomt wurde. Der Standardwert ist QLogValueAxis::min

Zugriffsfunktionen:

qreal visualMin() const

Benachrichtigungssignal:

void visualMinChanged(qreal visualMin)

zoom : qreal

Diese Eigenschaft enthält den Zoomwert der Achse.

Der Zoomwert vergrößert oder verkleinert die Achse und damit das Diagramm, ohne die Intervalle des Rasters und der Beschriftungen zu beeinflussen. Der Standardwert ist 1.

Zugriffsfunktionen:

qreal zoom() const
void setZoom(qreal zoom)

Benachrichtigungssignal:

void zoomChanged(qreal zoom)

Dokumentation der Member-Funktionen

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

Erstellt ein Achsenobjekt, das ein untergeordnetes Element von „ parent “ ist.

[override virtual noexcept] QLogValueAxis::~QLogValueAxis()

Löscht das Objekt.

[override virtual protected] bool QLogValueAxis::event(QEvent *event)

Implementiert: ` QObject::event(QEvent *e)`.

void QLogValueAxis::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 QLogValueAxis::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.