本页内容

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(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.