Scatter3DSeries QML Type (Uncreatable)

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

注：これは作成不可能な型です。QMLではインスタンス化できません。

• 継承されたメンバーを含むすべてのメンバーの一覧
• Scatter3DSeriesは、Qt Graphs の3D用QML型の一部です。

プロパティ

• baseColor : color
• baseGradient : Gradient
• colorStyle : GraphsTheme.ColorStyle
• dataArray : ScatterDataArray
• dataProxy : ScatterDataProxy
• invalidSelectionIndex : qsizetype
• itemLabel : string
• itemLabelFormat : string
• itemLabelVisible : bool
• itemSize : real
• lightingMode : Abstract3DSeries.LightingMode (since 6.10)
• mesh : Abstract3DSeries.Mesh
• meshRotation : quaternion
• meshSmooth : bool
• multiHighlightColor : color
• multiHighlightGradient : Gradient
• name : string
• selectedItem : qsizetype
• singleHighlightColor : color
• singleHighlightGradient : Gradient
• type : Abstract3DSeries.SeriesType
• userDefinedMesh : string
• visible : bool

信号

• baseColorChanged(color color)
• baseGradientChanged(Gradient gradient)
• colorStyleChanged(GraphsTheme.ColorStyle style)
• dataArrayChanged(ScatterDataArray array)
• dataProxyChanged(ScatterDataProxy proxy)
• itemLabelChanged(string label)
• itemLabelFormatChanged(string format)
• itemLabelVisibilityChanged(bool visible)
• itemSizeChanged(float size)
• lightingModeChanged(Abstract3DSeries.LightingMode lightingMode) (since 6.10)
• meshChanged(Abstract3DSeries.Mesh mesh)
• meshRotationChanged(quaternion rotation)
• meshSmoothChanged(bool enabled)
• multiHighlightColorChanged(color color)
• multiHighlightGradientChanged(Gradient gradient)
• nameChanged(string name)
• selectedItemChanged(qsizetype index)
• singleHighlightColorChanged(color color)
• singleHighlightGradientChanged(Gradient gradient)
• splineColorChanged(color color)
• splineKnottingChanged(real knotting)
• splineLoopingChanged(bool looping)
• splineResolutionChanged(int resolution)
• splineTensionChanged(real tension)
• splineVisibilityChanged(bool visible)
• userDefinedMeshChanged(string fileName)
• visibilityChanged(bool visible)

方法

• void setMeshAxisAndAngle(vector3d axis, real angle)

詳細説明

このタイプは、シリーズ固有の視覚的要素に加え、シリーズデータ（データプロキシを介して）も管理します。

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

より詳しい説明については、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 です。

visible : bool

シリーズの表示設定。false の場合、そのシリーズは表示されません。

Signal ドキュメント

baseColorChanged(color color)

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

baseGradientChanged(Gradient gradient)

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

colorStyleChanged(GraphsTheme.ColorStyle style)

このシグナルは、colorStyle がstyle に変化したときに発生します。

dataArrayChanged(ScatterDataArray array)

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

dataProxyChanged(ScatterDataProxy proxy)

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

itemLabelChanged(string label)

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

itemLabelFormatChanged(string format)

このシグナルは、itemLabelFormat がformat に変化したときに発生します。

itemLabelVisibilityChanged(bool visible)

このシグナルは、itemLabelVisibility が `visible` に変更されたときに発火します。

itemSizeChanged(float size)

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

[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)

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

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

meshChanged(Abstract3DSeries.Mesh mesh)

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

meshRotationChanged(quaternion rotation)

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

meshSmoothChanged(bool enabled)

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

multiHighlightColorChanged(color color)

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

multiHighlightGradientChanged(Gradient gradient)

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

nameChanged(string name)

このシグナルは、name がname に変化したときに発せられます。

selectedItemChanged(qsizetype index)

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

singleHighlightColorChanged(color color)

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

singleHighlightGradientChanged(Gradient gradient)

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

splineColorChanged(color color)

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

splineKnottingChanged(real knotting)

このシグナルは、`splineKnotting` が `knotting` に変更されたときに発火します。

splineLoopingChanged(bool looping)

このシグナルは、`splineLooping`が`looping`に変化したときに発生します。

splineResolutionChanged(int resolution)

このシグナルは、splineResolution が `resolution` に変更されたときに発火します。

splineTensionChanged(real tension)

このシグナルは、splineTension が `tension` に変更されたときに発火します。

splineVisibilityChanged(bool visible)

このシグナルは、`splineVisible` が `visible` に変更されたときに発火します。

userDefinedMeshChanged(string fileName)

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

visibilityChanged(bool visible)

このシグナルは、シリーズの見え方が「visible 」に変わったときに発せられます。

メソッドのドキュメント

void setMeshAxisAndAngle(vector3d axis, real angle)

axis およびangle からメッシュ回転クォータニオンを生成するための便利な関数です。

meshRotationも参照してください 。