Back to Qt.io
Contact Us Blog Download Qt
このページでは

Scatter3DSeries QML Type

データ系列を3D散布図で表現します。詳細...

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

Abstract3DSeries

Inherited By:

Spline3DSeries

プロパティ

信号

方法

詳細説明

この型は、シリーズ固有のビジュアル要素およびシリーズデータを (データプロキシを経由して) 管理します。

Scatter3DSeries は、 itemLabelFormat 用に以下のフォーマットタグをサポートしています：

xTitlex 軸のタイトル
yTitley 軸からのタイトル
zTitlez軸からのタイトル
xLabelx軸のフォーマットでフォーマットされた項目値。詳細については、labelFormat を参照。
yLabely 軸のフォーマットを使用してフォーマットされた項目値。詳細はlabelFormat を参照。
zLabelz 軸のフォーマットでフォーマットされた項目値。詳細はlabelFormat を参照。
シリーズ名シリーズ名。

より詳細な説明については、QScatter3DSeries を参照。

Qt Graphs 3Dによるデータ処理も参照 。

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

baseColor : color

シリーズのベースカラー。

colorStyle およびGraphsTheme.seriesColorsも参照の こと。

baseGradient : Gradient

シリーズのベース勾配。

colorStyleも参照のこと 。

colorStyle : GraphsTheme.ColorStyle

シリーズのカラースタイル。

GraphsTheme.ColorStyleも参照 。

dataArray : ScatterDataArray

データ配列への参照を保持する。

dataArrayChanged newDataArray が前のものと同じでない限り、データ配列がセットされるとシグナルが発せられる。

注意： データ配列に関して何かをする前に、関連するプロキシに対してシリーズを作成する必要があります。

dataProxy : ScatterDataProxy

アクティブなデータプロキシを設定する。この系列は、設定されたプロキシの所有権を引き受け、新しいプロキシが追加されると、以前に設定されたプロキシを削除する。プロキシをNULLにしたり、別のシリーズに設定したりすることはできません。

invalidSelectionIndex : qsizetype

選択のための無効なインデックスを提供する定数プロパティ。このインデックスをselectedItem プロパティに設定すると、このシリーズからの選択がクリアされる。

GraphsItem3D::clearSelection()も参照 。

itemLabel : string [read-only]

フォーマットされた項目ラベル。選択項目がないか、選択項目が表示されていない場合は、空の文字列を返します。

itemLabelFormatも参照してください 。

itemLabelFormat : string

このシリーズのデータ項目のラベルフォーマット。この書式は、項目が選択されたときなど、単一の項目ラベルに使用される。この書式がどのように解釈されるかは、シリーズ・タイプによって異なる。

Bar3DSeries 、Scatter3DSeries 、Surface3DSeriesも参照のこと 。

itemLabelVisible : bool

true の場合、アイテム・ラベルはグラフのフローティング・ラベルとして描画される。そうでない場合、項目ラベルは描画されない。外部コントロールに項目ラベルを表示するには、このプロパティをfalse に設定する。デフォルトはtrue 。

itemLabelFormat およびitemLabelも参照のこと 。

itemSize : real

シリーズのアイテムサイズを設定します。サイズは0.0 から1.0 の間でなければならない。サイズを0.0 に設定すると、グラフのすべてのシリーズのアイテムの合計数に基づいて、アイテムのサイズが自動的にスケーリングされます。プリセットのデフォルトは0.0 です。

lightingMode : Abstract3DSeries.LightingMode [since 6.10]

シリーズ内のアイテムの照明モード。デフォルト値はQAbstract3DSeries::LightingMode::Shaded

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

QAbstract3DSeries::LightingModeも参照してください 。

mesh : Abstract3DSeries.Mesh

シリーズ内のアイテムのメッシュ、またはSurface3DSeries の場合は選択ポインタ。メッシュがAbstract3DSeries.Mesh.UserDefined の場合、アイテムが正しくレンダリングされるためにはuserDefinedMesh プロパティも設定する必要があります。デフォルト値はグラフの種類によって異なります。

