このページでは

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
継承元:

QSpline3DSeries

プロパティ

  • (since 6.11) axisX : QValue3DAxis*
  • (since 6.11) axisY : QValue3DAxis*
  • (since 6.11) axisZ : QValue3DAxis*
  • dataArray : QScatterDataArray

パブリック関数

QScatter3DSeries(QObject *parent = nullptr)
QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr)
virtual ~QScatter3DSeries() override
QValue3DAxis *axisX() const
QValue3DAxis *axisY() const
QValue3DAxis *axisZ() const
void clearArray()
void clearScaleArray()
const QScatterDataArray &dataArray() const &
QScatterDataArray dataArray() &&
QScatterDataProxy *dataProxy() const
float itemSize() const
void resetAxisX()
void resetAxisY()
void resetAxisZ()
const QList<QVector3D> &scaleArray() const &
QList<QVector3D> scaleArray() &&
qsizetype selectedItem() const
void setAxisX(QValue3DAxis *axis)
void setAxisY(QValue3DAxis *axis)
void setAxisZ(QValue3DAxis *axis)
void setDataArray(const QScatterDataArray &newDataArray)
void setDataProxy(QScatterDataProxy *proxy)
void setItemSize(float size)
void setScaleArray(const QList<QVector3D> &newScaleArray)
void setSelectedItem(qsizetype index)

シグナル

void axisXChanged(QValue3DAxis *axis)
void axisYChanged(QValue3DAxis *axis)
void axisZChanged(QValue3DAxis *axis)
void dataArrayChanged(const QScatterDataArray &array)
void dataProxyChanged(QScatterDataProxy *proxy)
void itemSizeChanged(float size)
void scaleArrayChanged(const QList<QVector3D> &scaleArray)
void selectedItemChanged(qsizetype index)

静的パブリックメンバー

qsizetype invalidSelectionIndex()

詳細な説明

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

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

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

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

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

例:

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

Qt Graphs 「3D データ処理」も参照してください 。

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

[since 6.11] axisX : QValue3DAxis*

この系列に対して追加のX軸を設定します。軸が指定された場合、その系列は指定された軸の最小値と最大値の範囲に合わせてフィットされます。

この列挙型は Qt 6.11 で導入されました。

アクセス関数:

QValue3DAxis *axisX() const
void setAxisX(QValue3DAxis *axis)
void resetAxisX()

Notifier シグナル:

void axisXChanged(QValue3DAxis *axis)

[since 6.11] axisY : QValue3DAxis*

この系列に対して追加のY軸を設定します。軸が指定された場合、その系列は指定された軸の最小値と最大値の範囲に合わせてフィットされます。

この列挙型はQt 6.11で導入されました。

アクセス関数:

QValue3DAxis *axisY() const
void setAxisY(QValue3DAxis *axis)
void resetAxisY()

Notifier シグナル:

void axisYChanged(QValue3DAxis *axis)

[since 6.11] axisZ : QValue3DAxis*

このシリーズには追加のZ軸が設定されます。軸が指定された場合、シリーズはその軸の最小値と最大値の範囲に合わせてフィットされます。

この列挙型は Qt 6.11 で導入されました。

アクセス関数:

QValue3DAxis *axisZ() const
void setAxisZ(QValue3DAxis *axis)
void resetAxisZ()

Notifierシグナル:

void axisZChanged(QValue3DAxis *axis)

dataArray : QScatterDataArray

シリーズ用のデータ配列。

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

データ配列が設定された際、newDataArray が前回の値と同一でない限り、dataArrayChangedシグナルが発火します。

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

アクセス関数:

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)

scaleArray : QList<QVector3D>

この系列のスケール配列。

スケール配列への参照を保持します。

スケール配列が設定された際、newScaleArray が前回の値と同一でない限り、scaleArrayChangedシグナルが発行されます。

注: スケール配列に関する操作を行う前に 、関連するプロキシに対してシリーズを作成しておく必要があります。

注: データにスケールが指定されていない場合 、デフォルト値 (1.0,1.0,1.0) が使用されます。

アクセス関数:

const QList<QVector3D> &scaleArray() const &
QList<QVector3D> scaleArray() &&
void setScaleArray(const QList<QVector3D> &newScaleArray)

通知シグナル:

void scaleArrayChanged(const QList<QVector3D> &scaleArray)

関連項目: clearScaleArray()。

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` を使用して、散布図の 3D シリーズを作成します。

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

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

void QScatter3DSeries::clearArray()

データ配列をクリアします。

void QScatter3DSeries::clearScaleArray()

scale配列をクリアします。

[static] qsizetype QScatter3DSeries::invalidSelectionIndex()

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

「Q3DGraphsWidgetItem::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.