이 페이지에서

ItemModelScatterDataProxy QML Type

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

Import Statement: import QtDataVisualization 1.12
Since: QtDataVisualization 1.0
In C++: QItemModelScatterDataProxy
Inherits:

ScatterDataProxy

Status: Deprecated

이 유형은 더 이상 사용되지 않습니다. 새로운 코드에서는 이 유형을 사용하지 않는 것을 강력히 권장합니다.

속성

상세 설명

이 유형을 사용하면 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 Data Visualization 데이터 처리를참조하십시오 .

속성 문서

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도 참조하십시오 .

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도 참조하십시오 .

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