Back to Qt.io
Contact Us Blog Download Qt

ItemModelSurfaceDataProxy QML Type

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

Import Statement: import QtDataVisualization 1.8
Since: QtDataVisualization 1.0
In C++: QItemModelSurfaceDataProxy
Inherits:

SurfaceDataProxy

속성

상세 설명

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

데이터는 매핑 또는 모델이 변경될 때마다 비동기적으로 확인됩니다.

ItemModelSurfaceDataProxy 열거형에 대해서는 QItemModelSurfaceDataProxy::MultiMatchBehavior 을 참조하세요.

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

사용 예제:

ItemModelSurfaceDataProxy {
    itemModel: model // E.g. a list model defined elsewhere containing population data.
    // Mapping model roles to surface series rows, columns, and values.
    rowRole: "longitude"
    columnRole: "latitude"
    valueRole: "pop_density"
}

SurfaceDataProxy 및 Qt Data Visualization 데이터 처리도참조하세요 .

속성 문서

autoColumnCategories : bool

true 로 설정하면 매핑은 명시적으로 설정된 열 범주를 무시하고 모델에서 데이터가 확인될 때마다 자동으로 생성된 열 범주로 덮어씁니다. true 으로 설정하면 프록시 최소 및 최대 열 값도 데이터에서 자동 생성됩니다. 기본값은 true 입니다.


autoRowCategories : bool

true 으로 설정하면 매핑은 명시적으로 설정된 모든 행 범주를 무시하고 모델의 데이터가 확인될 때마다 자동으로 생성된 범주로 덮어씁니다. true 으로 설정하면 프록시 최소 및 최대 행 값도 데이터에서 자동 생성됩니다. 기본값은 true 입니다.


columnCategories : list<String>

매핑의 열 범주. 이 목록에 있는 열 역할이 있는 항목만 데이터가 확인될 때 포함됩니다. 열은 이 목록에 있는 것과 동일한 순서로 정렬됩니다.


columnRole : string

열 범주에 매핑할 항목 모델 역할입니다. 데이터가 속한 열을 정의하는 것 외에도 열 역할이 나타내는 값은 별도의 x 위치 역할도 정의하지 않는 한 모델 데이터가 확인될 때 QSurfaceDataItem 의 x 좌표 값으로 설정됩니다.


columnRolePattern : regExp

이 속성을 설정하면 열 역할에 의해 매핑된 값에 대해 검색 및 바꾸기가 수행된 후 열 범주로 사용됩니다. 이 속성은 매핑된 값에서 바꿀 부분을 찾기 위한 정규식을 지정하며 columnRoleReplace 속성에는 바꾸기 문자열이 포함됩니다.

columnRole 및 columnRoleReplace 을참조하세요 .


columnRoleReplace : string

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

columnRole 및 columnRolePattern도 참조하세요 .


itemModel : model

Surface3D 의 데이터 소스로 사용되는 항목 모델.


multiMatchBehavior : ItemModelSurfaceDataProxy.MultiMatchBehavior

각 행/열 조합에 대한 다중 일치가 처리되는 방식을 정의합니다. 기본값은 ItemModelSurfaceDataProxy.MMBLast 입니다.

예를 들어, 불규칙한 간격으로 타임스탬프가 찍힌 데이터가 있는 항목 모델이 있고 각 시간에 대한 데이터 항목의 평균 위치를 표면 그래프로 시각화하려고 할 수 있습니다. 각 서페이스 포인트가 한 시간을 나타내도록 행 및 열 범주를 지정하고 multiMatchBehavior를 ItemModelSurfaceDataProxy.MMBAverage 로 설정하면 됩니다.


rowCategories : list<String>

매핑의 행 범주. 이 목록에 있는 행 역할이 있는 항목만 데이터가 확인될 때 포함됩니다. 행은 이 목록에 있는 것과 동일한 순서로 정렬됩니다.


rowRole : string

행 범주에 매핑할 항목 모델 역할입니다. 데이터가 속한 행을 정의하는 것 외에도 행 역할이 나타내는 값은 별도의 z 위치 역할도 정의하지 않는 한 모델 데이터가 확인될 때 QSurfaceDataItem 의 Z 좌표 값으로 설정됩니다.


rowRolePattern : regExp

이 속성을 설정하면 행 역할에 매핑된 값에 대해 검색 및 바꾸기가 수행된 후 행 카테고리로 사용됩니다. 이 속성은 매핑된 값에서 바꿀 부분을 찾기 위한 정규식을 지정하며 rowRoleReplace 속성에는 바꾸기 문자열이 포함됩니다.

rowRole 및 rowRoleReplace 을참조하세요 .


rowRoleReplace : string

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

rowRole 및 rowRolePattern도 참조하세요 .


useModelCategories : bool

true 로 설정하면 매핑은 행과 열 역할 및 카테고리를 무시하고 대신 모델의 행과 열을 사용합니다. 기본값은 false 입니다.


xPosRole : string

X 위치에 매핑할 항목 모델 역할입니다. 이 역할을 정의하지 않으면 columnRole 을 사용하여 확인된 QSurfaceDataItem 항목의 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 위치에 매핑할 항목 모델 역할입니다. 이 역할이 정의되어 있지 않으면 rowRole 을 사용하여 확인된 QSurfaceDataItem 항목의 Z 좌표 값을 결정합니다.


zPosRolePattern : regExp

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

zPosRole 및 zPosRoleReplace 을참조하세요 .


zPosRoleReplace : string

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

zPosRole 및 zPosRolePattern도 참조하세요 .


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