ItemModelSurfaceDataProxy QML Type

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

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

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• autoColumnCategories : bool
• autoRowCategories : bool
• columnCategories : list<String>
• columnRole : string
• columnRolePattern : regExp
• columnRoleReplace : string
• itemModel : model
• multiMatchBehavior : ItemModelSurfaceDataProxy.MultiMatchBehavior
• rowCategories : list<String>
• rowRole : string
• rowRolePattern : regExp
• rowRoleReplace : string
• useModelCategories : bool
• xPosRole : string
• xPosRolePattern : regExp
• xPosRoleReplace : string
• yPosRole : string
• yPosRolePattern : regExp
• yPosRoleReplace : string
• zPosRole : string
• zPosRolePattern : regExp
• zPosRoleReplace : string

상세 설명

이 유형을 사용하면 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도 참조하십시오 .