QValue3DAxisFormatter Class

成员函数文档

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

使用可选的父parent 构建一个新的三维坐标轴格式值。

[virtual noexcept] QValue3DAxisFormatter::~QValue3DAxisFormatter()

删除 3D 轴格式化值。

[protected] bool QValue3DAxisFormatter::allowNegatives() const

如果父坐标轴的有效值为负值，则返回true 。默认实现总是返回true 。

另请参见 setAllowNegatives()。

[protected] bool QValue3DAxisFormatter::allowZero() const

如果 0 是父坐标轴的有效值，则返回true 。默认实现总是返回true 。

另请参见 setAllowZero()。

[protected] QValue3DAxis *QValue3DAxisFormatter::axis() const

返回父轴。父轴只能在recalculate() 方法中访问，以便在使用线程渲染器的环境中保持线程安全。

另请参见 recalculate()。

[virtual protected] QValue3DAxisFormatter *QValue3DAxisFormatter::createNewInstance() const

创建一个新的空值 3D 轴格式器。必须在子类中重新实现。

返回新的格式器。呈现器使用此方法缓存格式器的副本。新副本的所有权将转移给调用者。

[protected] QList<float> &QValue3DAxisFormatter::gridPositions() const

返回归一化网格线位置数组的引用。默认数组大小等于父轴的线段数加一，但recalculate() 方法的子类实现可能会以不同方式调整数组大小。数组值应介于0.0 （最小值）和1.0 （最大值）之间。

另请参见 QValue3DAxis::segmentCount 和recalculate()。

[protected] QList<float> &QValue3DAxisFormatter::labelPositions() const

返回归一化标签位置数组的引用。默认数组大小等于父轴的线段数加一，但recalculate() 方法的子类实现可能会以不同方式调整数组大小。数值应介于0.0 （最小值）和1.0 （最大值）之间。默认情况下，索引 0 处的标签对应于坐标轴的最小值。

另请参见 QValue3DAxis::segmentCount,QAbstract3DAxis::labels, 和recalculate()。

[protected] QStringList &QValue3DAxisFormatter::labelStrings() const

返回包含格式化标签字符串的字符串列表的引用。数组大小必须等于标签位置数组的大小，索引也对应于标签位置数组。

另请参见 labelPositions()。

[protected] QLocale QValue3DAxisFormatter::locale() const

返回格式化器当前使用的本地语言。

另请参阅 setLocale()。

[protected] void QValue3DAxisFormatter::markDirty(bool labelsChange = false)

将此格式器标记为 "脏"（dirty），提示呈现器在下一次呈现器同步时创建新的缓存副本。每当格式器的更改影响到解析值时，子类都应调用此方法。如果更改需要重新生成父轴标签字符串，请将labelsChange 设置为true 。

[virtual protected] void QValue3DAxisFormatter::populateCopy(QValue3DAxisFormatter &copy) const

将使用该格式器解析位置、值和字符串所需的所有值复制到格式器的copy 。在子类中重新实现此方法时，请在某处调用超类的版本。呈现器使用此方法缓存格式器的副本。

返回新副本。新副本的所有权将转移给调用者。

[virtual protected] float QValue3DAxisFormatter::positionAt(float value) const

为给定的value 返回沿坐标轴的归一化位置。如果该值在父坐标轴范围内，则返回值应介于0.0 （最小值）和1.0 （最大值）之间（含）。

如果无法通过父轴最小值和最大值之间的线性插值解决位置问题，则重新执行此方法。

另请参见 recalculate() 和valueAt()。

[virtual protected] void QValue3DAxisFormatter::recalculate()

调整标签和网格线位置数组以及标签字符串数组的大小并填充其内容，同时计算将值映射到其位置所需的任何值。父轴可以在此函数中访问。

如果默认数组内容不合适，必须在子类中重新实现该方法。

请参见gridPositions()、subGridPositions()、labelPositions() 和labelStrings() 方法，了解有关需要调整大小和填充的数组的文档。

另请参见 gridPositions()、subGridPositions()、labelPositions()、labelStrings() 和axis()。

[protected] void QValue3DAxisFormatter::setAllowNegatives(bool allow)

如果allow 是true ，则允许父轴具有负值。

另请参见 allowNegatives() 。

[protected] void QValue3DAxisFormatter::setAllowZero(bool allow)

如果allow 是true ，则允许父轴的值为零。

另请参见 allowZero() 。

[protected] void QValue3DAxisFormatter::setLocale(const QLocale &locale)

设置此格式器使用的locale 。当父坐标轴被设置为图形的活动坐标轴、坐标轴格式化器被设置为附加到图形的坐标轴或图形的区域设置发生变化时，图形会自动将格式化器的区域设置为图形的区域设置。

另请参阅 locale() 和QAbstract3DGraph::locale 。

[virtual protected] QString QValue3DAxisFormatter::stringForValue(qreal value, const QString &format) const

使用指定的value 和format 返回格式化的标签字符串。

如果为QValue3DAxis::labelFormat 属性指定的默认格式化规则不够充分，可在子类中重新实现此方法，以解析给定value 的格式化字符串。

另请参阅 recalculate()、labelStrings() 和QValue3DAxis::labelFormat 。

[protected] QList<float> &QValue3DAxisFormatter::subGridPositions() const

返回归一化子网格线位置数组的引用。默认的数组大小等于父轴的线段数乘以父轴的子线段数减去 1，但recalculate() 方法的子类实现可能会以不同方式调整数组大小。数值应介于0.0 （最小值）和1.0 （最大值）之间（含）。

另请参见 QValue3DAxis::segmentCount,QValue3DAxis::subSegmentCount, 和recalculate()。

[virtual protected] float QValue3DAxisFormatter::valueAt(float position) const

返回坐标轴归一化position 处的值。position 值应介于0.0 （最小值）和1.0 （最大值）之间，以获得父坐标轴范围内的值。

如果无法通过父坐标轴最小值和最大值之间的线性插值解决数值问题，请重新执行此方法。

另请参阅 recalculate() 和positionAt()。