QValueAxis Class
QValueAxis 类用于在图表的坐标轴上添加数值。更多内容...
| Header: | #include <QValueAxis> |
| In QML: | ValueAxis |
| Inherits: | QAbstractAxis |
| Inherited By: | |
| Status: | Deprecated |
该类已弃用。我们强烈建议不要在新代码中使用它。
公共类型
| enum | TickType { TicksDynamic, TicksFixed } |
属性
|
|
公共函数
| QValueAxis(QObject *parent = nullptr) | |
| virtual | ~QValueAxis() |
| QString | labelFormat() const |
| qreal | max() const |
| qreal | min() const |
| int | minorTickCount() const |
| void | setLabelFormat(const QString &format) |
| void | setMax(qreal max) |
| void | setMin(qreal min) |
| void | setMinorTickCount(int count) |
| void | setRange(qreal min, qreal max) |
| void | setTickAnchor(qreal anchor) |
| void | setTickCount(int count) |
| void | setTickInterval(qreal insterval) |
| void | setTickType(QValueAxis::TickType type) |
| qreal | tickAnchor() const |
| int | tickCount() const |
| qreal | tickInterval() const |
| QValueAxis::TickType | tickType() const |
重新实现的公共函数
| virtual QAbstractAxis::AxisType | type() const override |
公共插槽
| void | applyNiceNumbers() |
信号
| void | labelFormatChanged(const QString &format) |
| void | maxChanged(qreal max) |
| void | minChanged(qreal min) |
| void | minorTickCountChanged(int minorTickCount) |
| void | rangeChanged(qreal min, qreal max) |
| void | tickAnchorChanged(qreal anchor) |
| void | tickCountChanged(int tickCount) |
| void | tickIntervalChanged(qreal interval) |
| void | tickTypeChanged(QValueAxis::TickType type) |
详细说明
可以设置一个数值轴，以显示带有刻度、网格线和阴影的轴线。轴上的数值会绘制在刻度位置处。
以下示例代码演示了如何使用 QValueAxis 类：
QChartView *chartView = new QChartView;
QLineSeries *series = new QLineSeries;
// ...
chartView->chart()->addSeries(series);
QValueAxis *axisX = new QValueAxis;
axisX->setRange(10, 20.5);
axisX->setTickCount(10);
axisX->setLabelFormat("%.2f");
chartView->chart()->setAxisX(axisX, series);成员类型文档
enum QValueAxis::TickType
此枚举描述了刻度和标签在坐标轴上的位置。
| 常量 | 值 | 描述 |
|---|---|---|
QValueAxis::TicksDynamic | 0 | 刻度根据tickAnchor 和tickInterval 的值进行放置。 |
QValueAxis::TicksFixed | 1 | 刻度均匀分布在坐标轴范围内。tickCount 值指定刻度的数量。 |
属性文档
labelFormat : QString
该属性存储了坐标轴的标签格式。
该格式字符串支持标准 C++ 库中printf() 提供的以下转换指定符、长度修饰符和标志：d、i、o、x、X、f、F、e、E、g、G、c。
如果QChart::localizeNumbers 的值是true ，则支持的指定符仅限于：d、e、E、f、g、G和i。此外，仅支持精度修饰符。其余格式设置来自应用程序的默认QLocale 。
访问函数：
| QString | labelFormat() const |
| void | setLabelFormat(const QString &format) |
通知信号：
| void | labelFormatChanged(const QString &format) |
另请参阅 QString::asprintf()。
max : qreal
该属性存储了轴上的最大值。
设置此属性时，系统会在必要时调整最小值，以确保范围保持有效。
访问函数：
| qreal | max() const |
| void | setMax(qreal max) |
通知信号：
| void | maxChanged(qreal max) |
min : qreal
该属性存储了轴上的最小值。
设置此属性时，系统会根据需要调整最大值，以确保范围保持有效。
访问函数：
| qreal | min() const |
| void | setMin(qreal min) |
通知信号：
| void | minChanged(qreal min) |
minorTickCount : int
此属性用于指定轴上的次要刻度数量。这表示图表中主要刻度之间会绘制多少条网格线。次要刻度不会显示标签。默认值为 0。
访问函数：
| int | minorTickCount() const |
| void | setMinorTickCount(int count) |
通知信号：
| void | minorTickCountChanged(int minorTickCount) |
tickAnchor : qreal
该属性保存动态放置的刻度线和标签的起始基准值。
访问函数：
| qreal | tickAnchor() const |
| void | setTickAnchor(qreal anchor) |
通知信号：
| void | tickAnchorChanged(qreal anchor) |
tickCount : int
该属性用于指定轴上的刻度线数量。这表示图表上绘制的网格线数量。默认值为 5，且该数值不能小于 2。
访问函数：
| int | tickCount() const |
| void | setTickCount(int count) |
通知信号：
| void | tickCountChanged(int tickCount) |
tickInterval : qreal
该属性控制动态放置的刻度线与刻度标签之间的间隔。
访问函数：
| qreal | tickInterval() const |
| void | setTickInterval(qreal insterval) |
通知信号：
| void | tickIntervalChanged(qreal interval) |
tickType : TickType
该属性用于指定刻度和标签的定位方式。
访问函数：
| QValueAxis::TickType | tickType() const |
| void | setTickType(QValueAxis::TickType type) |
通知器信号：
| void | tickTypeChanged(QValueAxis::TickType type) |
成员函数文档
[explicit] QValueAxis::QValueAxis(QObject *parent = nullptr)
创建一个作为parent 子节点的轴对象。
[virtual noexcept] QValueAxis::~QValueAxis()
销毁该对象。
[slot] void QValueAxis::applyNiceNumbers()
调整坐标轴上当前的刻度范围和刻度数量，使其外观美观。该算法将能够表示为 1*10^n、2*10^n 或 5*10^n 形式的数值视为“美观数值”。这些数值用于设置刻度间距。
另请参阅 setRange() 和setTickCount()。
[signal] void QValueAxis::labelFormatChanged(const QString &format)
当坐标轴标签的format 属性发生变化时，会触发此信号。
注意： 这是属性labelFormat的通知器 信号。
[signal] void QValueAxis::maxChanged(qreal max)
当由max 指定的轴的最大值发生变化时，会触发此信号。
注意： 这是属性max的通知器 信号。
[signal] void QValueAxis::minChanged(qreal min)
当由min 指定的轴的最小值发生变化时，将触发此信号。
注意： 这是属性min的通知器 信号。
[signal] void QValueAxis::minorTickCountChanged(int minorTickCount)
当轴上的小刻度数量（由minorTickCount 指定）发生变化时，将发出此信号。
注意： 这是属性minorTickCount的通知 信号。
[signal] void QValueAxis::rangeChanged(qreal min, qreal max)
当由min 和max 指定的轴的最小值或最大值发生变化时，会发出此信号。
void QValueAxis::setRange(qreal min, qreal max)
将坐标轴的范围设置为min 到max 。如果min 大于max ，则该函数不进行任何更改并直接返回。
[signal] void QValueAxis::tickCountChanged(int tickCount)
当由tickCount 指定的坐标轴刻度数发生变化时，会触发此信号。
注意： 这是属性tickCount的通知器 信号。
[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.
