このページでは

QScatter3DSeries Class

QScatter3DSeries クラスは、3D 散布図におけるデータ系列を表します。詳細...

ヘッダー: #include <QScatter3DSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
バージョン: QtDataVisualization 1.0
QMLでの使用開始: Scatter3DSeries
継承元: QAbstract3DSeries
ステータス: 非推奨

このクラスは非推奨です。新しいコードでの使用は強く推奨されません。

プロパティ

パブリック関数

QScatter3DSeries(QObject *parent = nullptr)
QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr)
virtual ~QScatter3DSeries()
QScatterDataProxy *dataProxy() const
float itemSize() const
int selectedItem() const
void setDataProxy(QScatterDataProxy *proxy)
void setItemSize(float size)
void setSelectedItem(int index)

シグナル

void dataProxyChanged(QScatterDataProxy *proxy)
void itemSizeChanged(float size)
void selectedItemChanged(int index)

静的パブリックメンバー

詳細な説明

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

シリーズに対してデータプロキシが明示的に設定されていない場合、シリーズはデフォルトのプロキシを作成します。別のプロキシを設定すると、既存のプロキシおよびそこに追加されたすべてのデータが破棄されます。

QScatter3DSeries は、QAbstract3DSeries::setItemLabelFormat() に対して以下のフォーマットタグをサポートしています:

@xTitlex軸のタイトル
@yTitley軸のタイトル
@zTitlez軸からのタイトル
@xLabelx軸の書式を使用して書式設定された項目の値。詳細については、QValue3DAxis::setLabelFormat() を参照してください。
@yLabely軸の書式を使用して書式設定された項目の値。詳細については、QValue3DAxis::setLabelFormat() を参照してください。
@zLabelz軸の書式を使用して書式設定された項目の値。詳細については、QValue3DAxis::setLabelFormat() を参照してください。
@seriesName系列名

例:

proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));

「Qt Data Visualization データ処理」も参照してください 。

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

dataProxy : QScatterDataProxy*

このプロパティには、アクティブなデータプロキシが格納されます。

アクセス関数:

QScatterDataProxy *dataProxy() const
void setDataProxy(QScatterDataProxy *proxy)

通知シグナル:

void dataProxyChanged(QScatterDataProxy *proxy)

itemSize : float

このシリーズのアイテムサイズ。

サイズは、0.0f から1.0f の範囲で指定する必要があります。サイズを0.0f に設定すると、グラフのすべての系列に含まれる項目の総数に基づいて、項目のサイズが自動的にスケーリングされます。

既定値は0.0f です。

アクセス関数:

float itemSize() const
void setItemSize(float size)

通知シグナル:

void itemSizeChanged(float size)

selectedItem : int

このプロパティには、シリーズで選択されている項目が格納されます。

アクセス関数:

int selectedItem() const
void setSelectedItem(int index)

通知シグナル:

void selectedItemChanged(int index)

メンバ関数のドキュメント

[explicit] QScatter3DSeries::QScatter3DSeries(QObject *parent = nullptr)

親オブジェクトparent を使用して、3D散布図シリーズを作成します。

[explicit] QScatter3DSeries::QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr)

データプロキシ `dataProxy ` および親 `parent` を使用して、3D 散布図シリーズを作成します。

[virtual noexcept] QScatter3DSeries::~QScatter3DSeries()

「scatter」3Dシリーズを削除します。

[static] int QScatter3DSeries::invalidSelectionIndex()

選択対象として無効なインデックスが返されます。このインデックスをselectedItem プロパティに設定することで、このシリーズから選択を解除できます。

「QAbstract3DGraph::clearSelection()」も参照してください 。

void QScatter3DSeries::setDataProxy(QScatterDataProxy *proxy)

このシリーズに対して、アクティブなデータプロキシをproxy に設定します。このシリーズは、自身に設定されたプロキシの所有権を取得し、新しいプロキシが追加されると、以前に設定されていたプロキシをすべて削除します。proxy 引数は、nullにしたり、別のシリーズに設定したりすることはできません。

注: プロパティdataProxy のセッター 関数です。

関連項目: dataProxy()。

void QScatter3DSeries::setSelectedItem(int index)

このシリーズのデータ配列のうち、インデックスがindex の項目を選択します。一度に選択できる項目は1つだけです。

この系列から選択を解除するには、invalidSelectionIndex() をindex に設定します。この系列がグラフに追加されている場合、グラフはユーザーの操作に応じて、または選択が無効になった場合に、選択内容を調整することができます。追加された別の系列で項目を選択しても、選択は解除されます。

選択された項目の前後に項目を削除または挿入すると、選択範囲が調整され、同じ項目が選択されたままになります。

注: プロパティ `selectedItem`のセッター 関数です。

関連項目: selectedItem() およびQAbstract3DGraph::clearSelection()。

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