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も参照してください 。


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