Back to Qt.io
Contact Us Blog Download Qt
本页内容

QLogValueAxis Class

QLogValueAxis 类为图表的坐标轴添加了对数刻度。更多内容...

Header: #include <QLogValueAxis>
In QML: LogValueAxis
Inherits: QAbstractAxis
Status: Deprecated

该类已弃用。我们强烈建议不要在新代码中使用它。

属性

公共函数

QLogValueAxis(QObject *parent = nullptr)
virtual ~QLogValueAxis()
qreal base() const
QString labelFormat() const
qreal max() const
qreal min() const
int minorTickCount() const
void setBase(qreal base)
void setLabelFormat(const QString &format)
void setMax(qreal max)
void setMin(qreal min)
void setMinorTickCount(int minorTickCount)
void setRange(qreal min, qreal max)
int tickCount() const

重新实现的公共函数

virtual QAbstractAxis::AxisType type() const override

信号

void baseChanged(qreal base)
void labelFormatChanged(const QString &format)
void maxChanged(qreal max)
void minChanged(qreal min)
void minorTickCountChanged(int minorTickCount)
void rangeChanged(qreal min, qreal max)
void tickCountChanged(int tickCount)

详细说明

对数刻度是一种基于数量级的非线性刻度，因此轴上的每个刻度标记都是前一个刻度标记乘以某个值的结果。

注意：如果 QLogValueAxis 连接到一个系列，而该系列在关联维度上包含一个或多个负值或零值的点，则该系列将完全不会被绘制。当使用 XYModelMappers 时，这一点尤为重要，因为模型中的空单元格通常包含零值。

属性文档

base : qreal

该性质规定了对数的底。

该值必须大于 0，且不能等于 1。

访问函数：

qreal base() const
void setBase(qreal base)

通知信号：

void baseChanged(qreal base)

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

该属性存储了该轴上的最大值。

设置此属性时，系统会根据需要调整最小值，以确保范围保持有效。该值必须大于 0。

访问函数：

qreal max() const
void setMax(qreal max)

通知信号：

void maxChanged(qreal max)

min : qreal

该属性存储了轴上的最小值。

设置此属性时，系统会根据需要调整最大值，以确保范围保持有效。该值必须大于 0。

访问函数：

qreal min() const
void setMin(qreal min)

通知信号：

void minChanged(qreal min)

minorTickCount : int

此属性用于指定轴上的小刻度数量。这表示图表中主刻度之间绘制的网格线数量。小刻度不会显示标签。默认值为 0。将该值设置为 -1 时，主刻度之间的网格线数量将自动计算。

访问函数：

int minorTickCount() const
void setMinorTickCount(int minorTickCount)

通知信号：

void minorTickCountChanged(int minorTickCount)

[read-only] tickCount : int

该属性存储轴上的刻度线数量。这表示图表上绘制了多少条网格线。该值为只读。

访问函数：

int tickCount() const

通知信号：

void tickCountChanged(int tickCount)

成员函数文档

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

创建一个作为parent 子节点的轴对象。

[virtual noexcept] QLogValueAxis::~QLogValueAxis()

销毁该对象。

[signal] void QLogValueAxis::baseChanged(qreal base)

当坐标轴对数的base 发生变化时，会发出此信号。

注意： 这是属性base的通知 信号。

[signal] void QLogValueAxis::labelFormatChanged(const QString &format)

当坐标轴标签的format 发生变化时，将触发此信号。

注意： 这是属性labelFormat的通知器 信号。

[signal] void QLogValueAxis::maxChanged(qreal max)

当由max 指定的轴的最大值发生变化时，会触发此信号。

注意： 这是属性max 的Notifier 信号。

[signal] void QLogValueAxis::minChanged(qreal min)

当由min 指定的轴的最小值发生变化时，会触发此信号。

注意： 这是属性min的通知 信号。

[signal] void QLogValueAxis::minorTickCountChanged(int minorTickCount)

当轴上的小刻度数量（由minorTickCount 指定）发生变化时，会发出此信号。

注意： 这是属性minorTickCount的通知器 信号。

[signal] void QLogValueAxis::rangeChanged(qreal min, qreal max)

当由min 和max 指定的轴的最小值或最大值发生变化时，将触发此信号。

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

将坐标轴的范围设置为min 至max 。如果min 大于max ，则该函数不进行任何更改并直接返回。

[signal] void QLogValueAxis::tickCountChanged(int tickCount)

当由tickCount 指定的坐标轴刻度数发生变化时，将触发此信号。

注意： 这是属性 `tickCount`的通知器 信号。

[override virtual] QAbstractAxis::AxisType QLogValueAxis::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.