Q3DGraphsWidgetItem Class

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

activeTheme : QGraphsTheme*

このプロパティは、グラフのアクティブなテーマを保持します。

activeTheme を、グラフで使用されるアクティブなテーマとして設定します。暗黙的にaddTheme() を呼び出し、テーマの所有権をこのグラフに移譲します。

activeTheme が null の場合、一時的なデフォルトのテーマが作成されます。この一時的なテーマは、後で何らかのテーマが明示的に設定されると破棄されます。テーマのプロパティは設定後も変更可能であり、変更は即座に反映されます。

アクセス関数：

Notifierシグナル：

ambientLightStrength : float

このプロパティは、グラフ全体の周囲光の強度を指定します。

この値によって、光の位置に関係なく、グラフ全体で色がどれほど均一かつ明るく表示されるかが決まります。

値は、0.0f から1.0f の範囲で指定する必要があります。

アクセス関数：

通知シグナル：

aspectRatio : qreal

このプロパティは、水平面上の最長軸とy軸との間のグラフの拡大縮小比率を保持します。

デフォルト値は2.0 です。

アクセス関数：

通知シグナル:

関連項目： horizontalAspectRatio 。

cameraPreset : QtGraphs3D::CameraPreset

カメラが現在使用しているプリセットのカメラ位置です。この値は、CameraPreset 列挙型の値のいずれかに設定できます。このプロパティを使用すると、グラフを表示するカメラアングルをあらかじめ定義されたものから設定できます。

デフォルトでは、カメラプリセットはCameraPreset::FrontLow に設定されています。

アクセス関数：

Notifierシグナル：

cameraTargetPosition : QVector3D

このプロパティは、3D空間におけるカメラのターゲット位置をベクトルまたは頂点として保持します。

デフォルト値はQVector3D(0.0, 0.0, 0.0) です。

有効な座標値は-1.0...1.0 の範囲内であり、範囲の両端の値は、それぞれの軸の範囲の端を示します。この範囲外の値は、範囲の端にクリップされます。

アクセス関数:

通知シグナル：

cameraXRotation : float

このプロパティには、ターゲットポイントを中心としたカメラのX軸周りの回転角度（度単位）が格納されます。

アクセス関数：

通知シグナル:

cameraYRotation : float

このプロパティは、ターゲット点を軸としたカメラのY軸回転角度（度単位）を保持します。

アクセス関数：

通知シグナル：

cameraZoomLevel : float

このプロパティは、カメラのズームレベルをパーセンテージで保持します。

100.0f のデフォルト値は、カメラにズームインやズームアウトの設定がないことを意味します。この値は、minCameraZoomLevel およびmaxCameraZoomLevel プロパティによって制限されます。

アクセス関数：

通知シグナル:

関連項目: ` minCameraZoomLevel ` および `maxCameraZoomLevel`。

[read-only] currentFps : int

このプロパティには、直近1秒間のレンダリング結果が格納されます。

FPS測定が有効になっている場合、結果はこの読み取り専用プロパティに保存されます。測定が有効になってから、この値が更新されるまでには少なくとも1秒かかります。

アクセス関数：

通知シグナル:

measureFpsも参照してください 。

[since 6.11] cutoffMargin : qreal

このプロパティには、軸の限界値とグラフ要素が切り捨てられる位置との間の間隔として使用される値が格納されます。

この列挙型は Qt 6.11 で導入されました。

アクセス関数：

Notifier シグナル:

[since 6.12] dragMode : QtGraphs3D::DragMode

グラフ上のドラッグイベントの解釈方法を決定します。QtGraphs3D::DragMode 列挙型の値のいずれかです。

デフォルトはQtGraphs3D::DragMode::Rotate です。

この列挙型は Qt 6.12 で導入されました。

アクセス関数:

通知シグナル:

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

gridLineType : QtGraphs3D::GridLineType

このプロパティは、グリッド線のタイプが `QtGraphs3D::GridLineType::Shader ` であるか `QtGraphs3D::GridLineType::Geometry` であるかにかかわらず有効です。

