QValueAxis Class

QValueAxis クラスは、チャートの軸に値を追加します。詳細...

Header: #include <QValueAxis>
In QML: ValueAxis
Inherits: QAbstractAxis
Inherited By:

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

詳細説明

値軸は、目盛り、グリッド線、および陰影を持つ軸線を表示するように設定できます。軸上の値は目盛りの位置に描画されます。

以下のコード例は、QValueAxis クラスの使用方法を示しています:

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

この列挙型は、目盛りとラベルが軸上にどのように配置されるかを記述する。

定数説明
QValueAxis::TicksDynamic0目盛りは、tickAnchor およびtickInterval の値に従って配置される。
QValueAxis::TicksFixed1目盛りは、軸の範囲にわたって均等に配置されます。tickCount 値は目盛りの数を指定する。

プロパティの説明

labelFormat : QString

このプロパティは、軸のラベル形式を保持する。

フォーマット文字列は、標準 C++ ライブラリのprintf() で提供されている以下の変換指定子、長さ修飾子、およびフラグをサポートしています: d、i、o、x、X、f、F、e、E、g、G、c。

QChart::localizeNumberstrue の場合、サポートされる指定子は 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

このプロパティは、軸の最大値を保持する。

このプロパティを設定するときは、範囲が有効であることを保証するために、必要に応じて最小値が調整される。

アクセス関数

qreal max() const
void setMax(qreal max)

ノーティファイア信号:

void maxChanged(qreal max)

min : qreal

このプロパティは、軸の最小値を保持する。

このプロパティを設定すると、必要に応じて最大値が調整され、範囲が有効であることを保証する。

アクセス関数

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

このプロパティは、動的に配置される目盛りとラベルが開始される基準値を保持します。

アクセス関数

qreal tickAnchor() const
void setTickAnchor(qreal anchor)

通知シグナル

void tickAnchorChanged(qreal anchor)

tickCount : int

このプロパティは、軸上の目盛りの数を保持する。これはチャートに何本のグリッド線が引かれるかを示す。デフォルト値は5で、2より少なくすることはできません。

アクセス関数:

int tickCount() const
void setTickCount(int count)

通知シグナル:

void tickCountChanged(int tickCount)

tickInterval : qreal

このプロパティは、動的に配置される目盛りマークとラベルの間隔を保持する。

アクセス関数

qreal tickInterval() const
void setTickInterval(qreal insterval)

通知シグナル

void tickIntervalChanged(qreal interval)

tickType : TickType

このプロパティは、目盛りとラベルの位置決め方法を保持する。

アクセス関数

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

通知シグナル

void tickTypeChanged(QValueAxis::TickType type)

メンバ関数ドキュメント

[explicit] QValueAxis::QValueAxis(QObject *parent = nullptr)

parent の子である軸オブジェクトを構築する。

[virtual noexcept] QValueAxis::~QValueAxis()

オブジェクトを破壊する。

[slot] void QValueAxis::applyNiceNumbers()

現在の範囲と軸上の目盛りの数を見栄えが良くなるように変更する。このアルゴリズムでは、1*10^n、2*10^n、または5*10^nの形式で表現できる数値を見栄えの良い数値と見なします。これらの数値は、目盛りの間隔を設定するために使用されます。

setRange() およびsetTickCount()も参照の こと。

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

このシグナルは、軸ラベルのformat が変更されたときに発行される。

注: プロパティlabelFormat の通知シグナル。

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

このシグナルは、max で指定された軸の最大値が変更されたときに発行される。

注: max プロパティのノーティファイアシグナル。

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

このシグナルは、min で指定された軸の最小値が変更されたときに発行される。

注: min プロパティのノーティファイアシグナル。

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

このシグナルは、minorTickCount で指定された軸の小目盛りの数が変更されたときに発行される。

注: プロパティminorTickCount に対するノーティファイア・シグナル。

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

このシグナルは、minmax で指定される軸の最小値または最大値が変化したときに発せられる。

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

軸のmin からmax までの範囲を設定する。minmax より大きい場合、この関数は何も変更せずに戻る。

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

このシグナルは、tickCount で指定された軸の目盛りの数が変更されたときに発行される。

注: プロパティtickCount に対するノーティファイア・シグナル。

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

再実装:QAbstractAxis::type() const.

軸の型を返します。

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.