QScatter3DSeries Class
QScatter3DSeries 클래스는 3D 분산 그래프에서 데이터 계열을 나타냅니다. 더 보기...
| Header: | #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)
부모 parent 와 함께 스캐터 3D 계열을 구성합니다.
[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 인덱스에 있는 항목을 선택합니다. 한 번에 하나의 항목만 선택할 수 있습니다.
이 시리즈에서 선택을 지우려면 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.