QAbstract3DSeries::Meshも参照してください 。

meshRotation : quaternion

シリーズのすべての項目に適用されるメッシュ回転。回転は正規化された四元数でなければならない。項目ごとの回転をサポートするシリーズタイプでは、回転は掛け合わされます。Bar3DSeries は、y軸周り以外の回転を無視します。Surface3DSeries は、選択ポインタにのみ回転を適用します。デフォルトは回転なし。

meshSmooth : bool

true の場合、mesh プロパティで設定された定義済みメッシュのスムースバージョンが使用されます。このプロパティは、メッシュがAbstract3DSeries.Mesh.UserDefined に設定されているときに使用されるカスタムメッシュには影響しません。デフォルトはfalse です。

multiHighlightColor : color

シリーズの複数アイテムのハイライトカラー。

colorStyle およびGraphsTheme.multiHighlightColorも参照してください 。

multiHighlightGradient : Gradient

シリーズの複数項目のハイライトグラデーション。

colorStyle およびGraphsTheme.multiHighlightGradientも参照のこと 。

name : string

シリーズ名。タグ@seriesName とともにアイテムラベル形式で使用できる。

itemLabelFormatも参照のこと 。

selectedItem : qsizetype

シリーズのデータ配列のインデックスで選択されている項目。一度に選択できる項目は1つだけです。この系列から選択を解除するには、invalidSelectionIndex をインデックスとして設定します。この系列がグラフに追加された場合、グラフはユーザーインタラクションに従って、または無効となった場合に選択を調整することができます。追加された他のシリーズの項目を選択すると、選択範囲もクリアされます。選択された項目の前にある系列から項目を削除したり、系列に項目を挿入したりすると、同じ項目が選択されたままになるように選択範囲が調整されます。

GraphsItem3D::clearSelection()も参照 。

singleHighlightColor : color

シリーズの単一アイテムのハイライト色。

colorStyle およびGraphsTheme.singleHighlightColorも参照のこと 。

singleHighlightGradient : Gradient

シリーズの単一アイテムのハイライトグラデーション。

colorStyle およびGraphsTheme.singleHighlightGradientも参照のこと 。

type : Abstract3DSeries.SeriesType [read-only]

シリーズのタイプ。QAbstract3DSeries::SeriesType 。

userDefinedMesh : string

mesh のときに使用されるオブジェクト用のユーザー定義カスタムメッシュのファイル名はAbstract3DSeries.Mesh.UserDefined です。

注意： ファイルはQtQuick3D メッシュ形式である必要があります。他の3Dモデルフォーマットからメッシュを作成するには、balsam 変換ツールを使用してください。

visible : bool

シリーズの可視性。false の場合、シリーズはレンダリングされない。

シグナルのドキュメント

baseColorChanged(color color)

このシグナルは、baseColor がcolor に変更されたときに発せられる。

注： 対応するハンドラはonBaseColorChanged 。

baseGradientChanged(Gradient gradient)

このシグナルは、baseGradient がgradient に変更されたときに発せられる。

注： 対応するハンドラはonBaseGradientChanged 。

colorStyleChanged(GraphsTheme.ColorStyle style)

このシグナルは、colorStyle がstyle に変更されたときに発せられる。

注： 対応するハンドラはonColorStyleChanged 。

dataArrayChanged(ScatterDataArray array)

このシグナルは、dataArray がarray に変更されたときに発せられる。

注： 対応するハンドラはonDataArrayChanged 。

dataProxyChanged(ScatterDataProxy proxy)

このシグナルは、dataProxy がproxy に変更されたときに発せられる。

注： 対応するハンドラはonDataProxyChanged 。

itemLabelChanged(string label)

このシグナルは、itemLabel がlabel に変更されたときに発せられる。

注： 対応するハンドラはonItemLabelChanged 。

