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는 3D용Qt Graphs C++ 클래스의 일부입니다.
속성
|
공개 함수
| 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()`에 대해 다음 형식 태그를 지원합니다:
| @xTitle | x축의 제목 |
| @yTitle | y축의 제목 |
| @zTitle | z축의 제목 |
| @xLabel | x축의 서식을 사용하여 서식화된 항목 값입니다. 자세한 내용은 QValue3DAxis::labelFormat 을 참조하십시오. |
| @yLabel | y축의 서식을 사용하여 서식화된 항목 값입니다. 자세한 내용은 QValue3DAxis::labelFormat 을 참조하십시오. |
| @zLabel | z축의 서식을 사용하여 서식화된 항목 값입니다. 자세한 내용은 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 에 해당하는 항목을 선택합니다. 한 번에 하나의 항목만 선택할 수 있습니다.
이 시리즈에서 선택을 해제하려면 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()
스캐터 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.
