QValueAxis Class
QValueAxis 类用于在图表的坐标轴上添加数值。更多内容...
| 头文件: | #include <QValueAxis> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| 在 QML 中: | ValueAxis |
| 继承自: | QAbstractAxis |
- 所有成员列表(包括继承的成员)
- QValueAxis 属于Qt Graphs 的2D C++ 类。
属性
|
|
公共函数
| 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 |
重新实现的公共函数
| virtual QAbstractAxis::AxisType | type() const override |
信号
| 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) |
属性文档
labelDecimals : int
该属性用于指定显示标签时的小数位数。当设置为 -1 时,小数位数会根据数值范围自动调整。默认值为 -1。
访问函数:
| int | labelDecimals() const |
| void | setLabelDecimals(int decimals) |
通知信号:
| void | labelDecimalsChanged(int decimals) |
labelFormat : QString
该属性存储了坐标轴的标签格式。
该格式字符串支持标准 C++ 库中 `printf() ` 提供的以下转换指定符、长度修饰符和标志:d、i、o、x、X、f、F、e、E、g、G、c。随后,格式化后的字符串将通过 `QValueAxis::labelPostFormat` 进行处理。
默认值为空,此时将使用“f”格式。
访问函数:
| QString | labelFormat() const |
| void | setLabelFormat(const QString &format) |
通知器信号:
| void | labelFormatChanged(const QString &format) |
另请参阅 QString::asprintf()。
[since 6.12] labelPostFormat : QString
该属性存储了坐标轴的标签帖子格式。
标签首先会经过QValueAxis::labelFormat 进行值格式化,然后经过此属性处理。
默认值为“%1”。
该枚举在 Qt 6.12 中引入。
访问函数:
| QString | labelPostFormat() const |
| void | setLabelPostFormat(const QString &format) |
通知信号:
| void | labelPostFormatChanged(const QString &format) |
另请参阅 QString::arg()。
max : qreal
该属性存储了该轴上的最大值。
设置此属性时,系统会根据需要调整最小值,以确保范围保持有效。默认值为 10.0
访问函数:
| qreal | max() const |
| void | setMax(qreal max) |
通知信号:
| void | maxChanged(qreal max) |
min : qreal
该属性存储了该轴上的最小值。
设置此属性时,系统会根据需要调整最大值,以确保范围保持有效。默认值为 0.0
访问函数:
| qreal | min() const |
| void | setMin(qreal min) |
通知信号:
| void | minChanged(qreal min) |
[since 6.9] pan : qreal
该属性存储坐标轴的平移值。
平移值可移动坐标轴的中心,同时不会影响网格和标签的间隔。默认值为 0。
该枚举类型在 Qt 6.9 中引入。
访问函数:
| qreal | pan() const |
| void | setPan(qreal pan) |
通知器信号:
| void | panChanged(qreal pan) |
subTickCount : qsizetype
该属性存储轴上的刻度子刻度数量。这表示图表中主刻度线之间绘制了多少个刻度子刻度。刻度子刻度不显示标签。默认值为 0。
访问函数:
| qsizetype | subTickCount() const |
| void | setSubTickCount(qsizetype count) |
通知信号:
| void | subTickCountChanged(qsizetype subTickCount) |
tickAnchor : qreal
该属性存储动态放置的刻度线和标签的起始基准值。默认值为 0。
访问函数:
| qreal | tickAnchor() const |
| void | setTickAnchor(qreal anchor) |
通知信号:
| void | tickAnchorChanged(qreal tickAnchor) |
tickInterval : qreal
该属性用于指定动态放置的分度线和标签之间的间隔。默认值为 0,这意味着间隔将根据范围的最小值和最大值自动计算。
访问函数:
| qreal | tickInterval() const |
| void | setTickInterval(qreal interval) |
通知信号:
| void | tickIntervalChanged(qreal tickInterval) |
[read-only, since 6.11] visualMax : qreal
该属性存储了坐标轴的视觉最大值。
当轴被平移或缩放时,此属性保存轴的视觉最大值。默认值为QValueAxis::max
该枚举在 Qt 6.11 中引入。
访问函数:
| qreal | visualMax() const |
通知器信号:
| void | visualMaxChanged(qreal newVisualMax) |
[read-only, since 6.11] visualMin : qreal
该属性保存了坐标轴的视觉最小值。
当轴经过平移或缩放操作时,该属性保存轴的视觉最小值。默认值为QValueAxis::min
该枚举类型自 Qt 6.11 起引入。
访问函数:
| qreal | visualMin() const |
通知器信号:
| void | visualMinChanged(qreal newVisualMin) |
[since 6.9] zoom : qreal
该属性存储坐标轴的缩放值。
缩放值可放大或缩小坐标轴(从而改变图形的大小),同时不会影响网格间隔和标注。默认值为 1。
该枚举类型在 Qt 6.9 中引入。
访问函数:
| qreal | zoom() const |
| void | setZoom(qreal zoom) |
通知器信号:
| void | zoomChanged(qreal zoom) |
成员函数文档
[explicit] QValueAxis::QValueAxis(QObject *parent = nullptr)
创建一个作为parent 子节点的轴对象。
[override virtual noexcept] QValueAxis::~QValueAxis()
销毁该对象。
void QValueAxis::setRange(qreal min, qreal max)
将坐标轴的范围设置为min 到max 。如果min 大于max ,则该函数不进行任何更改并返回。
[override virtual] QAbstractAxis::AxisType QValueAxis::type() const
重写了:QAbstractAxis::type() const。
返回轴的类型。
© 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.