ItemModelBarDataProxy QML Type

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

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

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

속성

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

상세 설명

이 유형을 사용하면 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: ["2010", "2011", "2012", "2013"]
    columnCategories: ["Oulu", "Rauma", "Helsinki", "Tampere"]
}

BarDataProxy 및 Qt Data Visualization 데이터 처리항목도 참조하십시오 .

속성 문서

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 : ItemModelBarDataProxy.MultiMatchBehavior

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

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

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

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