ItemModelSurfaceDataProxy QML Type

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

• 상속된 멤버를 포함한 모든 멤버 목록
• ItemModelSurfaceDataProxy는 Qt Graphs 의 3D용 QML 타입에 포함됩니다.

속성

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

신호

• autoColumnCategoriesChanged(bool enable)
• autoRowCategoriesChanged(bool enable)
• columnCategoriesChanged()
• columnRoleChanged(string role)
• columnRolePatternChanged(regExp pattern)
• columnRoleReplaceChanged(string replace)
• itemModelChanged(model itemModel)
• multiMatchBehaviorChanged(enumeration behavior)
• rowCategoriesChanged()
• rowRoleChanged(string role)
• rowRolePatternChanged(regExp pattern)
• rowRoleReplaceChanged(string replace)
• useModelCategoriesChanged(bool enable)
• xPosRoleChanged(string role)
• xPosRolePatternChanged(regExp pattern)
• xPosRoleReplaceChanged(string replace)
• yPosRoleChanged(string role)
• yPosRolePatternChanged(regExp pattern)
• yPosRoleReplaceChanged(string replace)
• zPosRoleChanged(string role)
• zPosRolePatternChanged(regExp pattern)
• zPosRoleReplaceChanged(string replace)

상세 설명

이 유형을 사용하면 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 Graphs 의 ‘3D 데이터 처리’항목도 참조하십시오 .

속성 설명서

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 : enumeration

각 행/열 조합에 대해 여러 개의 일치 항목이 있을 때 이를 어떻게 처리할지 정의합니다. 기본값은 ‘ ItemModelSurfaceDataProxy.MultiMatchBehavior.Last ’입니다.

예를 들어, 불규칙한 간격으로 수집된 타임스탬프 데이터가 포함된 항목 모델이 있고, 서피스 그래프를 사용하여 매 시간대별 데이터 항목의 평균 위치를 시각화하고자 할 수 있습니다. 이 경우, 각 서피스 점이 한 시간을 나타내도록 행 및 열 범주를 지정하고, multiMatchBehavior를 ItemModelSurfaceDataProxy.MultiMatchBehavior.Average 로 설정하면 됩니다.

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

type : AbstractDataProxy.DataType [read-only]

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

useModelCategories : bool

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

xPosRole : string

X 위치에 매핑할 항목 모델 역할입니다. 이 역할이 정의되지 않은 경우, ` columnRole `가 사용되어 해결된 ` QSurfaceDataItem ` 항목의 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 위치에 매핑할 항목 모델 역할입니다. 이 역할이 정의되지 않은 경우, ` rowRole `를 사용하여 해결된 ` QSurfaceDataItem ` 항목의 Z 좌표 값을 결정합니다.

zPosRolePattern : regExp

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

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

zPosRoleReplace : string

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

zPosRole 및 zPosRolePattern도 참조하십시오 .

신호(Signal) 문서

autoColumnCategoriesChanged(bool enable)

이 신호는 autoColumnCategories 이 enable 로 변경될 때 발생합니다.

autoRowCategoriesChanged(bool enable)

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

columnCategoriesChanged()

columnCategories 가 변경되면 이 신호가 발생합니다.

columnRoleChanged(string role)

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

columnRolePatternChanged(regExp pattern)

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

columnRoleReplaceChanged(string replace)

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

itemModelChanged(model itemModel)

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

multiMatchBehaviorChanged(enumeration behavior)

이 신호는 ‘ multiMatchBehavior ’가 ‘ behavior ’로 변경될 때 발생합니다.

rowCategoriesChanged()

rowCategories 가 변경되면 이 신호가 발생합니다.

rowRoleChanged(string role)

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

rowRolePatternChanged(regExp pattern)

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

rowRoleReplaceChanged(string replace)

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

useModelCategoriesChanged(bool enable)

이 신호는 useModelCategories 이 enable 로 변경될 때 발생합니다.

xPosRoleChanged(string role)

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

xPosRolePatternChanged(regExp pattern)

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

xPosRoleReplaceChanged(string replace)

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

yPosRoleChanged(string role)

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

yPosRolePatternChanged(regExp pattern)

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

yPosRoleReplaceChanged(string replace)

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

zPosRoleChanged(string role)

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

zPosRolePatternChanged(regExp pattern)

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

zPosRoleReplaceChanged(string replace)

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