이 페이지에서

QScatterDataProxy Class

QScatterDataProxy 클래스는 3D 산점도 그래프를 위한 데이터 프록시입니다. 더 보기...

헤더: #include <QScatterDataProxy>
CMake: find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
출시일: QtDataVisualization 1.0
QML에서: ScatterDataProxy
상속: QAbstractDataProxy
상속받는 클래스:

QItemModelScatterDataProxy

상태: 사용 중단

이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서 이 클래스를 사용하지 않도록 강력히 권장합니다.

속성

공개 함수

QScatterDataProxy(QObject *parent = nullptr)
virtual ~QScatterDataProxy()
int addItem(const QScatterDataItem &item)
int addItems(const QScatterDataArray &items)
const QScatterDataArray *array() const
void insertItem(int index, const QScatterDataItem &item)
void insertItems(int index, const QScatterDataArray &items)
const QScatterDataItem *itemAt(int index) const
int itemCount() const
void removeItems(int index, int removeCount)
void resetArray(QScatterDataArray *newArray)
QScatter3DSeries *series() const
void setItem(int index, const QScatterDataItem &item)
void setItems(int index, const QScatterDataArray &items)

신호

void arrayReset()
void itemCountChanged(int count)
void itemsAdded(int startIndex, int count)
void itemsChanged(int startIndex, int count)
void itemsInserted(int startIndex, int count)
void itemsRemoved(int startIndex, int count)
void seriesChanged(QScatter3DSeries *series)

상세 설명

스캐터 데이터 프록시는 데이터 항목의 추가, 삽입, 변경 및 제거를 처리합니다.

QScatterDataProxy는 자신에게 전달된 모든 QtDataVisualization::QScatterDataArray 및 QScatterDataItem 객체의 소유권을 가져갑니다.

Qt Data Visualization 데이터 처리도 참조하십시오 .

속성 문서

[read-only] itemCount : int

이 속성은 배열에 포함된 항목의 개수를 나타냅니다.

액세스 함수:

int itemCount() const

알림 신호:

void itemCountChanged(int count)

[read-only] series : QScatter3DSeries*

이 속성은 이 프록시가 연결된 시리를 저장합니다.

액세스 함수:

QScatter3DSeries *series() const

알림 신호:

void seriesChanged(QScatter3DSeries *series)

멤버 함수 설명서

[explicit] QScatterDataProxy::QScatterDataProxy(QObject *parent = nullptr)

지정된 ` parent`를 사용하여 `QScatterDataProxy`를 생성합니다.

[virtual noexcept] QScatterDataProxy::~QScatterDataProxy()

스캐터 데이터 프록시를 삭제합니다.

int QScatterDataProxy::addItem(const QScatterDataItem &item)

item 항목을 배열의 맨 끝에 추가합니다.

추가된 항목의 인덱스를 반환합니다.

int QScatterDataProxy::addItems(const QScatterDataArray &items)

items 로 지정된 항목을 배열의 끝에 추가합니다.

가장 먼저 추가된 항목의 인덱스를 반환합니다.

const QScatterDataArray *QScatterDataProxy::array() const

데이터 배열에 대한 포인터를 반환합니다.

[signal] void QScatterDataProxy::arrayReset()

이 신호는 데이터 배열이 재설정될 때 발생합니다. resetArray()를 호출하지 않고 배열 전체의 내용을 변경한 경우, 그래프를 업데이트하기 위해 이 신호를 발생시켜야 합니다.

void QScatterDataProxy::insertItem(int index, const QScatterDataItem &item)

item 항목을 index 위치에 삽입합니다. 인덱스가 데이터 배열의 크기와 같을 경우, 해당 항목은 배열에 추가됩니다.

void QScatterDataProxy::insertItems(int index, const QScatterDataArray &items)

items 로 지정된 항목을 index 위치에 삽입합니다. 인덱스가 데이터 배열의 크기와 같을 경우, 해당 항목들은 배열에 추가됩니다.

const QScatterDataItem *QScatterDataProxy::itemAt(int index) const

인덱스 ` index`에 있는 항목에 대한 포인터를 반환합니다. 이 포인터는 데이터를 수정하는 다음 호출이 발생할 때까지만 유효한 것으로 보장됩니다.

[signal] void QScatterDataProxy::itemsAdded(int startIndex, int count)

이 신호는 ` count `로 지정된 개수의 항목이 ` startIndex` 위치부터 추가될 때 발생합니다. ` addItem()` 또는 ` addItems()`을 호출하지 않고 배열에 항목을 추가하는 경우, 그래프를 업데이트하기 위해 이 신호를 발생시켜야 합니다.

[signal] void QScatterDataProxy::itemsChanged(int startIndex, int count)

이 신호는 ` count `로 지정된 항목 수가 ` startIndex` 위치부터 변경될 때 발생합니다. ` setItem()` 또는 ` setItems()`를 호출하지 않고 배열의 항목을 변경한 경우, 그래프를 업데이트하기 위해 이 신호를 발생시켜야 합니다.

[signal] void QScatterDataProxy::itemsInserted(int startIndex, int count)

이 신호는 ` count `로 지정된 개수의 항목이 ` startIndex` 위치부터 삽입될 때 발생합니다. ` insertItem()` 또는 ` insertItems()`를 호출하지 않고 배열에 항목을 삽입하는 경우, 그래프를 업데이트하기 위해 이 신호를 발생시켜야 합니다.

[signal] void QScatterDataProxy::itemsRemoved(int startIndex, int count)

이 신호는 ` count `로 지정된 행 수가 ` startIndex` 위치부터 제거될 때 발생합니다. 배열의 끝에서 항목을 제거하는 경우 인덱스가 현재 배열 크기보다 클 수 있습니다. ` removeItems()`를 호출하지 않고 배열에서 항목을 제거하는 경우, 그래프를 업데이트하기 위해 이 신호를 발생시켜야 합니다.

void QScatterDataProxy::removeItems(int index, int removeCount)

index 에서 시작하여 removeCount 로 지정된 개수의 항목을 제거합니다. 배열의 끝을 넘어서는 항목을 제거하려고 시도해도 아무 작업도 수행되지 않습니다.

void QScatterDataProxy::resetArray(QScatterDataArray *newArray)

newArray 배열을 인수로 받아들입니다. 새 배열이 기존 배열과 다른 경우 기존 배열을 지웁니다. 두 배열이 동일한 경우, 이 함수는 arrayReset() 신호를 트리거할 뿐입니다.

null 배열을 전달하면 기존 배열이 삭제되고 새로운 빈 배열이 생성됩니다.

void QScatterDataProxy::setItem(int index, const QScatterDataItem &item)

index 위치에 있는 항목을 item 항목으로 대체합니다.

void QScatterDataProxy::setItems(int index, const QScatterDataArray &items)

index 위치부터 시작하는 항목들을 items 에 지정된 항목들로 대체합니다.

관련 비회원

QScatterDataArray

QScatterDataItem 객체 목록입니다.

© 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.