Scatter3DSeries QML Type

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

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

Abstract3DSeries

プロパティ

信号

方法

詳細説明

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

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

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

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

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

プロパティの説明

baseColor : color

シリーズのベースカラーを設定します。

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


baseGradient : Gradient

系列のベースグラデーションを設定します。

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


colorStyle : GraphsTheme.ColorStyle

シリーズのカラースタイルを設定します。

GraphsTheme.ColorStyleも参照して ください。


dataArray : ScatterDataArray

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

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

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


dataProxy : ScatterDataProxy

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


invalidSelectionIndex : qsizetype

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

GraphsItem3D::clearSelection()も参照


itemLabel : string [read-only]

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

itemLabelFormat参照して ください。


itemLabelFormat : string

このシリーズのデータ項目のラベルフォーマット。この書式は、項目が選択されている場合など、単一の項目ラベルに使用されます。この書式がどのように解釈されるかは、系列タイプによって異なります。

Bar3DSeriesScatter3DSeriesSurface3DSeriesも参照


itemLabelVisible : bool

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

itemLabelFormat およびitemLabelも参照してください


itemSize : float

項目のサイズを設定します。サイズは0.01.0 の間でなければなりません。サイズを0.0 に設定すると、グラフの全シリーズのアイテムの合計数に基づいて、アイテムのサイズが自動的に拡大縮小されます。プリセットのデフォルトは0.0 です。


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

meshAbstract3DSeries.Mesh.UserDefined の場合に使用される、ユーザー定義のオブジェクト用カスタムメッシュのファイル名を設定します。

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


visible : bool

シリーズの可視性を設定します。false の場合、系列はレンダリングされません。


シグナル ドキュメント

baseColorChanged(color color)

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

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


baseGradientChanged(Gradient gradient)

このシグナルはbaseGradientgradient に変更されたときに発行される。

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


colorStyleChanged(GraphsTheme.ColorStyle style)

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

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


dataArrayChanged(ScatterDataArray array)

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

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


dataProxyChanged(ScatterDataProxy proxy)

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

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


itemLabelChanged(string label)

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

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


itemLabelFormatChanged(string format)

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

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


itemLabelVisibilityChanged(bool visible)

itemLabelVisibility がvisible に変更されると、このシグナルが発生します。

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


itemSizeChanged(float size)

このシグナルはitemSizesize に変更されたときに発行されます。

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


meshChanged(Abstract3DSeries.Mesh mesh)

このシグナルはmeshmesh に変更されたときに発行されます。

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


meshRotationChanged(quaternion rotation)

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

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


meshSmoothChanged(bool enabled)

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

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


multiHighlightColorChanged(color color)

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

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


multiHighlightGradientChanged(Gradient gradient)

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

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


nameChanged(string name)

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

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


selectedItemChanged(qsizetype index)

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

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


singleHighlightColorChanged(color color)

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

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


singleHighlightGradientChanged(Gradient gradient)

このシグナルは、singleHighlightGradientgradient に変わったときに発せられる。

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


userDefinedMeshChanged(string fileName)

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

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


visibilityChanged(bool visible)

このシグナルは、シリーズの可視性がvisible に変化したときに発せられる。

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


メソッドドキュメント

void setMeshAxisAndAngle(vector3d axis, real angle)

axisangle からメッシュ回転クォータニオンを構築する便利な関数.

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.