QValueAxis Class

The QValueAxis class adds values to a graph's axes. More...

Header: #include <QValueAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
In QML: ValueAxis
Inherits: QAbstractAxis

Properties

Public Functions

QValueAxis(QObject *parent = nullptr)
virtual ~QValueAxis() override
int labelDecimals() const
QString labelFormat() const
qreal max() const
qreal min() const
void setLabelDecimals(int decimals)
void setLabelFormat(const QString &format)
void setMax(qreal max)
void setMin(qreal min)
void setRange(qreal min, qreal max)
void setSubTickCount(qsizetype count)
void setTickAnchor(qreal anchor)
void setTickInterval(qreal interval)
qsizetype subTickCount() const
qreal tickAnchor() const
qreal tickInterval() const

Reimplemented Public Functions

virtual QAbstractAxis::AxisType type() const override

Signals

void labelDecimalsChanged(int decimals)
void labelFormatChanged(const QString &format)
void maxChanged(qreal max)
void minChanged(qreal min)
void subTickCountChanged(qsizetype subTickCount)
void tickAnchorChanged(qreal tickAnchor)
void tickIntervalChanged(qreal tickInterval)

Detailed Description

A value axis can be set up to show an axis line with tick marks, grid lines, and shades. The values on the axis are drawn at the positions of tick marks.

Property Documentation

labelDecimals : int

This property holds the number of decimals used for showing the labels. When set to -1, decimal amount is adjusted automatically based on the values range. The default value is -1.

Access functions:

int labelDecimals() const
void setLabelDecimals(int decimals)

Notifier signal:

void labelDecimalsChanged(int decimals)

labelFormat : QString

This property holds the label format of the axis.

The format string supports the following conversion specifiers, length modifiers, and flags provided by printf() in the standard C++ library: d, i, o, x, X, f, F, e, E, g, G, c.

The default value is empty, in which case 'f' format is used.

Access functions:

QString labelFormat() const
void setLabelFormat(const QString &format)

Notifier signal:

void labelFormatChanged(const QString &format)

See also QString::asprintf().

max : qreal

This property holds the maximum value on the axis.

When setting this property, the minimum value is adjusted if necessary, to ensure that the range remains valid. The default value is 10.0

Access functions:

qreal max() const
void setMax(qreal max)

Notifier signal:

void maxChanged(qreal max)

min : qreal

This property holds the minimum value on the axis.

When setting this property, the maximum value is adjusted if necessary, to ensure that the range remains valid. The default value is 0.0

Access functions:

qreal min() const
void setMin(qreal min)

Notifier signal:

void minChanged(qreal min)

subTickCount : qsizetype

This property holds the number of subticks on the axis. This indicates how many subticks are drawn between major lines on the graph. Labels are not drawn for subticks. The default value is 0.

Access functions:

qsizetype subTickCount() const
void setSubTickCount(qsizetype count)

Notifier signal:

void subTickCountChanged(qsizetype subTickCount)

tickAnchor : qreal

This property holds the base value where the dynamically placed tick marks and labels are started from. The default value is 0.

Access functions:

qreal tickAnchor() const
void setTickAnchor(qreal anchor)

Notifier signal:

void tickAnchorChanged(qreal tickAnchor)

tickInterval : qreal

This property holds the interval between dynamically placed tick marks and labels. The default value is 0, which means that intervals are automatically calculated based on the min and max range.

Access functions:

qreal tickInterval() const
void setTickInterval(qreal interval)

Notifier signal:

void tickIntervalChanged(qreal tickInterval)

Member Function Documentation

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

Constructs an axis object that is a child of parent.

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

Destroys the object.

void QValueAxis::setRange(qreal min, qreal max)

Sets the range from min to max on the axis. If min is greater than max, this function returns without making any changes.

[override virtual] QAbstractAxis::AxisType QValueAxis::type() const

Reimplements: QAbstractAxis::type() const.

Returns the type of the axis.