QScatterDataProxy Class
QScatterDataProxy 클래스는 3D 산점도 그래프를 위한 데이터 프록시입니다. 더 보기...
| 헤더: | #include <QScatterDataProxy> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| QML에서: | ScatterDataProxy |
| 상속: | QAbstractDataProxy |
| 상속받는 클래스: |
- 상속받은 멤버를 포함한 모든 멤버 목록
- QScatterDataProxy는 3D용Qt Graphs C++ 클래스의 일부입니다.
속성
공개 함수
| QScatterDataProxy(QObject *parent = nullptr) | |
| virtual | ~QScatterDataProxy() override |
| qsizetype | addItem(QScatterDataItem item) |
| qsizetype | addItems(QScatterDataArray items) |
| void | insertItem(qsizetype index, QScatterDataItem item) |
| void | insertItems(qsizetype index, QScatterDataArray items) |
| const QScatterDataItem & | itemAt(qsizetype index) const |
| qsizetype | itemCount() const |
| void | removeItems(qsizetype index, qsizetype removeCount) |
| void | resetArray() |
| void | resetArray(QScatterDataArray newArray) |
| void | resetScaleArray(QList<QVector3D> newArray) |
| QVector3D | scaleAt(qsizetype index) const |
| QScatter3DSeries * | series() const |
| void | setItem(qsizetype index, QScatterDataItem item) |
| void | setItems(qsizetype index, QScatterDataArray items) |
신호
| void | arrayReset() |
| void | itemCountChanged(qsizetype count) |
| void | itemsAdded(qsizetype startIndex, qsizetype count) |
| void | itemsChanged(qsizetype startIndex, qsizetype count) |
| void | itemsInserted(qsizetype startIndex, qsizetype count) |
| void | itemsRemoved(qsizetype startIndex, qsizetype count) |
| void | seriesChanged(QScatter3DSeries *series) |
관련 비회원
상세 설명
산점도 데이터 프록시는 데이터 항목의 추가, 삽입, 변경 및 제거를 처리합니다. 데이터는 시리즈로 저장되므로, 데이터셋에 대해 이러한 함수를 사용하기 전에 프록시와 연관된 시리즈를 생성해야 합니다.
QScatterDataProxy는 전달된 모든 QtGraphs::QScatterDataArray 및 QScatterDataItem 객체의 소유권을 인수합니다.
Qt Graphs 의 3D 데이터 처리 항목도 참조하십시오 .
속성 설명서
[read-only] itemCount : qsizetype
이 속성은 배열에 포함된 항목의 개수를 나타냅니다.
액세스 함수:
| qsizetype | itemCount() const |
알림 신호:
| void | itemCountChanged(qsizetype count) |
[read-only] series : QScatter3DSeries*
이 속성은 이 프록시가 연결된 시계를 저장합니다.
액세스 함수:
| QScatter3DSeries * | series() const |
알림 신호:
| void | seriesChanged(QScatter3DSeries *series) |
멤버 함수 설명서
[explicit] QScatterDataProxy::QScatterDataProxy(QObject *parent = nullptr)
지정된 ` parent`를 사용하여 `QScatterDataProxy`를 생성합니다.
[override virtual noexcept] QScatterDataProxy::~QScatterDataProxy()
스캐터 데이터 프록시를 삭제합니다.
qsizetype QScatterDataProxy::addItem(QScatterDataItem item)
item 항목을 배열의 맨 끝에 추가합니다.
추가된 항목의 인덱스를 반환합니다.
qsizetype QScatterDataProxy::addItems(QScatterDataArray items)
items 로 지정된 항목을 배열의 끝에 추가합니다.
가장 먼저 추가된 항목의 인덱스를 반환합니다.
[signal] void QScatterDataProxy::arrayReset()
이 신호는 데이터 배열이 초기화될 때 발생합니다. resetArray()를 호출하지 않고 배열 전체의 내용을 변경한 경우, 그래프를 업데이트하기 위해 이 신호를 발생시켜야 합니다.
void QScatterDataProxy::insertItem(qsizetype index, QScatterDataItem item)
item 항목을 index 위치에 삽입합니다. 인덱스가 데이터 배열의 크기와 같을 경우, 해당 항목은 배열에 추가됩니다.
void QScatterDataProxy::insertItems(qsizetype index, QScatterDataArray items)
items 로 지정된 항목을 index 위치에 삽입합니다. 인덱스가 데이터 배열의 크기와 같을 경우, 해당 항목들은 배열에 추가됩니다.
const QScatterDataItem &QScatterDataProxy::itemAt(qsizetype index) const
인덱스 index 에 있는 항목에 대한 포인터를 반환합니다. 이 포인터는 데이터를 수정하는 다음 호출이 이루어질 때까지만 유효함이 보장됩니다.
[signal] void QScatterDataProxy::itemsAdded(qsizetype startIndex, qsizetype count)
이 신호는 ` count `로 지정된 개수의 항목이 ` startIndex` 위치부터 추가될 때 발생합니다. ` addItem()` 또는 ` addItems()`를 호출하지 않고 배열에 항목을 추가한 경우, 그래프를 업데이트하기 위해 이 신호를 발생시켜야 합니다.
[signal] void QScatterDataProxy::itemsChanged(qsizetype startIndex, qsizetype count)
이 신호는 ` count `로 지정된 개수의 항목이 ` startIndex` 위치부터 변경될 때 발생합니다. ` setItem()` 또는 ` setItems()`를 호출하지 않고 배열의 항목을 변경한 경우, 그래프를 업데이트하기 위해 이 신호를 발생시켜야 합니다.
[signal] void QScatterDataProxy::itemsInserted(qsizetype startIndex, qsizetype count)
이 신호는 ` count `로 지정된 개수의 항목이 ` startIndex` 위치부터 삽입될 때 발생합니다. ` insertItem()` 또는 ` insertItems()`를 호출하지 않고 배열에 항목을 삽입하는 경우, 그래프를 업데이트하기 위해 이 신호를 발생시켜야 합니다.
[signal] void QScatterDataProxy::itemsRemoved(qsizetype startIndex, qsizetype count)
이 신호는 ` count `로 지정된 행 수가 ` startIndex` 위치부터 제거될 때 발생합니다. 배열의 끝에서 항목이 제거되는 경우 인덱스가 현재 배열 크기보다 클 수 있습니다. ` removeItems()`를 호출하지 않고 배열에서 항목을 제거하는 경우, 그래프를 업데이트하기 위해 이 신호를 발생시켜야 합니다.
void QScatterDataProxy::removeItems(qsizetype index, qsizetype removeCount)
index 로 지정한 위치부터 시작하여, removeCount 로 지정한 개수의 항목을 제거합니다. 배열의 끝을 넘어가는 항목을 제거하려고 하면 아무 작업도 수행되지 않습니다.
void QScatterDataProxy::resetArray()
기존 배열을 지우고 arrayReset() 신호를 트리거합니다.
void QScatterDataProxy::resetArray(QScatterDataArray newArray)
newArray 에서 배열을 설정합니다. 새 배열이 기존 배열과 동일한 경우, 이 함수는 단순히 arrayReset() 신호를 트리거합니다.
void QScatterDataProxy::resetScaleArray(QList<QVector3D> newArray)
newArray 의 scale 배열을 설정합니다. 새 배열이 기존 배열과 동일한 경우, 이 함수는 단순히 scaleArrayReset() 신호를 트리거합니다.
QVector3D QScatterDataProxy::scaleAt(qsizetype index) const
index 인덱스에 있는 스케일 데이터를 반환합니다. 이 데이터는 데이터를 수정하는 다음 호출이 이루어질 때까지만 유효함이 보장됩니다.
void QScatterDataProxy::setItem(qsizetype index, QScatterDataItem item)
index 위치에 있는 항목을 item 항목으로 대체합니다.
void QScatterDataProxy::setItems(qsizetype index, QScatterDataArray items)
index 위치부터 시작하는 항목들을 items 에 지정된 항목들로 대체합니다.
© 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.