ItemModelBarDataProxy QML Type

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

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

속성

• autoColumnCategories : bool
• autoRowCategories : bool
• columnCategories : list<String>
• columnRole : string
• columnRolePattern : regExp
• columnRoleReplace : string
• itemModel : model
• multiMatchBehavior : enumeration
• rotationRole : string
• rotationRolePattern : regExp
• rotationRoleReplace : string
• rowCategories : list<String>
• rowRole : string
• rowRolePattern : regExp
• rowRoleReplace : string
• type : AbstractDataProxy.DataType
• useModelCategories : bool
• valueRole : string
• valueRolePattern : regExp
• valueRoleReplace : string

신호

• autoColumnCategoriesChanged(bool enable)
• autoRowCategoriesChanged(bool enable)
• columnCategoriesChanged()
• columnRoleChanged(string role)
• columnRolePatternChanged(regExp pattern)
• columnRoleReplaceChanged(string replace)
• itemModelChanged(model itemModel)
• multiMatchBehaviorChanged(enumeration behavior)
• rotationRoleChanged(string role)
• rotationRolePatternChanged(regExp pattern)
• rotationRoleReplaceChanged(string replace)
• rowCategoriesChanged()
• rowRoleChanged(string role)
• rowRolePatternChanged(regExp pattern)
• rowRoleReplaceChanged(string replace)
• useModelCategoriesChanged(bool enable)
• valueRoleChanged(string role)
• valueRolePatternChanged(regExp pattern)
• valueRoleReplaceChanged(string replace)

상세 설명

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

매핑이나 모델이 변경될 때마다 데이터가 비동기적으로 해결됩니다. 데이터가 해결되면 QBarDataProxy::arrayReset()가 호출됩니다.

ItemModelBarDataProxy 열거형에 대해서는 QItemModelBarDataProxy::MultiMatchBehavior 를 참조하십시오.

자세한 내용은 QItemModelBarDataProxy 문서를 참조하십시오.

사용 예:

ItemModelBarDataProxy {
    itemModel: model // E.g. a list model defined elsewhere containing yearly expenses data.
    // Mapping model roles to bar series rows, columns, and values.
    rowRole: "year"
    columnRole: "city"
    valueRole: "expenses"
    rowCategories: ["2020", "2021", "2022", "2023"]
    columnCategories: ["Oulu", "Rauma", "Helsinki", "Tampere"]
}

BarDataProxy 및 Qt Graphs 3D를 이용한 데이터 처리항목도 참조하십시오 .

속성 문서

autoColumnCategories : bool

true 로 설정하면, 매핑은 명시적으로 설정된 열 범주를 모두 무시하고, 모델의 데이터가 해결될 때마다 자동으로 생성된 범주로 덮어씁니다. 기본값은 true 입니다.

autoRowCategories : bool

true 로 설정하면, 매핑은 명시적으로 설정된 행 범주를 무시하고 모델의 데이터가 해결될 때마다 자동으로 생성된 범주로 덮어씁니다. 기본값은 true 입니다.

columnCategories : list<String>

매핑의 열 범주입니다. 데이터가 처리될 때 이 목록에 포함된 열 역할 값을 가진 항목만 포함됩니다. 열은 이 목록에 나열된 순서대로 정렬됩니다.

columnRole : string

열 범주에 매핑할 항목 모델 역할.

columnRolePattern : regExp

이 속성이 설정되면, 값이 열 범주로 사용되기 전에 열 역할에 따라 매핑된 값에 대해 검색 및 치환 작업이 수행됩니다. 이 속성은 매핑된 값에서 치환할 부분을 찾기 위한 정규식을 지정하며, ` columnRoleReplace ` 속성에는 치환할 문자열이 포함됩니다. 이는 예를 들어, 항목 모델의 단일 타임스탬프 필드에서 행 및 열 범주를 파싱할 때 유용합니다.

columnRole 및 columnRoleReplace도 참조하십시오 .

columnRoleReplace : string

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

columnRole 및 columnRolePattern도 참조하십시오 .

itemModel : model

항목 모델.

multiMatchBehavior : enumeration

각 행/열 조합에 대해 여러 개의 일치 항목이 있을 때 이를 어떻게 처리할지 정의합니다. 기본값은 ‘ ItemModelBarDataProxy.MultiMatchBehavior.Last ’입니다. 선택한 동작은 막대의 값과 회전 모두에 영향을 미칩니다.

예를 들어, 불규칙한 간격으로 수집된 타임스탬프 데이터가 포함된 항목 모델이 있고, 각 날짜별 데이터 항목의 총합을 막대 그래프로 시각화하고 싶을 수 있습니다. 이 경우 각 막대가 하루를 나타내도록 행 및 열 범주를 지정하고, multiMatchBehavior를 ItemModelBarDataProxy.MultiMatchBehavior.Cumulative 로 설정하면 됩니다.

rotationRole : string

막대의 회전 각도로 매핑할 항목 모델 역할.

rotationRolePattern : regExp

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

rotationRole 및 rotationRoleReplace도 참조하십시오 .

rotationRoleReplace : string

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

rotationRole 및 rotationRolePattern도 참조하십시오 .

rowCategories : list<String>

매핑의 행 범주입니다. 데이터가 해결될 때 이 목록에 포함된 행 역할 값을 가진 항목만 포함됩니다. 행은 이 목록에 나열된 순서대로 정렬됩니다.

rowRole : string

행 범주에 매핑할 항목 모델 역할.

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

valueRole : string

막대 그래프 값에 매핑할 항목 모델 역할.

valueRolePattern : regExp

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

valueRole 및 valueRoleReplace항목도 참조하십시오 .

valueRoleReplace : string

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

valueRole 및 valueRolePattern도 참조하십시오 .

신호(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 로 변경될 때 발생합니다.

rotationRoleChanged(string role)

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

rotationRolePatternChanged(regExp pattern)

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

rotationRoleReplaceChanged(string replace)

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

rowCategoriesChanged()

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

rowRoleChanged(string role)

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

rowRolePatternChanged(regExp pattern)

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

rowRoleReplaceChanged(string replace)

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

useModelCategoriesChanged(bool enable)

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

valueRoleChanged(string role)

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

valueRolePatternChanged(regExp pattern)

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

valueRoleReplaceChanged(string replace)

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