QScatter3DSeries Class

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

ヘッダー #include <QScatter3DSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake QT += graphs
QML で Scatter3DSeries
継承: QAbstract3DSeries

プロパティ

パブリック機能

QScatter3DSeries(QObject *parent = nullptr)
QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr)
virtual ~QScatter3DSeries() override
void clearArray()
QScatterDataArray dataArray() &&
const QScatterDataArray &dataArray() const &
QScatterDataProxy *dataProxy() const
float itemSize() const
qsizetype selectedItem() const
void setDataArray(const QScatterDataArray &newDataArray)
void setDataProxy(QScatterDataProxy *proxy)
void setItemSize(float size)
void setSelectedItem(qsizetype index)

シグナル

void dataArrayChanged(const QScatterDataArray &array)
void dataProxyChanged(QScatterDataProxy *proxy)
void itemSizeChanged(float size)
void selectedItemChanged(qsizetype index)

静的パブリックメンバ

qsizetype invalidSelectionIndex()

詳細説明

このクラスは、シリーズ固有のビジュアル要素と、(データプロキシを介した)シリーズデータを管理します。

プロキシとシリーズの関係については、いくつかの重要なポイントを強調することが重要です。このコンテキストでは、データは系列に格納され、ユーザは系列を通してデータセットにアクセスできる。この系列はプロキシオブジェクトによって制御または表現される。したがって、このプロキシを使って、データに対するさまざまな操作を管理し、実際のデータセットを更新することができる。ただし、データセットを編集するには、このプロキシに関連付けられた系列を作成する必要がある。

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

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

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

例えば:

proxy->setItemLabelFormat(QStringLiteral("@yTitle for (@xLabel, @zLabel): %.1f"));

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

プロパティ・ドキュメンテーション

dataArray : QScatterDataArray

シリーズのデータ配列。

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

dataArrayChanged シグナルは、データ配列が設定されたときに発行される。ただし、newDataArray が前のものと同一である場合を除く。

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

アクセス関数:

const QScatterDataArray &dataArray() const &
QScatterDataArray dataArray() &&
void setDataArray(const QScatterDataArray &newDataArray)

通知シグナル:

void dataArrayChanged(const QScatterDataArray &array)

clearArray()も参照のこと

dataProxy : QScatterDataProxy*

このプロパティはアクティブなデータプロキシを保持する。

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

アクセス関数

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

通知シグナル:

void dataProxyChanged(QScatterDataProxy *proxy)

itemSize : float

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

サイズは0.0f1.0f の間でなければならない。サイズを0.0f に設定すると、グラフの全シリーズのアイテムの合計数に基づいて、アイテムのサイズが自動的にスケーリングされます。

プリセットのデフォルトは0.0f です。

アクセス機能:

float itemSize() const
void setItemSize(float size)

通知シグナル:

void itemSizeChanged(float size)

selectedItem : qsizetype

このプロパティは、シリーズで選択されている項目を保持する。

シリーズのデータ配列のインデックスindex の項目を選択する。一度に選択できる項目は一つである。

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

選択された項目の前にある系列から項目を削除したり、系列に項目を挿入したりすると、同じ項目が選択されたままになるように選択範囲が調整されます。

アクセス機能

qsizetype selectedItem() const
void setSelectedItem(qsizetype index)

通知シグナル:

void selectedItemChanged(qsizetype index)

Q3DGraphsWidgetItem::clearSelection()も参照のこと

メンバ関数ドキュメント

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

散布図 3 次元系列を親parent で構築します。

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

データプロキシdataProxy と親parent で散布図3D系列を構築する。

[override virtual noexcept] QScatter3DSeries::~QScatter3DSeries()

スキャッター3Dシリーズを削除する。

void QScatter3DSeries::clearArray()

データ配列をクリアする。

[static] qsizetype QScatter3DSeries::invalidSelectionIndex()

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

Q3DGraphsWidgetItem::clearSelection()も参照してください

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