この値は、すべてのグリッド線に影響します。

アクセス関数：

通知シグナル:

「QtGraphs3D::GridLineType」も参照してください 。

horizontalAspectRatio : qreal

このプロパティは、x軸とz軸間のグラフのスケーリング比率を保持します。

0.0 の値は、軸の範囲に応じた自動スケーリングを示します。デフォルトは0.0 です。

Q3DBarsWidgetItem には影響しません。 は、barThickness およびbarSpacing プロパティを介して水平方向のスケーリングを処理します。極座標グラフでもこのプロパティは無視されます。

アクセス関数：

通知シグナル:

関連項目： aspectRatio 、polar 、Q3DBarsWidgetItem::barThickness 、およびQ3DBarsWidgetItem::barSpacing 。

labelMargin : float

このプロパティは、軸ラベルの配置に関する余白を指定します。

負の値を指定するとラベルはプロット領域の内側に配置され、正の値を指定するとプロット領域の外側に配置されます。値が負の場合、ラベルの自動回転は無効になります。デフォルト値は0.1

アクセス関数:

通知シグナル：

関連項目： QAbstract3DAxis::labelAutoAngle 。

lightColor : QColor

このプロパティは、アンビエント光およびスペキュラー光の色を保持します。

この値は、Q3DScene で指定された光に影響を与えます。

アクセス関数：

通知シグナル：

lightStrength : float

このプロパティは、グラフ全体の鏡面反射光の強度を保持します。

値は、0.0f から10.0f の範囲で指定する必要があります。

この値は、Q3DScene で指定された光に影響を与えます。

アクセス関数：

通知信号：

locale : QLocale

このプロパティは、さまざまな数値ラベルの書式設定に使用されるロケールを保持します。

デフォルトは"C" ロケールです。

アクセス関数：

通知シグナル:

関連項目: QValue3DAxis::labelFormat 。

margin : qreal

このプロパティは、プロット可能なグラフ領域の端とグラフの背景の端との間に残すスペースに使用する絶対値を保持します。

マージン値が負の場合、マージンは自動的に決定され、系列内の項目のサイズやグラフの種類に応じて変化することがあります。グラフのアスペクト比がデフォルト値から変更されていない場合、この値は Y 軸範囲に対する割合として解釈されます。デフォルト値は `-1.0` です。

アクセス関数：

通知信号：

maxCameraXRotation : float

このプロパティは、ターゲット点を軸としたカメラの最大X軸回転角度（度単位）を保持します。デフォルト値は180.0

アクセス関数：

通知シグナル：

maxCameraYRotation : float

このプロパティは、ターゲットポイントを中心としたカメラのY軸周りの最大回転角度（度単位）を保持します。デフォルト値は90.0

アクセス関数：

通知シグナル：

maxCameraZoomLevel : float

このプロパティは、カメラのズームレベルの上限値を保持します。

最大レベルが、既存の最小レベルよりも低い新しい値に設定された場合、最小レベルも新しい最大レベルに合わせて調整されます。現在のcameraZoomLevel が新しい範囲外にある場合も、同様に調整されます。デフォルトは500.0f です。

アクセス関数：

通知シグナル:

関連項目： cameraZoomLevel およびminCameraZoomLevel 。

measureFps : bool

このプロパティは、レンダリングがオンデマンドではなく継続的に行われるかどうかを指定します。

true の場合、レンダリングは連続的に行われ、currentFps プロパティの値が更新されます。デフォルトはfalse です。

アクセス関数:

通知シグナル:

currentFpsも参照してください 。

minCameraXRotation : float

このプロパティは、ターゲットポイントを中心としたカメラのX軸周りの最小回転角度（度単位）を保持します。デフォルト値は-180.0

アクセス関数：

通知シグナル：

minCameraYRotation : float

このプロパティは、ターゲットポイントを中心としたカメラのY軸周りの最小回転角度（度単位）を保持します。デフォルト値は0.0

アクセス関数：

通知シグナル：

minCameraZoomLevel : float