itemLabelFormatChanged(string format)

このシグナルは、itemLabelFormat がformat に変更されたときに発せられる。

注： 対応するハンドラはonItemLabelFormatChanged 。

itemLabelVisibilityChanged(bool visible)

このシグナルは、itemLabelVisibility がvisible に変更されたときに発行される。

注： 対応するハンドラはonItemLabelVisibilityChanged です。

itemSizeChanged(float size)

このシグナルは、itemSize がsize に変更されたときに発せられる。

注： 対応するハンドラはonItemSizeChanged 。

[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)

このシグナルは、lightingMode がlightingMode に変更されたときに発せられる。

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

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

meshChanged(Abstract3DSeries.Mesh mesh)

このシグナルは、mesh がmesh に変更されたときに発せられる。

注： 対応するハンドラはonMeshChanged 。

meshRotationChanged(quaternion rotation)

このシグナルは、meshRotation がrotation に変更されたときに発せられる。

注： 対応するハンドラはonMeshRotationChanged 。

meshSmoothChanged(bool enabled)

このシグナルは、meshSmooth がenabled に変更されたときに発せられる。

注： 対応するハンドラはonMeshSmoothChanged 。

multiHighlightColorChanged(color color)

このシグナルは、multiHighlightColor がcolor に変更されたときに発せられる。

注： 対応するハンドラはonMultiHighlightColorChanged 。

multiHighlightGradientChanged(Gradient gradient)

このシグナルは、multiHighlightGradient がgradient に変更されたときに発せられる。

注： 対応するハンドラはonMultiHighlightGradientChanged 。

nameChanged(string name)

このシグナルは、name がname に変更されたときに発せられる。

注： 対応するハンドラはonNameChanged 。

selectedItemChanged(qsizetype index)

このシグナルは、selectedItem がindex に変更されたときに発せられる。

注： 対応するハンドラはonSelectedItemChanged 。

singleHighlightColorChanged(color color)

このシグナルは、singleHighlightColor がcolor に変更されたときに発せられる。

注： 対応するハンドラはonSingleHighlightColorChanged 。

singleHighlightGradientChanged(Gradient gradient)

このシグナルは、singleHighlightGradient がgradient に変更されたときに発せられる。

注： 対応するハンドラはonSingleHighlightGradientChanged 。

splineColorChanged(color color)

このシグナルは、splineColor がcolor に変化したときに発せられる。

注： 対応するハンドラはonSplineColorChanged 。

splineKnottingChanged(real knotting)

このシグナルは、splineKnotting がknotting に変更されたときに発せられる。

注： 対応するハンドラはonSplineKnottingChanged 。

splineLoopingChanged(bool looping)

このシグナルは、splineLooping がlooping に変更されたときに発せられる。

注： 対応するハンドラはonSplineLoopingChanged 。

splineResolutionChanged(int resolution)

このシグナルは、splineResolution がresolution に変更されたときに発せられる。

注： 対応するハンドラはonSplineResolutionChanged 。

splineTensionChanged(real tension)

このシグナルは、splineTension がtension に変更されたときに発せられる。

注： 対応するハンドラはonSplineTensionChanged 。

splineVisibilityChanged(bool visible)

このシグナルは、splineVisible がvisible に変化したときに発せられる。

注： 対応するハンドラはonSplineVisibilityChanged です。

userDefinedMeshChanged(string fileName)

このシグナルは、userDefinedMesh がfileName に変更されたときに発せられる。

注： 対応するハンドラはonUserDefinedMeshChanged 。

visibilityChanged(bool visible)

このシグナルは、シリーズの可視性がvisible に変更されたときに発行される。

注： 対応するハンドラはonVisibilityChanged 。

メソッド・ドキュメント

void setMeshAxisAndAngle(vector3d axis, real angle)

axis とangle からメッシュ回転四元数を作成する便利な関数。

meshRotationも参照してください ．

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