QValueAxis Class
QValueAxis クラスは、チャートの軸に値を追加します。詳細...
| Header: | #include <QValueAxis> |
| In QML: | ValueAxis |
| Inherits: | QAbstractAxis |
| Inherited By: | |
| Status: | Deprecated |
このクラスは非推奨です。新しいコードでの使用は強くお勧めしません。
パブリック型
| 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) |
詳細な説明
値軸は、目盛り、グリッド線、および陰影付きの軸線を表示するように設定できます。軸上の値は、目盛りの位置に描画されます。
以下のサンプルコードは、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::TicksDynamic | 0 | 目盛は、tickAnchor およびtickInterval の値に従って配置されます。 |
QValueAxis::TicksFixed | 1 | 目盛は、軸の範囲全体に均等に配置されます。tickCount の値は、目盛の数を指定します。 |
プロパティのドキュメント
labelFormat : QString
このプロパティは、軸のラベル形式を保持します。
このフォーマット文字列は、標準C++ライブラリのprintf() で提供される以下の変換指定子、長さ修飾子、およびフラグをサポートしています：d、i、o、x、X、f、F、e、E、g、G、c。
QChart::localizeNumbers が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
このプロパティは、軸上の最大値を保持します。
このプロパティを設定する際、範囲が有効な状態を維持できるよう、必要に応じて最小値が調整されます。
アクセス関数：
| 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)
このシグナルは、min およびmax で指定された軸の最小値または最大値が変化したときに発生します。
void QValueAxis::setRange(qreal min, qreal max)
軸上の範囲をmin からmax に設定します。min がmax より大きい場合、この関数は変更を行わずに終了します。
[signal] void QValueAxis::tickCountChanged(int tickCount)
このシグナルは、tickCount で指定された軸上の目盛りの数が変更されたときに発生します。
注： プロパティ `tickCount` に対する通知 シグナルです。
[override virtual] QAbstractAxis::AxisType QValueAxis::type() const
再実装：QAbstractAxis::type() const。
軸の型を返します。
© 2026 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.
