PySide6.QtGraphs.QValue3DAxis¶

class QValue3DAxis¶

The QValue3DAxis class manipulates an axis of a graph.

Details

A value axis can be given a range of values and segment and subsegment counts to divide the range into.

Labels are drawn between each segment, and grid lines are drawn between each segment and each subsegment.

Note

If visible, there will always be at least two grid lines and labels indicating the minimum and maximum values of the range, as there is always at least one segment.

Synopsis¶

Properties¶

formatterᅟ - Axis formatter to be used
labelFormatᅟ - Label format to be used for the labels on this axis
reversedᅟ - Whether the axis is rendered in reverse
segmentCountᅟ - Number of segments on the axis
subSegmentCountᅟ - Number of subsegments inside each segment on the axis

Methods¶

def __init__()
def formatter()
def gridPositionAt()
def gridSize()
def labelFormat()
def labelPositionAt()
def positionAt()
def recalculate()
def reversed()
def segmentCount()
def setFormatter()
def setLabelFormat()
def setReversed()
def setSegmentCount()
def setSubSegmentCount()
def stringForValue()
def subGridPositionAt()
def subGridSize()
def subSegmentCount()

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property formatterᅟ: QValue3DAxisFormatter¶

This property holds The axis formatter to be used..

Any existing formatter is deleted when a new formatter is set.

Access functions:

formatter()
setFormatter()
Signal formatterChanged()

property labelFormatᅟ: str¶

This property holds The label format to be used for the labels on this axis..

The format string supports the following conversion specifiers, length modifiers, and flags provided by printf() in the standard C++ library: d, i, o, x, X, f, F, e, E, g, G, c.

If locale is anything else than "C", the supported specifiers are limited to: d, e, E, f, g, G, and i. Also, only the precision modifier is supported. The rest of the formatting comes from the default QLocale of the application.

Usage example:

axis->setLabelFormat("%.2f mm");

See also

formatter locale

Access functions:

labelFormat()
setLabelFormat()
Signal labelFormatChanged()

property reversedᅟ: bool¶

This property holds Whether the axis is rendered in reverse..

If true, the axis will be rendered in reverse, which means the positions of minimum and maximum values are swapped when the graph is rendered. This property doesn’t affect the actual minimum and maximum values of the axis.

Access functions:

reversed()
setReversed()
Signal reversedChanged()

property segmentCountᅟ: int¶

This property holds The number of segments on the axis..

This indicates how many labels are drawn. The number of grid lines to be drawn is calculated with formula: segments * subsegments + 1. The preset default is 5. The value cannot be below 1.

See also

setSubSegmentCount()

Access functions:

segmentCount()
setSegmentCount()
Signal segmentCountChanged()

property subSegmentCountᅟ: int¶

This property holds The number of subsegments inside each segment on the axis..

Grid lines are drawn between each subsegment, in addition to each segment. The preset default is 1. The value cannot be below 1.

See also

setSegmentCount()

Access functions:

subSegmentCount()
setSubSegmentCount()
Signal subSegmentCountChanged()

__init__([parent=None])¶

Parameters:: parent – QObject

Constructs QValue3DAxis with the given parent.

formatter()¶

Return type:: QValue3DAxisFormatter

See also

setFormatter()

Getter of property formatterᅟ .

formatterChanged(formatter)¶

Parameters:: formatter – QValue3DAxisFormatter

Notification signal of property formatterᅟ .

formatterDirty()¶

gridPositionAt(gridLine)¶

Parameters:: gridLine – int
Return type:: float

gridSize()¶

Return type:: int

labelFormat()¶

Return type:: str

See also

setLabelFormat()

Getter of property labelFormatᅟ .

labelFormatChanged(format)¶

Parameters:: format – str

Notification signal of property labelFormatᅟ .

labelPositionAt(index)¶

Parameters:: index – int
Return type:: float

positionAt(x)¶

Parameters:: x – float
Return type:: float

recalculate()¶

reversed()¶

Return type:: bool

See also

setReversed()

Getter of property reversedᅟ .

reversedChanged(enable)¶

Parameters:: enable – bool

Notification signal of property reversedᅟ .

segmentCount()¶

Return type:: int

See also

setSegmentCount()

Getter of property segmentCountᅟ .

segmentCountChanged(count)¶

Parameters:: count – int

Notification signal of property segmentCountᅟ .

setFormatter(formatter)¶

Parameters:: formatter – QValue3DAxisFormatter

See also

formatter()

Setter of property formatterᅟ .

setLabelFormat(format)¶

Parameters:: format – str

See also

labelFormat()

Setter of property labelFormatᅟ .

setReversed(enable)¶

Parameters:: enable – bool

See also

reversed()

Setter of property reversedᅟ .

setSegmentCount(count)¶

Parameters:: count – int

See also

segmentCount()

Setter of property segmentCountᅟ .

setSubSegmentCount(count)¶

Parameters:: count – int

See also

subSegmentCount()

Setter of property subSegmentCountᅟ .

stringForValue(x)¶

Parameters:: x – float
Return type:: str

subGridPositionAt(gridLine)¶

Parameters:: gridLine – int
Return type:: float

subGridSize()¶

Return type:: int

subSegmentCount()¶

Return type:: int

See also

setSubSegmentCount()

Getter of property subSegmentCountᅟ .

subSegmentCountChanged(count)¶

Parameters:: count – int

Notification signal of property subSegmentCountᅟ .