QValueAxis 类

The QValueAxis class adds values to a chart's axes. 更多...

头: #include <QValueAxis>
实例化: ValueAxis
继承: QAbstractAxis
继承者:

QCategoryAxis

公共类型

enum TickType { TicksDynamic, TicksFixed }

特性

公共函数

QValueAxis (QObject * parent = nullptr)
virtual ~QValueAxis ()
QString labelFormat () const
qreal max () const
qreal min () const
int minorTickCount () const
void setLabelFormat (const QString & format )
void setMax (qreal max )
void setMin (qreal min )
void setMinorTickCount (int count )
void setRange (qreal min , qreal max )
void setTickAnchor (qreal anchor )
void setTickCount (int count )
void setTickInterval (qreal insterval )
void setTickType (QValueAxis::TickType type )
qreal tickAnchor () const
int tickCount () const
qreal tickInterval () const
QValueAxis::TickType tickType () const

重实现公共函数

virtual QAbstractAxis::AxisType type () const override

公共槽

void applyNiceNumbers ()

信号

void labelFormatChanged (const QString & format )
void maxChanged (qreal max )
void minChanged (qreal min )
void minorTickCountChanged (int minorTickCount )
void rangeChanged (qreal min , qreal max )
void tickAnchorChanged (qreal anchor )
void tickCountChanged (int tickCount )
void tickIntervalChanged (qreal interval )
void tickTypeChanged (QValueAxis::TickType type )

详细描述

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

成员类型文档编制

enum QValueAxis:: TickType

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

常量 描述
QValueAxis::TicksDynamic 0 Ticks are placed according to tickAnchor and tickInterval 值。
QValueAxis::TicksFixed 1 Ticks are placed evenly across the axis range. The tickCount value specifies the number of ticks.

特性文档编制

labelFormat : QString

此特性保持轴的标签格式。

格式字符串支持的以下转换说明符、长度修饰符和标志的提供通过 printf() 在标准 C++ 库:d、i、o、x、X、f、F、e、E、g、G、c。

QChart::localizeNumbers is true ,支持的说明符限于:d、e、E、f、g、G 和 i。另外,仅支持精度修饰符。其余格式来自默认 QLocale 对于应用程序。

访问函数:

QString labelFormat () const
void setLabelFormat (const QString & format )

通知程序信号:

void labelFormatChanged (const QString & format )

另请参阅 QString::asprintf ().

max : qreal

此特性保持轴的最大值。

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

访问函数:

qreal max () const
void setMax (qreal max )

通知程序信号:

void maxChanged (qreal max )

min : qreal

此特性保持轴的最小值。

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

访问函数:

qreal min () const
void setMin (qreal min )

通知程序信号:

void minChanged (qreal min )

minorTickCount : int

此特性保持轴的次要刻度标记数。这指示在图表主要刻度之间要绘制多少栅格线。次要刻度不绘制标签。默认值为 0。

访问函数:

int minorTickCount () const
void setMinorTickCount (int count )

通知程序信号:

void minorTickCountChanged (int minorTickCount )

tickAnchor : qreal

此特性保持从哪里开始动态放置刻度标记和标签的值。

该特性在 Qt 5.12 引入。

访问函数:

qreal tickAnchor () const
void setTickAnchor (qreal anchor )

通知程序信号:

void tickAnchorChanged (qreal anchor )

tickCount : 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.

访问函数:

int tickCount () const
void setTickCount (int count )

通知程序信号:

void tickCountChanged (int tickCount )

tickInterval : qreal

此特性保持动态放置刻度标记和标签之间的间隔。

该特性在 Qt 5.12 引入。

访问函数:

qreal tickInterval () const
void setTickInterval (qreal insterval )

通知程序信号:

void tickIntervalChanged (qreal interval )

tickType : TickType

此特性保持刻度和标签的定位方法。

该特性在 Qt 5.12 引入。

访问函数:

QValueAxis::TickType tickType () const
void setTickType (QValueAxis::TickType type )

通知程序信号:

void tickTypeChanged (QValueAxis::TickType type )

成员函数文档编制

QValueAxis:: QValueAxis ( QObject * parent = nullptr)

Constructs an axis object that is a child of parent .

[slot] void QValueAxis:: applyNiceNumbers ()

修改轴的当前范围和刻度标记数,以使看起来 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.

另请参阅 setRange () 和 setTickCount ().

[signal] void QValueAxis:: labelFormatChanged (const QString & format )

此信号发射当 format 对于轴标签改变。

注意: 通知程序信号对于特性 labelFormat .

[signal] void QValueAxis:: maxChanged ( qreal max )

This signal is emitted when the maximum value of the axis, specified by max ,改变。

注意: 通知程序信号对于特性 max .

[signal] void QValueAxis:: minChanged ( qreal min )

This signal is emitted when the minimum value of the axis, specified by min ,改变。

注意: 通知程序信号对于特性 min .

[signal] void QValueAxis:: minorTickCountChanged ( int minorTickCount )

This signal is emitted when the number of minor tick marks on the axis, specified by minorTickCount ,改变。

注意: 通知程序信号对于特性 minorTickCount .

[signal] void QValueAxis:: rangeChanged ( qreal min , qreal max )

This signal is emitted when the minimum or maximum value of the axis, specified by min and max ,改变。

[signal] void QValueAxis:: tickCountChanged ( int tickCount )

This signal is emitted when the number of tick marks on the axis, specified by tickCount ,改变。

注意: 通知程序信号对于特性 tickCount .

[虚拟] QValueAxis:: ~QValueAxis ()

销毁对象。

void QValueAxis:: setRange ( qreal min , qreal max )

设置范围从 min to max 在轴。若 min 大于 max ,此函数返回不做任何改变。

[override virtual] QAbstractAxis::AxisType QValueAxis:: type () const

重实现: QAbstractAxis::type () const.

返回轴的类型。