QValueAxis

The QValueAxis class adds values to a chart’s axes. More…

Inherited by: QCategoryAxis

Synopsis

Functions

• def labelFormat ()

• def max ()

• def min ()

• def minorTickCount ()

• def setLabelFormat (format)

• def setMax (max)

• def setMin (min)

• def setMinorTickCount (count)

• def setRange (min, max)

• def setTickAnchor (anchor)

• def setTickCount (count)

• def setTickInterval (insterval)

• def setTickType (type)

• def tickAnchor ()

• def tickCount ()

• def tickInterval ()

• def tickType ()

Slots

• def applyNiceNumbers ()

Signals

• def labelFormatChanged (format)

• def maxChanged (max)

• def minChanged (min)

• def minorTickCountChanged (tickCount)

• def rangeChanged (min, max)

• def tickAnchorChanged (anchor)

• def tickCountChanged (tickCount)

• def tickIntervalChanged (interval)

• def tickTypeChanged (type)

Detailed Description

A value axis can be set up to show an axis line with tick marks, grid lines, and shades. The values on the axis are drawn at the positions of tick marks.

The following example code illustrates how to use the QValueAxis class:

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);

class PySide6.QtCharts.QValueAxis([parent=None])

Parameters

parent – PySide6.QtCore.QObject

Constructs an axis object that is a child of parent.

PySide6.QtCharts.QValueAxis.TickType

This enum describes how the ticks and labels are positioned on the axis.

Constant	Description
QValueAxis.TicksDynamic	Ticks are placed according to tickAnchor and tickInterval values.
QValueAxis.TicksFixed	Ticks are placed evenly across the axis range. The tickCount value specifies the number of ticks.

PySide6.QtCharts.QValueAxis.applyNiceNumbers()

Modifies the current range and number of tick marks on the axis to look nice. The algorithm considers numbers that can be expressed as a form of 1*10^n, 2* 10^n, or 5*10^n to be nice numbers. These numbers are used for setting spacing for the tick marks.

See also

setRange() setTickCount()

PySide6.QtCharts.QValueAxis.labelFormat()

Return type

str

This property holds The label format of the 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 localizeNumbers is true, 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.

See also

asprintf()

PySide6.QtCharts.QValueAxis.labelFormatChanged(format)

Parameters

format – str

PySide6.QtCharts.QValueAxis.max()

Return type

float

This property holds The maximum value on the axis..

When setting this property, the minimum value is adjusted if necessary, to ensure that the range remains valid.

PySide6.QtCharts.QValueAxis.maxChanged(max)

Parameters

max – float

PySide6.QtCharts.QValueAxis.min()

Return type

float

This property holds The minimum value on the axis..

When setting this property, the maximum value is adjusted if necessary, to ensure that the range remains valid.

PySide6.QtCharts.QValueAxis.minChanged(min)

Parameters

min – float

PySide6.QtCharts.QValueAxis.minorTickCount()

Return type

int

This property holds The number of minor tick marks on the axis. This indicates how many grid lines are drawn between major ticks on the chart. Labels are not drawn for minor ticks. The default value is 0..

PySide6.QtCharts.QValueAxis.minorTickCountChanged(tickCount)

Parameters

tickCount – int

PySide6.QtCharts.QValueAxis.rangeChanged(min, max)

Parameters

• min – float

• max – float

PySide6.QtCharts.QValueAxis.setLabelFormat(format)

Parameters

format – str

This property holds The label format of the 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 localizeNumbers is true, 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.

See also

asprintf()

PySide6.QtCharts.QValueAxis.setMax(max)

Parameters

max – float

This property holds The maximum value on the axis..

When setting this property, the minimum value is adjusted if necessary, to ensure that the range remains valid.

PySide6.QtCharts.QValueAxis.setMin(min)

Parameters

min – float

This property holds The minimum value on the axis..

When setting this property, the maximum value is adjusted if necessary, to ensure that the range remains valid.

PySide6.QtCharts.QValueAxis.setMinorTickCount(count)

Parameters

count – int

This property holds The number of minor tick marks on the axis. This indicates how many grid lines are drawn between major ticks on the chart. Labels are not drawn for minor ticks. The default value is 0..

PySide6.QtCharts.QValueAxis.setRange(min, max)

Parameters

• min – float

• max – float

Sets the range from min to max on the axis. If min is greater than max, this function returns without making any changes.

PySide6.QtCharts.QValueAxis.setTickAnchor(anchor)

Parameters

anchor – float

This property holds The base value where the dynamically placed tick marks and labels are started from..

PySide6.QtCharts.QValueAxis.setTickCount(count)

Parameters

count – int

This property holds The number of tick marks on the axis. This indicates how many grid lines are drawn on the chart. The default value is 5, and the number cannot be less than 2..

PySide6.QtCharts.QValueAxis.setTickInterval(insterval)

Parameters

insterval – float

This property holds The interval between dynamically placed tick marks and labels..

PySide6.QtCharts.QValueAxis.setTickType(type)

Parameters

type – TickType

This property holds The positioning method of tick and labels..

PySide6.QtCharts.QValueAxis.tickAnchor()

Return type

float

This property holds The base value where the dynamically placed tick marks and labels are started from..

PySide6.QtCharts.QValueAxis.tickAnchorChanged(anchor)

Parameters

anchor – float

PySide6.QtCharts.QValueAxis.tickCount()

Return type

int

This property holds The number of tick marks on the axis. This indicates how many grid lines are drawn on the chart. The default value is 5, and the number cannot be less than 2..

PySide6.QtCharts.QValueAxis.tickCountChanged(tickCount)

Parameters

tickCount – int

PySide6.QtCharts.QValueAxis.tickInterval()

Return type

float

This property holds The interval between dynamically placed tick marks and labels..

PySide6.QtCharts.QValueAxis.tickIntervalChanged(interval)

Parameters

interval – float

PySide6.QtCharts.QValueAxis.tickType()

Return type

TickType

This property holds The positioning method of tick and labels..

PySide6.QtCharts.QValueAxis.tickTypeChanged(type)

Parameters

type – TickType