ValueAxis QML Type

グラフの軸に値を追加します。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧
• ValueAxisは、Qt Graphs の2D用QMLタイプの一部です。

プロパティ

• labelDecimals : int
• labelFormat : string
• labelPostFormat : string (since 6.12)
• max : real
• min : real
• pan : real (since 6.9)
• subTickCount : int
• tickAnchor : real
• tickInterval : real
• visualMax : real (since 6.11)
• visualMin : real (since 6.11)
• zoom : real (since 6.9)

信号

• labelDecimalsChanged(int decimals)
• labelFormatChanged(string format)
• labelPostFormatChanged(string format) (since 6.12)
• maxChanged(real max)
• minChanged(real min)
• rangeChanged(real min, real max)
• subTickCountChanged(int subTickCount)
• tickAnchorChanged(real tickAnchor)
• tickIntervalChanged(real tickInterval)

詳細説明

ValueAxis 型は、目盛り、グリッド線、およびシェーディングを含む軸線を表示するように設定できます。軸上の値は、目盛りの位置に描画されます。

以下のサンプルコードは、ValueAxis 型の使用方法を示しています：

GraphsView {
    axisX: ValueAxis {
        max: 10
        tickInterval: 1
    }
    axisY: ValueAxis {
        min -20
        max: 40
    }
    LineSeries {
        // Add a few XYPoint data...
    }
}

プロパティのドキュメント

labelDecimals : int

ラベルの表示に使用する小数点以下の桁数。-1に設定すると、値の範囲に基づいて小数点以下の桁数が自動的に調整されます。デフォルト値は-1です。

labelFormat : string

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

デフォルト値は空であり、その場合は「f」フォーマットが使用されます。

ValueAxis {
    titleText: "Temperature °C"
    labelFormat: "%.2f"
    labelPostFormat: "%1 °C"
    // Results in "2.50 °C"
}

QString::asprintf()も参照してください 。

labelPostFormat : string [since 6.12]

ラベルはまずValueAxis::labelFormat を経て値の書式設定が行われ、その後、こちらを経由します。

デフォルト値は「%1」です。

ValueAxis {
    titleText: "Temperature °C"
    labelFormat: "%.2f"
    labelPostFormat: "%1 °C"
    // Results in "2.50 °C"
}

このプロパティは Qt 6.12 で導入されました。

QString::arg()も参照してください 。

max : real

軸上の最大値。

このプロパティを設定すると、範囲が有効な状態を維持できるよう、必要に応じて最小値が調整されます。デフォルト値は 10.0 です。

min : real

軸上の最小値。

このプロパティを設定すると、範囲が有効な状態を維持できるよう、必要に応じて最大値が調整されます。デフォルト値は 0.0 です。

pan : real [since 6.9]

軸のパン値。

パン値は、グリッドやラベルの間隔に影響を与えることなく、軸の中心を移動させます。デフォルト値は 0 です。

このプロパティは Qt 6.9 で導入されました。

subTickCount : int

軸上のサブ目盛りの数。これは、グラフ上の主要な線の間には何個のサブ目盛りが描画されるかを示します。サブ目盛りにはラベルは表示されません。デフォルト値は 0 です。

tickAnchor : real

動的に配置される目盛線やラベルの開始点となる基準値です。デフォルト値は 0 です。

tickInterval : real

動的に配置される目盛りとラベルの間隔。デフォルト値は 0 で、これは最小値と最大値の範囲に基づいて間隔が自動的に計算されることを意味します。

visualMax : real [read-only, since 6.11]

軸の視覚的な最大値。

このプロパティは、軸がパンまたはズームされた際の視覚的な最大軸値を保持します。デフォルト値はmax

このプロパティはQt 6.11で導入されました。

visualMin : real [read-only, since 6.11]

軸の視覚的な最小値。

このプロパティは、軸がパンまたはズームされた際に、軸の視覚的な最小値を保持します。デフォルト値はmin

このプロパティは Qt 6.11 で導入されました。

zoom : real [since 6.9]

軸のズーム値。

このズーム値は、グリッドの間隔やラベルに影響を与えることなく、軸およびグラフを拡大または縮小します。デフォルト値は 1 です。

このプロパティは Qt 6.9 で導入されました。

シグナルのドキュメント

labelDecimalsChanged(int decimals)

このシグナルは、軸ラベルの小数点以下の桁数がdecimals に変更されたときに発信されます。

labelFormatChanged(string format)

このシグナルは、軸ラベルの形式が「format 」に変更されたときに発せられます。

[since 6.12] labelPostFormatChanged(string format)

このシグナルは、軸ラベルの投稿形式が「format 」に変更されたときに発火します。

このシグナルは Qt 6.12 で導入されました。

maxChanged(real max)

このシグナルは、軸の最大値がmax に変更されたときに発せられます。

minChanged(real min)

このシグナルは、軸の最小値がmin に変更されたときに発信されます。

rangeChanged(real min, real max)

このシグナルは、軸の最小値または最大値が、それぞれmin およびmax に変更されたときに発せられます。

subTickCountChanged(int subTickCount)

このシグナルは、subTickCount で指定された軸のサブティック数が変更されたときに発生します。

tickAnchorChanged(real tickAnchor)

このシグナルは、ティックアンカー値がtickAnchor に変更された際に発せられます。

tickIntervalChanged(real tickInterval)

このシグナルは、ティック間隔の値がtickInterval に変更されたときに発信されます。