ValueAxis QML Type
Adds values to a chart's axes. More...
Import Statement: | import QtCharts 2.7 |
Instantiates: | QValueAxis |
Inherits: |
Properties
- labelFormat : string
- max : real
- min : real
- minorTickCount : int
- tickAnchor : real
(since QtCharts 2.3)
- tickCount : int
- tickInterval : real
(since QtCharts 2.3)
- tickType : enumeration
(since QtCharts 2.3)
Signals
- rangeChanged(string min, string max)
Methods
Detailed Description
The ValueAxis type 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 ValueAxis type:
ChartView { ValueAxis { id: xAxis min: 0 max: 10 } // Add a few series... }
Property Documentation
labelFormat : string |
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 ChartView.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 QString::asprintf().
max : real |
The maximum value on the axis.
When setting this property, the minimum value is adjusted if necessary, to ensure that the range remains valid.
min : real |
The minimum value on the axis.
When setting this property, the maximum value is adjusted if necessary, to ensure that the range remains valid.
minorTickCount : int |
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.
tickAnchor : real |
The base value where the dynamically placed tick marks and labels are started from.
This property was introduced in QtCharts 2.3.
tickCount : int |
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.
tickInterval : real |
The interval between dynamically placed tick marks and labels.
This property was introduced in QtCharts 2.3.
tickType : enumeration |
The positioning method of tick and labels.
Constant | Description |
---|---|
ValueAxis.TicksDynamic | Ticks are placed according to tickAnchor and tickInterval values. |
ValueAxis.TicksFixed | Ticks are placed evenly across the axis range. The tickCount value specifies the number of ticks. |
This property was introduced in QtCharts 2.3.
Signal Documentation
This signal is emitted when min or max value of the axis changes.
The corresponding signal handler is onRangeChanged
.
Note: The corresponding handler is onRangeChanged
.
Method Documentation
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.