QValueAxis Class
QValueAxis クラスは、グラフの軸に値を追加します。詳細...
| ヘッダー: | #include <QValueAxis> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| QML内: | ValueAxis |
| 継承元: | QAbstractAxis |
- 継承されたメンバーを含むすべてのメンバーの一覧
- QValueAxisは、Qt Graphs の2D用C++クラスの一部です。
プロパティ
|
|
パブリック関数
| QValueAxis(QObject *parent = nullptr) | |
| virtual | ~QValueAxis() override |
| int | labelDecimals() const |
| QString | labelFormat() const |
| QString | labelPostFormat() const |
| qreal | max() const |
| qreal | min() const |
| qreal | pan() const |
| void | setLabelDecimals(int decimals) |
| void | setLabelFormat(const QString &format) |
| void | setLabelPostFormat(const QString &format) |
| void | setMax(qreal max) |
| void | setMin(qreal min) |
| void | setPan(qreal pan) |
| void | setRange(qreal min, qreal max) |
| void | setSubTickCount(qsizetype count) |
| void | setTickAnchor(qreal anchor) |
| void | setTickInterval(qreal interval) |
| void | setZoom(qreal zoom) |
| qsizetype | subTickCount() const |
| qreal | tickAnchor() const |
| qreal | tickInterval() const |
| qreal | visualMax() const |
| qreal | visualMin() const |
| qreal | zoom() const |
再実装されたパブリック関数
| virtual QAbstractAxis::AxisType | type() const override |
シグナル
| void | labelDecimalsChanged(int decimals) |
| void | labelFormatChanged(const QString &format) |
| void | labelPostFormatChanged(const QString &format) |
| void | maxChanged(qreal max) |
| void | minChanged(qreal min) |
| void | panChanged(qreal pan) |
| void | subTickCountChanged(qsizetype subTickCount) |
| void | tickAnchorChanged(qreal tickAnchor) |
| void | tickIntervalChanged(qreal tickInterval) |
| void | visualMaxChanged(qreal newVisualMax) |
| void | visualMinChanged(qreal newVisualMin) |
| void | zoomChanged(qreal zoom) |
プロパティのドキュメント
labelDecimals : int
このプロパティは、ラベルの表示に使用する小数点以下の桁数を指定します。-1 に設定すると、値の範囲に応じて小数点以下の桁数が自動的に調整されます。デフォルト値は -1 です。
アクセス関数：
| int | labelDecimals() const |
| void | setLabelDecimals(int decimals) |
通知シグナル：
| void | labelDecimalsChanged(int decimals) |
labelFormat : QString
このプロパティは、軸のラベル形式を保持します。
フォーマット文字列は、標準 C++ ライブラリの `printf() ` で提供される以下の変換指定子、長さ修飾子、およびフラグをサポートしています：d、i、o、x、X、f、F、e、E、g、G、c。その後、フォーマットされた文字列は `QValueAxis::labelPostFormat` を通過します。
デフォルト値は空であり、その場合は「f」フォーマットが使用されます。
アクセス関数：
| QString | labelFormat() const |
| void | setLabelFormat(const QString &format) |
通知シグナル:
| void | labelFormatChanged(const QString &format) |
QString::asprintf()も参照してください 。
[since 6.12] labelPostFormat : QString
このプロパティは、軸のラベルの投稿フォーマットを保持します。
ラベルはまずQValueAxis::labelFormat を経由して値の書式設定が行われ、その後このプロパティが適用されます。
デフォルト値は「%1」です。
この列挙型は Qt 6.12 で導入されました。
アクセス関数:
| QString | labelPostFormat() const |
| void | setLabelPostFormat(const QString &format) |
通知シグナル：
| void | labelPostFormatChanged(const QString &format) |
QString::arg()も参照してください 。
max : qreal
このプロパティは、軸上の最大値を保持します。
このプロパティを設定すると、範囲が有効な範囲内にとどまるよう、必要に応じて最小値が調整されます。デフォルト値は 10.0 です。
アクセス関数：
| qreal | max() const |
| void | setMax(qreal max) |
通知信号：
| void | maxChanged(qreal max) |
min : qreal
このプロパティは、軸上の最小値を保持します。
このプロパティを設定すると、範囲が有効な状態を維持できるよう、必要に応じて最大値が調整されます。デフォルト値は 0.0 です。
アクセス関数：
| qreal | min() const |
| void | setMin(qreal min) |
通知信号：
| void | minChanged(qreal min) |
[since 6.9] pan : qreal
このプロパティは、軸のパン値を保持します。
パン値は、グリッドやラベルの間隔に影響を与えることなく、軸の中心を移動させます。デフォルト値は 0 です。
この列挙型は Qt 6.9 で導入されました。
アクセス関数:
| qreal | pan() const |
| void | setPan(qreal pan) |
Notifierシグナル:
| void | panChanged(qreal pan) |
subTickCount : qsizetype
このプロパティは、軸上のサブ目盛りの数を保持します。これは、グラフ上の主要な目盛りの間に何個のサブ目盛りが描画されるかを示します。サブ目盛りにはラベルは描画されません。デフォルト値は 0 です。
アクセス関数：
| qsizetype | subTickCount() const |
| void | setSubTickCount(qsizetype count) |
通知シグナル：
| void | subTickCountChanged(qsizetype subTickCount) |
tickAnchor : qreal
このプロパティは、動的に配置される目盛りやラベルの起点となる基準値を保持します。デフォルト値は 0 です。
アクセス関数：
| qreal | tickAnchor() const |
| void | setTickAnchor(qreal anchor) |
通知シグナル:
| void | tickAnchorChanged(qreal tickAnchor) |
tickInterval : qreal
このプロパティは、動的に配置される目盛りとラベルの間隔を指定します。デフォルト値は 0 で、これは最小値と最大値の範囲に基づいて間隔が自動的に計算されることを意味します。
アクセス関数：
| qreal | tickInterval() const |
| void | setTickInterval(qreal interval) |
通知シグナル：
| void | tickIntervalChanged(qreal tickInterval) |
[read-only, since 6.11] visualMax : qreal
このプロパティは、軸の視覚的な最大値を保持します。
このプロパティは、軸がパンまたはズームされた際の視覚的な最大軸値を保持します。デフォルト値はQValueAxis::max
この列挙型は Qt 6.11 で導入されました。
アクセス関数:
| qreal | visualMax() const |
Notifier シグナル:
| void | visualMaxChanged(qreal newVisualMax) |
[read-only, since 6.11] visualMin : qreal
このプロパティは、軸の視覚的な最小値を保持します。
このプロパティは、軸がパンまたはズームされた際の視覚的な最小軸値を保持します。デフォルト値はQValueAxis::min
この列挙型は Qt 6.11 で導入されました。
アクセス関数:
| qreal | visualMin() const |
Notifier シグナル:
| void | visualMinChanged(qreal newVisualMin) |
[since 6.9] zoom : qreal
このプロパティは、軸のズーム値を保持します。
ズーム値は、グリッドの間隔やラベルに影響を与えることなく、軸、ひいてはグラフを拡大または縮小します。デフォルト値は 1 です。
この列挙型は Qt 6.9 で導入されました。
アクセス関数:
| qreal | zoom() const |
| void | setZoom(qreal zoom) |
通知シグナル:
| void | zoomChanged(qreal zoom) |
メンバ関数のドキュメント
[explicit] QValueAxis::QValueAxis(QObject *parent = nullptr)
parent の子となる軸オブジェクトを作成します。
[override virtual noexcept] QValueAxis::~QValueAxis()
そのオブジェクトを破棄します。
void QValueAxis::setRange(qreal min, qreal max)
軸上の範囲をmin からmax に設定します。min がmax より大きい場合、この関数は何も変更せずに処理を終了します。
[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.
