Back to Qt.io
Contact Us Blog Download Qt

ItemModelScatterDataProxy QML Type

를 사용하여 항목 모델에 데이터를 표시하는 프록시 클래스 Scatter3D. 더 보기...

Import Statement: import QtGraphs
In C++: QItemModelScatterDataProxy
Inherits:

ScatterDataProxy

속성

신호

상세 설명

이 유형을 사용하면 AbstractItemModel 파생 모델을 Scatter3D 의 데이터 소스로 사용할 수 있습니다.

데이터는 매핑이나 모델이 변경될 때마다 비동기적으로 확인됩니다. QScatterDataProxy::arrayReset()는 데이터가 해결될 때 발생합니다.

자세한 내용은 QItemModelScatterDataProxy 문서를 참조하세요.

사용 예시:

ItemModelScatterDataProxy {
    itemModel: model // E.g. a list model defined elsewhere containing point coordinates.
    // Mapping model roles to scatter series item coordinates.
    xPosRole: "xPos"
    yPosRole: "yPos"
    zPosRole: "zPos"
}

ScatterDataProxy 및 Qt Graphs 3D로 데이터 처리하기 문서를참조하세요 .

속성 문서

itemModel : model

Scatter3D 의 데이터 소스로 사용할 아이템 모델입니다.


rotationRole : string

아이템 로테이션에 매핑할 아이템 모델 역할입니다. 모델은 회전 값을 quaternion 로 직접 변환할 수 있는 변형 또는 문자열 표현 중 하나인 "scalar,x,y,z" 또는 "@angle,x,y,z" 으로 제공할 수 있습니다. 첫 번째 형식은 주어진 값으로 직접 quaternion 을 구성하고, 두 번째 형식은 QQuaternion::fromAxisAndAngle() 메서드를 사용하여 quaternion 을 구성합니다.


rotationRolePattern : regExp

이 속성을 설정하면 회전 역할에 매핑된 값에서 검색 및 바꾸기가 수행된 후 항목 로테이션으로 사용됩니다. 이 속성은 매핑된 값에서 바꿀 부분을 찾기 위한 정규식을 지정하며 rotationRoleReplace 속성에는 바꾸기 문자열이 포함됩니다.

rotationRole 및 rotationRoleReplace 을참조하세요 .


rotationRoleReplace : string

이 속성은 rotationRolePattern 와 함께 사용할 대체 콘텐츠를 정의합니다. 기본값은 빈 문자열입니다. 정규식을 사용한 검색 및 바꾸기의 작동 방식에 대한 자세한 내용은 QString::replace(const QRegularExpression &rx, const QString &after) 함수 설명서를 참조하세요.

rotationRole 및 rotationRolePattern도 참조하세요 .


type : AbstractDataProxy.DataType [read-only]

프록시 유형. QAbstractDataProxy::DataType 값 중 하나입니다.


xPosRole : string

X 위치에 매핑할 항목 모델 역할입니다.


xPosRolePattern : regExp

설정하면 X 위치 역할에 매핑된 값을 항목 위치 값으로 사용하기 전에 검색 및 바꾸기가 수행됩니다. 이 속성은 매핑된 값에서 바꿀 부분을 찾기 위한 정규식을 지정하며 xPosRoleReplace 속성에는 바꾸기 문자열이 포함됩니다.

xPosRole 및 xPosRoleReplace 을참조하세요 .


xPosRoleReplace : string

이 속성은 xPosRolePattern 와 함께 사용할 대체 콘텐츠를 정의합니다. 기본값은 빈 문자열입니다. 정규식을 사용한 검색 및 바꾸기 작동 방식에 대한 자세한 내용은 QString::replace(const QRegularExpression &rx, const QString &after) 함수 설명서를 참조하세요.

xPosRole 및 xPosRolePattern도 참조하세요 .


yPosRole : string

Y 위치에 매핑할 항목 모델 역할입니다.


yPosRolePattern : regExp

설정하면 Y 위치 역할에 매핑된 값이 항목 위치 값으로 사용되기 전에 검색 및 바꾸기가 수행됩니다. 이 속성은 매핑된 값에서 바꿀 부분을 찾기 위한 정규식을 지정하며 yPosRoleReplace 속성에는 바꾸기 문자열이 포함됩니다.

