PySide6.QtGraphs.QValue3DAxisFormatter¶

class QValue3DAxisFormatter¶

QValue3DAxisFormatter 类是3D值轴格式化器的基类。更多…

继承自： QLogValue3DAxisFormatter

概要¶

方法¶

def __init__()
def allowNegatives()
def allowZero()
def axis()
def gridPositions()
def labelPositions()
def labelStrings()
def locale()
def markDirty()
def setAllowNegatives()
def setAllowZero()
def setAxis()
def setGridPoitions()
def setLabelStrings()
def setLocale()
def setSubGridPositions()
def setlabelPositions()
def subGridPositions()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

该类为线性值3D轴提供格式化规则。如果您想实现自定义值轴，请继承它。

基类除了构造函数和析构函数外没有公共API。它仅用于内部使用。然而，子类可以根据需要实现公共属性。

另请参阅

QValue3DAxis QLogValue3DAxisFormatter

__init__([parent=None])¶

Parameters:: 父对象 – QObject

使用可选的父级 parent 构造一个新的 3D 轴格式化器。

allowNegatives()¶

Return type:: 布尔

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

另请参阅

setAllowNegatives()

allowZero()¶

Return type:: 布尔

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

另请参阅

setAllowZero()

axis()¶

Return type:: QValue3DAxis

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

另请参阅

recalculate()

createNewInstance()¶

Return type:: QValue3DAxisFormatter

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

返回新的格式化程序。渲染器使用此方法来缓存格式化程序的副本。新副本的所有权转移给调用者。

gridPositions()¶

Return type:: 浮点数列表

返回对归一化网格线位置数组的引用。默认数组大小等于父轴的段数加一，但子类实现的recalculate()方法可能会以不同的方式调整数组大小。

另请参阅

segmentCount recalculate()

labelPositions()¶

Return type:: 浮点数列表

返回对标准化标签位置数组的引用。默认数组大小等于父轴的段数加一，但子类实现的recalculate()方法可能会以不同的方式调整数组大小。默认情况下，索引为零的标签对应于轴的最小值。

另请参阅

segmentCount labels recalculate()

labelStrings()¶

Return type:: 字符串列表

返回对包含格式化标签字符串的字符串列表的引用。

另请参阅

labelPositions()

locale()¶

Return type:: QLocale

返回此格式化程序当前使用的区域设置。

另请参阅

setLocale()

markDirty([labelsChange=false])¶

Parameters:: labelsChange – 布尔值

将此格式化程序标记为脏，提示渲染器在下次渲染器同步时生成其缓存的新副本。每当格式化程序以影响解析值的方式更改时，子类应调用此方法。如果更改需要重新生成父轴标签字符串，则将labelsChange设置为true。

populateCopy(copy)¶

Parameters:: 复制 – QValue3DAxisFormatter

将所有用于解析位置、值和字符串的必要值复制到格式化程序的copy中。在子类中重新实现此方法时，请在某些时候调用超类版本。渲染器使用此方法来缓存格式化程序的副本。

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

positionAt(value)¶

Parameters:: value – 浮点数
Return type:: 浮点数

返回给定value沿轴的归一化位置。如果该值在父轴范围内，则返回值应在0.0（最小值）和1.0（最大值）之间，包括这两个值。

如果位置无法通过父轴最小值和最大值之间的线性插值解析，请重新实现此方法。

另请参阅

recalculate() valueAt()

recalculate()¶

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

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

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

另请参阅

gridPositions() subGridPositions() labelPositions() labelStrings() axis()

setAllowNegatives(allow)¶

Parameters:: allow – 布尔值

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

另请参阅

allowNegatives()

setAllowZero(allow)¶

Parameters:: allow – 布尔值

如果allow为true，则允许父轴具有零值。

另请参阅

allowZero()

setAxis(axis)¶

Parameters:: axis – QValue3DAxis

setGridPoitions(gridPositions)¶

Parameters:: gridPositions – .浮点数列表

从gridPositions设置一组新的网格位置。值应在0.0（最小值）和1.0（最大值）之间，包括这两个值。

另请参阅

segmentCount recalculate() gridPositions

setLabelStrings(labelStrings)¶

Parameters:: labelStrings – 字符串列表

从labelStrings设置一个新的标签字符串列表。数组大小必须与标签位置数组的大小相等，索引也需对应。

另请参阅

labelPositions() labelStrings()

setLocale(locale)¶

Parameters:: locale – QLocale

设置此格式化程序使用的locale。每当父轴设置为图形的活动轴、轴格式化程序设置为附加到图形的轴或图形的区域设置更改时，图形会自动将格式化程序的区域设置设置为图形的区域设置。

另请参阅

locale() locale

setSubGridPositions(subGridPositions)¶

Parameters:: subGridPositions – .浮点数列表

从subGridPositions设置一组新的子网格位置。值应在0.0（最小值）和1.0（最大值）之间，包括这两个值。

另请参阅

segmentCount subSegmentCount recalculate() subGridPositions

setlabelPositions(labelPositions)¶

Parameters:: labelPositions – .浮点数列表

从labelPositions设置一组新的标签位置。值应在0.0（最小值）和1.0（最大值）之间，包括这两个值。

另请参阅

segmentCount labels recalculate() labelPositions()

stringForValue(value, format)¶

Parameters:

value – 浮点数
format – str

Return type:

字符串

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

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

另请参阅

recalculate() labelStrings() labelFormat

subGridPositions()¶

Return type:: 浮点数列表

返回对归一化子网格线位置数组的引用。默认数组大小等于父轴的段数乘以父轴的子段数减一，但recalculate()方法的子类实现可能会以不同的方式调整数组大小。

另请参阅

segmentCount subSegmentCount recalculate()

valueAt(position)¶

Parameters:: 位置 – 浮点数
Return type:: 浮点数

返回沿轴在归一化position处的值。position值应在0.0（最小值）和1.0（最大值）之间（包括这两个值），以获取父轴范围内的值。

如果无法通过父轴最小值和最大值之间的线性插值解析该值，请重新实现此方法。

另请参阅

recalculate() positionAt()