このプロパティは、カメラのズームレベルとして許可される最小値を保持します。

最小レベルが、既存の最大レベルよりも高い新しい値に設定された場合、最大レベルも新しい最小レベルに合わせて調整されます。現在の zoomLevel が新しい範囲外にある場合も、同様に調整されます。minCameraZoomLevel は、1.0f 未満に設定することはできません。デフォルトは10.0f です。

アクセス関数：

Notifierシグナル:

cameraZoomLevel およびmaxCameraZoomLevelも参照してください 。

msaaSamples : int

このプロパティは、MSAAで使用されるサンプル数を保持します。

使用されるMSAAサンプルの数をsamples に設定します。サンプルの数は0、2、4、または8のいずれかです。

アクセス関数：

通知信号：

optimizationHint : QtGraphs3D::OptimizationHint

レンダリングの最適化に、デフォルトモードとレガシーモードのどちらを使用するかを指定します。

デフォルトモードではインスタンス化レンダリングが使用され、ほとんどのシステムにおいて最高のパフォーマンスで全機能を利用できます。静的モードはグラフのレンダリングを最適化しており、変更のない大規模なデータセットに最適です。ただし、動的なデータ変更や項目の回転を行う場合は処理速度が低下します。選択操作は最適化されていないため、大規模なデータセットで静的モードを使用することは推奨されません。 静的最適化は散布図でのみ機能します。レガシーモードでは、インスタンス化を行わずにグラフ内のすべてのアイテムを個別にレンダリングします。これは、デフォルトモードが機能しない場合、つまりターゲットシステムがインスタンス化をサポートしていない場合にのみ使用してください。デフォルトはQtGraphs3D::OptimizationHint::Default です。

アクセス関数：

通知シグナル：

関連項目: QAbstract3DSeries::mesh 。

orthoProjection : bool

このプロパティは、グラフの表示に正射影が使用されるかどうかを指定します。

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

アクセス関数：

通知シグナル:

「QAbstract3DAxis::labelAutoAngle」も参照してください 。

[since 6.12] panEnabled : bool

このプロパティは、この入力ハンドラがグラフのパン操作を許可するかどうかを示します。

デフォルト値はtrue です。

この列挙型はQt 6.12で導入されました。

アクセス関数:

通知シグナル:

dragMode およびsetPanButton()も参照してください 。

polar : bool

この特性は、横軸が極座標軸に変更された場合でも成り立ちます。

true の場合、x軸は角度軸となり、z軸は半径軸となります。棒グラフでは極座標モードは使用できません。

デフォルトはfalse です。

アクセス関数：

通知シグナル:

「 orthoProjection 」および「radialLabelOffset 」も参照してください 。

[read-only] queriedGraphPosition : QVector3D

このプロパティには、各軸に沿った最新のグラフ位置のクエリ結果が格納されます。

この読み取り専用プロパティには、Q3DScene::graphPositionQuery の結果が含まれます。値は[-1, 1] の範囲に正規化されます。クエリされた位置がグラフの境界外にある場合、値は実際の位置を反映せず、代わりに[-1, 1] の範囲外の未定義の位置を示します。クエリが行われるまで、値は未定義のままとなります。

特定の画面位置に対応する唯一の正しい3D座標は存在しないため、一貫性を保つために、クエリは常にグラフを囲む見えないボックスの内側に対して行われます。

アクセス関数：

通知シグナル：

Q3DScene::graphPositionQueryも参照してください 。

radialLabelOffset : float

このプロパティは、放射状極座標軸の軸ラベルの正規化された水平オフセットを保持します。

値「0.0 」は、ラベルを角度軸の 0 度のグリッド線の隣に描画することを示します。値「1.0 」は、ラベルをグラフ背景の端という通常の位置に描画することを示します。デフォルトは「1.0 」です。

polar プロパティの値がfalse の場合、このプロパティは無視されます。

アクセス関数:

通知シグナル:

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

rotationEnabled : bool

このプロパティは、この入力ハンドラがグラフの回転を許可するかどうかを示します。

