QValue3DAxis Class

The QValue3DAxis class manipulates an axis of a graph. More...

Header: #include <QValue3DAxis>
CMake: find_package(Qt6 COMPONENTS DataVisualization REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Since: QtDataVisualization 1.0
Instantiated By: ValueAxis3D
Inherits: QAbstract3DAxis

Properties

Public Functions

QValue3DAxis(QObject *parent = nullptr)
virtual ~QValue3DAxis()
QValue3DAxisFormatter *formatter() const
QString labelFormat() const
bool reversed() const
int segmentCount() const
void setFormatter(QValue3DAxisFormatter *formatter)
void setLabelFormat(const QString &format)
void setReversed(bool enable)
void setSegmentCount(int count)
void setSubSegmentCount(int count)
int subSegmentCount() const

Signals

void formatterChanged(QValue3DAxisFormatter *formatter)
void labelFormatChanged(const QString &format)
void reversedChanged(bool enable)
void segmentCountChanged(int count)
void subSegmentCountChanged(int count)

Detailed Description

A value axis can be given a range of values and segment and subsegment counts to divide the range into.

Labels are drawn between each segment. Grid lines are drawn between each segment and each subsegment.

Note: If visible, there will always be at least two grid lines and labels indicating the minimum and the maximum values of the range, as there is always at least one segment.

Property Documentation

[since QtDataVisualization 1.1] formatter : QValue3DAxisFormatter*

This property holds the axis formatter to be used.

Any existing formatter is deleted when a new formatter is set.

This property was introduced in QtDataVisualization 1.1.

Access functions:

QValue3DAxisFormatter *formatter() const
void setFormatter(QValue3DAxisFormatter *formatter)

Notifier signal:

void formatterChanged(QValue3DAxisFormatter *formatter)

labelFormat : QString

This property holds the label format to be used for the labels on this 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.

If QAbstract3DGraph::locale is anything else than "C", the supported specifiers are limited to: d, e, E, f, g, G, and i. Also, only the precision modifier is supported. The rest of the formatting comes from the default QLocale of the application.

Usage example:

axis->setLabelFormat("%.2f mm");

Access functions:

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

Notifier signal:

void labelFormatChanged(const QString &format)

See also formatter and QAbstract3DGraph::locale.

[since QtDataVisualization 1.1] reversed : bool

This property holds whether the axis is rendered in reverse.

If true, the axis will be rendered in reverse, i.e. the positions of minimum and maximum values are swapped when the graph is rendered. This property doesn't affect the actual minimum and maximum values of the axis.

This property was introduced in QtDataVisualization 1.1.

Access functions:

bool reversed() const
void setReversed(bool enable)

Notifier signal:

void reversedChanged(bool enable)

segmentCount : int

This property holds the number of segments on the axis.

This indicates how many labels are drawn. The number of grid lines to be drawn is calculated with formula: segments * subsegments + 1. The preset default is 5. The value cannot be below 1.

Access functions:

int segmentCount() const
void setSegmentCount(int count)

Notifier signal:

void segmentCountChanged(int count)

See also setSubSegmentCount().

subSegmentCount : int

This property holds the number of subsegments inside each segment on the axis.

Grid lines are drawn between each subsegment, in addition to each segment. The preset default is 1. The value cannot be below 1.

Access functions:

int subSegmentCount() const
void setSubSegmentCount(int count)

Notifier signal:

void subSegmentCountChanged(int count)

See also setSegmentCount().

Member Function Documentation

QValue3DAxis::QValue3DAxis(QObject *parent = nullptr)

Constructs QValue3DAxis with the given parent.

[virtual] QValue3DAxis::~QValue3DAxis()

Destroys QValue3DAxis.

© 2024 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.