이 페이지에서

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

항목 회전(rotation)에 매핑될 항목 모델 역할입니다. 모델은 회전 값을 ` quaternion`로 직접 변환 가능한 변형(variant) 형태로 제공하거나, ` "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도 참조하십시오 .

scaleRole : string

모델은 scale 값을 "x,y,z" 형태의 변형으로 제공할 수 있습니다. 첫 번째 방법은 주어진 값을 사용하여 vector3d를 직접 생성합니다.

scaleRolePattern : regExp

이 속성이 설정되면, 값이 항목 눈금으로 사용되기 전에 스케일 역할에 의해 매핑된 값에 대해 검색 및 치환 작업이 수행됩니다. 이 속성은 매핑된 값 중에서 치환할 부분을 찾는 정규식을 지정하며, ` scaleRoleReplace ` 속성에는 치환할 문자열이 포함됩니다.

scaleRole 및 scaleRoleReplace도 참조하십시오 .

scaleRoleReplace : string

이 속성은 scaleRolePattern 와 함께 사용될 대체 내용을 정의합니다. 기본값은 빈 문자열입니다. 정규식을 사용한 검색 및 대체가 어떻게 작동하는지에 대한 자세한 내용은 QString::replace(const QRegularExpression &rx, const QString &after) 함수 문서를 참조하십시오.

scaleRole 및 scaleRolePattern도 참조하십시오 .

type : AbstractDataProxy.DataType [read-only]

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

xPosRole : string

X 좌표에 매핑할 항목 모델 역할.

xPosRolePattern : regExp

이 속성이 설정되면, x-position 역할에 의해 매핑된 값이 항목 위치 값으로 사용되기 전에 해당 값에 대해 검색 및 치환 작업이 수행됩니다. 이 속성은 매핑된 값 중에서 치환할 부분을 찾기 위한 정규식을 지정하며, xPosRoleReplace 속성에는 치환할 문자열이 포함됩니다.

xPosRole 및 xPosRoleReplace도 참조하십시오 .

xPosRoleReplace : string

이 속성은 ` xPosRolePattern`와 함께 사용될 대체 내용을 정의합니다. 기본값은 빈 문자열입니다. 정규식을 사용한 검색 및 대체 기능이 어떻게 작동하는지에 대한 자세한 내용은 ` QString::replace(const QRegularExpression &rx, const QString &after)` 함수 설명서를 참조하십시오.

xPosRole 및 xPosRolePattern도 참조하십시오 .

yPosRole : string

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

yPosRolePattern : regExp

이 속성이 설정되면, y-position 역할에 의해 매핑된 값이 항목 위치 값으로 사용되기 전에 검색 및 치환 작업이 수행됩니다. 이 속성은 매핑된 값에서 치환할 부분을 찾기 위한 정규식을 지정하며, ` yPosRoleReplace ` 속성에는 치환할 문자열이 포함됩니다.

yPosRole 및 yPosRoleReplace도 참조하십시오 .

yPosRoleReplace : string

이 속성은 ` yPosRolePattern`와 함께 사용될 대체 내용을 정의합니다. 기본값은 빈 문자열입니다. 정규식을 사용한 검색 및 대체 기능이 어떻게 작동하는지에 대한 자세한 내용은 ` QString::replace(const QRegularExpression &rx, const QString &after)` 함수 설명서를 참조하십시오.

yPosRole 및 yPosRolePattern도 참조하십시오 .

zPosRole : string

Z 위치에 매핑할 아이템 모델의 역할입니다.

zPosRolePattern : regExp

이 속성이 설정되면, z-position 역할에 매핑된 값이 항목 위치 값으로 사용되기 전에 해당 값에 대해 검색 및 치환 작업이 수행됩니다. 이 속성은 매핑된 값에서 치환할 부분을 찾기 위한 정규식을 지정하며, ` zPosRoleReplace ` 속성에는 치환할 문자열이 포함됩니다.

zPosRole 및 zPosRoleReplace항목도 참조하십시오 .

zPosRoleReplace : string

이 속성은 zPosRolePattern 와 함께 사용될 대체 내용을 정의합니다. 기본값은 빈 문자열입니다. 정규식을 사용한 검색 및 대체 기능이 어떻게 작동하는지에 대한 자세한 내용은 QString::replace(const QRegularExpression &rx, const QString &after) 함수 설명서를 참조하십시오.

zPosRole 및 zPosRolePattern도 참조하십시오 .

신호(Signal) 문서

itemModelChanged(model itemModel)

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

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

rotationRoleChanged(string role)

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

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

rotationRolePatternChanged(regExp pattern)

이 신호는 rotationRolePattern 이 pattern 로 변경될 때 발생합니다.

참고: 이에 대응하는핸들러는 onRotationRolePatternChanged 입니다.

rotationRoleReplaceChanged(string replace)

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

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

scaleRoleChanged(string role)

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

참고: 이에 해당하는핸들러는 onScaleRoleChanged 입니다.

scaleRolePatternChanged(regExp pattern)

이 신호는 scaleRolePattern 이 pattern 로 변경될 때 발생합니다.

참고: 이에 해당하는핸들러는 onScaleRolePatternChanged 입니다.

scaleRoleReplaceChanged(string replace)

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

참고: 이에 대응하는핸들러는 onScaleRoleReplaceChanged 입니다.

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 입니다.

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