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 |
プロパティ
- dataProxy : QScatterDataProxy*
- itemSize : float
- selectedItem : int
パブリック機能
| 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) |
静的パブリックメンバ
| int | invalidSelectionIndex() |
詳細説明
このクラスは、シリーズ固有のビジュアルエレメントと（データプロキシを介した）シリーズデータを管理します。
データプロキシがシリーズに対して明示的に設定されていない場合、シリーズはデフォルトのプロキシを作成します。別のプロキシを設定すると、既存のプロキシとそれに追加されたすべてのデータが破棄されます。
QScatter3DSeries はQAbstract3DSeries::setItemLabelFormat() で以下のフォーマットタグをサポートしています：
| xTitle | x 軸からのタイトル |
| yTitle | y 軸からのタイトル |
| zTitle | z軸からのタイトル |
| xLabel | x軸のフォーマットでフォーマットされた項目値。詳細については、QValue3DAxis::setLabelFormat()を参照。 |
| yLabel | y 軸の書式を使用してフォーマットされた項目値。詳細については、QValue3DAxis::setLabelFormat()を参照。 |
| zLabel | z 軸のフォーマットでフォーマットされた項目値。詳細は、QValue3DAxis::setLabelFormat() を参照。 |
| シリーズ名 | 系列の名前。 |
例えば：
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)
散布図 3 次元系列を親parent で構築します。
[explicit] QScatter3DSeries::QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr)
データプロキシdataProxy と親parent で散布図3D系列を構築する。
[virtual noexcept] QScatter3DSeries::~QScatter3DSeries()
スキャッター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()も参照のこと 。
© 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.
