QLogValue3DAxisFormatter Class
The QLogValue3DAxisFormatter class provides formatting rules for a logarithmic value axis. More...
| Header: | #include <QLogValue3DAxisFormatter> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Since: | QtDataVisualization 1.1 |
| Instantiated By: | LogValueAxis3DFormatter |
| Inherits: | QValue3DAxisFormatter |
Properties
- autoSubGrid : bool
- base : qreal
- showEdgeLabels : bool
Public Functions
| QLogValue3DAxisFormatter(QObject *parent = nullptr) | |
| virtual | ~QLogValue3DAxisFormatter() |
| bool | autoSubGrid() const |
| qreal | base() const |
| void | setAutoSubGrid(bool enabled) |
| void | setBase(qreal base) |
| void | setShowEdgeLabels(bool enabled) |
| bool | showEdgeLabels() const |
Signals
| void | autoSubGridChanged(bool enabled) |
| void | baseChanged(qreal base) |
| void | showEdgeLabelsChanged(bool enabled) |
Detailed Description
When a formatter is attached to a value axis, the axis range cannot include negative values or the zero.
See also QValue3DAxisFormatter.
Property Documentation
autoSubGrid : bool
This property holds whether sub-grid positions are generated automatically.
If this property value is set to true, the parent axis sub-segment count is ignored when calculating sub-grid line positions. The sub-grid positions are generated automatically according to the base property value. The number of sub-grid lines is set to the base value minus one, rounded down. This property is ignored when the base value is zero. Defaults to true.
Access functions:
| bool | autoSubGrid() const |
| void | setAutoSubGrid(bool enabled) |
Notifier signal:
| void | autoSubGridChanged(bool enabled) |
See also base and QValue3DAxis::subSegmentCount.
base : qreal
This property holds the base of the logarithm used to map axis values.
If the base is non-zero, the parent axis segment count will be ignored when the grid line and label positions are calculated. If you want the range to be divided into equal segments like a normal value axis, set this property value to zero.
The base has to be zero or a positive value and it cannot be equal to one. Defaults to ten.
Access functions:
| qreal | base() const |
| void | setBase(qreal base) |
Notifier signal:
| void | baseChanged(qreal base) |
See also QValue3DAxis::segmentCount.
showEdgeLabels : bool
This property holds whether the first and last label on the axis are visible.
When the base property value is non-zero, the whole axis range is often not equally divided into segments. The first and last segments are often smaller than the other segments. In extreme cases, this can lead to overlapping labels on the first and last two grid lines. By setting this property to false, you can suppress showing the minimum and maximum labels for the axis in cases where the segments do not exactly fit the axis. Defaults to true.
Access functions:
| bool | showEdgeLabels() const |
| void | setShowEdgeLabels(bool enabled) |
Notifier signal:
| void | showEdgeLabelsChanged(bool enabled) |
See also base and QAbstract3DAxis::labels.
Member Function Documentation
[explicit] QLogValue3DAxisFormatter::QLogValue3DAxisFormatter(QObject *parent = nullptr)
Constructs a new logarithmic value 3D axis formatter with the optional parent parent.
[virtual noexcept] QLogValue3DAxisFormatter::~QLogValue3DAxisFormatter()
Deletes the logarithmic value 3D axis formatter.