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 はQt Graphs C++ Classes for 3D に含まれます。
プロパティ
- dataArray : QScatterDataArray
- dataProxy : QScatterDataProxy*
- itemSize : float
- selectedItem : qsizetype
パブリック機能
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() で以下のフォーマットタグをサポートしています:
xTitle | x 軸のタイトル |
yTitle | y 軸からのタイトル |
zTitle | z軸からのタイトル |
xLabel | x軸のフォーマットでフォーマットされた項目値。詳細については、QValue3DAxis::labelFormat を参照。 |
yLabel | y 軸のフォーマットを使用してフォーマットされた項目値。詳細はQValue3DAxis::labelFormat を参照。 |
zLabel | z 軸のフォーマットでフォーマットされた項目値。詳細はQValue3DAxis::labelFormat を参照。 |
シリーズ名 | シリーズの名前。 |
例えば:
proxy->setItemLabelFormat(QStringLiteral("@yTitle for (@xLabel, @zLabel): %.1f"));
プロパティ・ドキュメンテーション
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.0f
と1.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.