QValueAxis Class
QValueAxis 类为图表的坐标轴添加值。更多
| Header: | #include <QValueAxis> |
| In QML: | ValueAxis |
| Inherits: | QAbstractAxis |
| Inherited By: |
公共类型
| 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
该属性用于保存轴的标签格式。
格式字符串支持printf() 在标准 C++ 库中提供的以下转换指定符、长度修饰符和标志：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) |
Notifier 信号：
| 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) |
Notifier 信号：
| void | tickIntervalChanged(qreal interval) |
tickType : TickType
该属性用于保存刻度线和标签的定位方法。
访问功能：
| QValueAxis::TickType | tickType() const |
| void | setTickType(QValueAxis::TickType type) |
Notifier 信号：
| 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() 常量。
返回轴的类型。
© 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.
