このページでは

Value3DAxis QML Type

グラフの軸を操作します。詳細...

Import Statement: import QtGraphs
In C++: QValue3DAxis
Inherits:

Abstract3DAxis

プロパティ

信号

詳細な説明

このタイプは、値の範囲と、その範囲を分割するためのセグメント数およびサブセグメント数を指定できる軸を提供します。

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

autoAdjustRange : bool

軸が、すべてのデータが収まるように範囲を自動的に調整するかどうかを指定します。

formatter : Value3DAxisFormatter

使用する軸フォーマッタ。新しいフォーマッタを設定すると、既存のフォーマッタはすべて削除されます。

labelAutoAngle : real

カメラの角度が変化した際に、ラベルが自動的に回転できる最大角度です。角度は0から90までの範囲(両端を含む)で指定できます。デフォルト値は0です。値が0の場合、軸ラベルは自動的に回転しません。値が0より大きい場合、ラベルは指定された角度の範囲内で、カメラの方向に向くように回転しようとします。

labelFormat : string

この軸のラベルに使用するラベル形式。

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

GraphsItem3D::locale が"C" 以外の場合、サポートされる指定子はd、e、E、f、g、G、およびiに制限されます。また、精度修飾子のみがサポートされます。その他の書式設定は、アプリケーションのデフォルトのLocale に基づきます。

GraphsItem3D::localeも参照してください 。

labelSize : real [since 6.9]

ラベルのサイズ。この値のデフォルトは `1.0` です。

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

「scaleLabelsByCount」も参照してください 。

labels : list

軸のラベル。

注: Value3DAxis に対してこのプロパティを設定しても 何も起こりません。 ではラベルが自動的に生成されるためです。

labelsVisible : bool

メインのグラフビューで軸ラベルを表示するかどうかを指定します。

デフォルト値はtrue です。

max : real

軸上の最大値。このプロパティを設定すると、範囲が有効な範囲内となるよう、必要に応じて最小値が調整されます。

min : real

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

orientation : Abstract3DAxis.AxisOrientation [read-only]

軸の向き。

reversed : bool

true の場合、軸は逆順で描画されます。つまり、グラフが描画される際に、最小値と最大値の位置が入れ替わります。このプロパティは、軸の実際の最小値および最大値には影響しません。

scaleLabelsByCount : bool [since 6.9]

ラベルの総数に応じて、ラベルのサイズが自動的に調整されるかどうか。

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

labelSizeも参照してください 。

segmentCount : qsizetype

軸上の区間の数。これは、描画されるラベルの数を示します。描画されるグリッド線の数は、次の式で計算されます:segments * subsegments + 1 。プリセットのデフォルト値は5 です。この値は1 を下回ってはなりません。

subSegmentCount : qsizetype

軸上の各セグメント内のサブセグメントの数です。各セグメントに加え、各サブセグメントの間にもグリッド線が描画されます。プリセットのデフォルト値は `1` です。この値は `1` 未満にすることはできません。

title : string

軸のタイトル。

titleVisible およびtitleFixedも参照してください 。

titleFixed : bool

軸タイトルの回転。

false の場合、プライマリグラフビューの軸タイトルは、軸ラベルと同様にカメラ方向に向けて回転されます。true の場合、軸タイトルは軸を中心に回転されるのみで、カメラ方向に向けて配置されることはありません。このプロパティは、labelAutoAngle プロパティの値が0の場合、何の効果も持ちません。デフォルト値はtrue です。

関連項目: labelAutoAngle 、title 、およびtitleVisible 。

titleOffset : real

軸上の軸タイトルの位置。値は-1.0f から1.0f

デフォルト値は0 です。

「 title 」および「titleVisible 」も参照してください 。

titleVisible : bool

メインのグラフビューで軸のタイトルを表示するかどうかを指定します。

デフォルト値は `false` です。

「 title 」および「titleFixed 」も参照してください 。

type : Abstract3DAxis.AxisType [read-only]

軸の型。

シグナルのドキュメント

autoAdjustRangeChanged(bool autoAdjust)

このシグナルは、autoAdjustRange プロパティの値がautoAdjust に変更されたときに発生します。

注: 対応するハンドラは `onAutoAdjustRangeChanged` です。

formatterChanged(Value3DAxisFormatter formatter)

このシグナルは、formatter がformatter に変更されたときに発生します。

注: 対応するハンドラは onFormatterChanged です。

labelAutoAngleChanged(real angle)

このシグナルは、ラベルの回転角度がangle に変化したときに発信されます。

注: 対応するハンドラは onLabelAutoAngleChanged です。

labelFormatChanged(string format)

このシグナルは、labelFormat がformat に変更されたときに発生します。

注: 対応するハンドラは onLabelFormatChanged です。

labelSizeChanged(real size)

このシグナルは、labelSize プロパティの値がsize に変更されたときに発火します。

注: 対応するハンドラは `onLabelSizeChanged` です。

labelVisibilityChanged(bool visible)

このシグナルは、ラベルの可視性が「visible 」に変化したときに発火します。

注: 対応するハンドラは `onLabelVisibilityChanged` です。

labelsChanged()

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

注: 対応するハンドラは onLabelsChanged です。

maxChanged(real value)

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

注: 対応するハンドラは onMaxChanged です。

minChanged(real value)

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

注: 対応するハンドラは onMinChanged です。

orientationChanged(AxisOrientation orientation)

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

注: 対応するハンドラは onOrientationChanged です。

rangeChanged(real min, real max)

このシグナルは、軸の範囲が変更されたときに発火します。min およびmax は、新しい範囲の最小値と最大値です。

注: 対応するハンドラは onRangeChanged です。

reversedChanged(bool enable)

このシグナルは、reversed がenable に変更されたときに発生します。

注: 対応するハンドラは onReversedChanged です。

scaleLabelsByCountChanged(bool adjust)

このシグナルは、scaleLabelsByCount プロパティの値がadjust に変更されたときに発生します。

注: 対応するハンドラは `onScaleLabelsByCountChanged` です。

segmentCountChanged(qsizetype count)

このシグナルは、segmentCount がcount に変更されたときに発生します。

注: 対応するハンドラは onSegmentCountChanged です。

subSegmentCountChanged(qsizetype count)

このシグナルは、subSegmentCount がcount に変更されたときに発生します。

注: 対応するハンドラは onSubSegmentCountChanged です。

titleChanged(string newTitle)

このシグナルは、title がnewTitle に変更されたときに発生します。

注: 対応するハンドラは onTitleChanged です。

titleFixedChanged(bool fixed)

このシグナルは、titleFixed プロパティの値がfixed に変更されたときに発生します。

注: 対応するハンドラは `onTitleFixedChanged` です。

titleOffsetChanged(real offset)

このシグナルは、titleOffset プロパティの値がoffset に変更されたときに発火します。

注: 対応するハンドラは `onTitleOffsetChanged` です。

titleVisibilityChanged(bool visible)

このシグナルは、タイトルの表示状態が「visible 」に変わったときに発火します。

注: 対応するハンドラは `onTitleVisibilityChanged` です。

© 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.