yPosRole 및 yPosRoleReplace 을참조하세요 .


yPosRoleReplace : string

이 속성은 yPosRolePattern 와 함께 사용할 대체 콘텐츠를 정의합니다. 기본값은 빈 문자열입니다. 정규식을 사용한 검색 및 바꾸기 작동 방식에 대한 자세한 내용은 QString::replace(const QRegularExpression &rx, const QString &after) 함수 설명서를 참조하세요.

yPosRole 및 yPosRolePattern도 참조하세요 .


zPosRole : string

Z 위치에 매핑할 항목 모델 역할입니다.


zPosRolePattern : regExp

설정하면 항목 위치 값으로 사용되기 전에 Z 위치 역할에 매핑된 값에 대해 검색 및 바꾸기가 수행됩니다. 이 속성은 매핑된 값에서 바꿀 부분을 찾기 위한 정규식을 지정하며 zPosRoleReplace 속성에는 바꾸기 문자열이 포함됩니다.

zPosRole 및 zPosRoleReplace 을참조하세요 .


zPosRoleReplace : string

이 속성은 zPosRolePattern 와 함께 사용할 대체 콘텐츠를 정의합니다. 기본값은 빈 문자열입니다. 정규식을 사용한 검색 및 바꾸기 작동 방식에 대한 자세한 내용은 QString::replace(const QRegularExpression &rx, const QString &after) 함수 설명서를 참조하세요.

zPosRole 와 zPosRolePattern도 참조하세요 .


신호 문서

itemModelChanged(model itemModel)

이 신호는 itemModel 가 itemModel 로 변경될 때 발생합니다.

참고: 해당 핸들러는 onItemModelChanged 입니다.


rotationRoleChanged(string role)

rotationRole 이 role 으로 변경될 때 이 신호가 발생합니다.

참고: 해당 핸들러는 onRotationRoleChanged 입니다.


rotationRolePatternChanged(regExp pattern)

rotationRolePattern 이 pattern 으로 변경될 때 이 신호가 전송됩니다.

참고: 해당 핸들러는 onRotationRolePatternChanged 입니다.


rotationRoleReplaceChanged(string replace)

rotationRoleReplace 이 replace 으로 변경될 때 이 신호가 전송됩니다.

참고: 해당 핸들러는 onRotationRoleReplaceChanged 입니다.


xPosRoleChanged(string role)

xPosRole 이 role 으로 변경될 때 이 신호가 전송됩니다.

참고: 해당 핸들러는 onXPosRoleChanged 입니다.


xPosRolePatternChanged(regExp pattern)

xPosRolePattern 이 pattern 으로 변경될 때 이 신호가 전송됩니다.

참고: 해당 핸들러는 onXPosRolePatternChanged 입니다.


xPosRoleReplaceChanged(string replace)

xPosRoleReplace 이 replace 으로 변경될 때 이 신호가 전송됩니다.

참고: 해당 핸들러는 onXPosRoleReplaceChanged 입니다.


yPosRoleChanged(string role)

yPosRole 이 role 으로 변경될 때 이 신호가 전송됩니다.

참고: 해당 핸들러는 onYPosRoleChanged 입니다.


yPosRolePatternChanged(regExp pattern)

yPosRolePattern 이 pattern 으로 변경될 때 이 신호가 전송됩니다.

참고: 해당 핸들러는 onYPosRolePatternChanged 입니다.


yPosRoleReplaceChanged(string replace)

yPosRoleReplace 이 replace 으로 변경될 때 이 신호가 전송됩니다.

참고: 해당 핸들러는 onYPosRoleReplaceChanged 입니다.


zPosRoleChanged(string role)

zPosRole 이 role 으로 변경될 때 이 신호가 전송됩니다.

참고: 해당 핸들러는 onZPosRoleChanged 입니다.


zPosRolePatternChanged(regExp pattern)

zPosRolePattern 이 pattern 으로 변경될 때 이 신호가 전송됩니다.

참고: 해당 핸들러는 onZPosRolePatternChanged 입니다.


zPosRoleReplaceChanged(string replace)

zPosRoleReplace 이 replace 으로 변경될 때 이 신호가 전송됩니다.

참고: 해당 핸들러는 onZPosRoleReplaceChanged 입니다.


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