デフォルト値はtrue です。

アクセス関数：

通知シグナル:

[read-only] scene : Q3DScene* const

このプロパティには、シーンの操作やシーン要素へのアクセスに使用できるQ3DScene ポインタが格納されています。

このプロパティは読み取り専用です。

アクセス関数：

[read-only] selectedElement : QtGraphs3D::ElementType

このプロパティには、グラフ内で選択されている要素が格納されます。

このプロパティを使用すると、選択された要素のタイプを照会できます。このタイプは、グラフ内で新たな選択が行われ、「selectedElementChanged 」シグナルが発信されるまで有効です。

このシグナルは、たとえば「Scatter Graph 」タブにある「Graph Gallery」のサンプルで示されているように、カスタム入力ハンドラを実装するために使用できます。

アクセス関数：

通知信号:

関連項目： selectedLabelIndex()、selectedAxis()、selectedCustomItemIndex()、selectedCustomItem()、Q3DBarsWidgetItem::selectedSeries()、Q3DScatterWidgetItem::selectedSeries()、Q3DSurfaceWidgetItem::selectedSeries()、およびQ3DScene::setSelectionQueryPosition()。

selectionEnabled : bool

このプロパティは、この入力ハンドラがグラフからの選択を許可するかどうかを示します。

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

アクセス関数：

通知シグナル:

selectionMode : QtGraphs3D::SelectionFlags

項目の選択モード。

SelectionFlagsの組み合わせです。デフォルトでは、Item です。グラフの種類によって、サポートされる選択モードが異なります。

アクセス関数：

通知シグナル：

QtGraphs3D::SelectionFlagsも参照してください 。

shadowQuality : QtGraphs3D::ShadowQuality

このプロパティは、影の品質を指定します。

ShadowQuality列挙型の値の1つです。デフォルトでは、Medium です。

アクセス関数：

通知シグナル：

「QtGraphs3D::ShadowQuality」も参照してください 。

shadowStrength : float

このプロパティは、グラフ全体の影の強さを指定します。

数値が大きいほど、影は濃くなります。値は0.0 から100.0 の範囲で指定する必要があります。

この値は、Q3DScene で指定された光に影響を与えます。

アクセス関数：

通知シグナル：

[since 6.9] transparencyTechnique : QtGraphs3D::TransparencyTechnique

使用する透過処理の手法を指定します。デフォルト値は `Default` です。透過サーフェスグラフをレンダリングする場合は、`Approximate ` または `Accurate` を使用してください。その他のグラフタイプには `Default ` を使用してください。

この列挙型は Qt 6.9 で導入されました。

アクセス関数：

通知シグナル:

QtGraphs3D::TransparencyTechniqueも参照してください 。

wrapCameraXRotation : bool

このプロパティは、X軸回転における最小値と最大値の挙動を指定します。

true に設定すると、カメラのX回転は最小値から最大値へ、そして最大値から最小値へとループします。false に設定すると、カメラのX回転は最小値と最大値によって決定される範囲内に制限されます。デフォルトではtrue に設定されています。

アクセス関数：

通知シグナル：

wrapCameraYRotation : bool

このプロパティは、Y軸回転の最小値と最大値の挙動を指定します。

true の場合、カメラのY回転は最小値から最大値へ、そして最大値から最小値へとループします。false の場合、カメラのY回転は最小値と最大値によって決定される範囲内に制限されます。デフォルトではtrue に設定されています。

アクセス関数：

通知シグナル：

zoomAtTargetEnabled : bool

このプロパティは、ズーム操作後にグラフのズーム対象点が同じ位置に留まるように、カメラのターゲットを変更すべきかどうかを指定します。

デフォルト値はtrue です。

アクセス関数：

通知シグナル：

zoomEnabled : bool

このプロパティは、この入力ハンドラがグラフのズームを許可するかどうかを指定します。

デフォルト値はtrue です。

アクセス関数：

通知シグナル：

QQuickWidget quickwidget;
Q3DBarsWidgetItem graph;
graph.setWidget(&quickwidget);