QValueAxis Class

QValueAxis 类为图表的坐标轴添加数值。更多

Header: #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
qreal max() const
qreal min() const
qreal pan() const
void setLabelDecimals(int decimals)
void setLabelFormat(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 zoom() const

重新实现的公共函数

virtual QAbstractAxis::AxisType type() const override

信号

void labelDecimalsChanged(int decimals)
void labelFormatChanged(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 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。

默认值为空,在这种情况下使用 "f "格式。

访问函数:

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

Notifier 信号:

void labelFormatChanged(const QString &format)

另请参见 QString::asprintf().

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)

Notifier 信号:

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)

[since 6.9] zoom : qreal

该属性用于保存坐标轴的缩放值。

缩放值可放大或缩小坐标轴,从而放大或缩小图形,但不会影响网格和标签的间隔。默认值为 1。

此属性在 Qt 6.9 中引入。

访问功能:

qreal zoom() const
void setZoom(qreal zoom)

Notifier 信号:

void zoomChanged(qreal zoom)

成员函数 文档

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

构造一个轴对象,它是parent 的子对象。

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

销毁对象。

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

设置坐标轴上从minmax 的范围。如果min 大于max ,则返回,不做任何更改。

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

重实现:QAbstractAxis::type() 常量。

返回轴的类型。

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