QScatter3DSeries Class
QScatter3DSeries クラスは、3D 散布図でデータ系列を表します。詳細...
| Header: | #include <QScatter3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | Scatter3DSeries |
| Inherits: | 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::setLabelFormat()を参照。 |
| yLabel | y 軸の書式を使用してフォーマットされた項目値。詳細については、QValue3DAxis::setLabelFormat()を参照。 |
| zLabel | z 軸のフォーマットでフォーマットされた項目値。詳細はQValue3DAxis::setLabelFormat() を参照。 |
| シリーズ名 | 系列の名前。 |
例えば：
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));
Qt Graphs Data Handling with 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.0f と1.0f の間でなければならない。サイズを0.0f に設定すると、項目サイズはグラフの全シリーズの項目総数に基づいて自動的にスケーリングされる。
プリセットのデフォルトは0.0f です。
アクセス機能：
| float | itemSize() const |
| void | setItemSize(float size) |
通知シグナル：
| void | itemSizeChanged(float size) |
selectedItem : qsizetype
このプロパティは、系列で選択されている項目を保持する。
シリーズのデータ配列のインデックスindex の項目を選択する。一度に選択できる項目は 1 つだけである。
この系列から選択を解除するには、invalidSelectionIndex() をindex に設定する。この系列がグラフに追加された場合、グラフはユーザーの操作に応じて、または無効となった場合に選択を調整することができる。追加された他の系列の項目を選択すると、選択範囲もクリアされる。
選択された項目の前にある系列から項目を削除したり、系列に項目を挿入したりすると、同じ項目が選択されたままになるように選択範囲が調整されます。
アクセス機能
| qsizetype | selectedItem() const |
| void | setSelectedItem(qsizetype index) |
通知シグナル：
| void | selectedItemChanged(qsizetype index) |
Q3DGraphsWidgetItem::clearSelection()も参照のこと 。
メンバ関数ドキュメント
[explicit] QScatter3DSeries::QScatter3DSeries(QObject *parent = nullptr)
parent を親とする散布図3D系列を構築します。
[explicit] QScatter3DSeries::QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr)
データプロキシdataProxy と親parent を持つ散布図 3 次元系列を構築します。
[override virtual noexcept] QScatter3DSeries::~QScatter3DSeries()
散布図 3 次元系列を削除します。
void QScatter3DSeries::clearArray()
データ配列をクリアします。
[static] qsizetype QScatter3DSeries::invalidSelectionIndex()
選択用の無効なインデックスを返します。このインデックスをselectedItem プロパティに設定することで、このシリーズからの選択をクリアします。
Q3DGraphsWidgetItem::clearSelection()も参照してください 。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
