Bars3D QML Type

3D 막대 그래프. 더 보기...

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

속성

• barSeriesMargin : size (since 6.3)
• barSpacing : size
• barSpacingRelative : bool
• barThickness : real
• columnAxis : CategoryAxis3D
• floorLevel : real
• multiSeriesUniform : bool
• primarySeries : Bar3DSeries
• rowAxis : CategoryAxis3D
• selectedSeries : Bar3DSeries
• seriesList : list<Bar3DSeries>
• valueAxis : ValueAxis3D

방법

• void addSeries(Bar3DSeries series)
• void insertSeries(int index, Bar3DSeries series)
• void removeSeries(Bar3DSeries series)

상세 설명

이 유형을 사용하면 개발자가 Qt Quick 를 사용하여 막대 그래프를 3D로 렌더링할 수 있습니다.

이 유형을 사용하려면 데이터 시각화 모듈을 가져와야 합니다:

import QtDataVisualization 1.2

그런 다음 qml 파일에서 Bars3D를 사용할 수 있습니다:

import QtQuick 2.0
import QtDataVisualization 1.2

Item {
    width: 640
    height: 480

    Bars3D {
        width: parent.width
        height: parent.height

        Bar3DSeries {
            itemLabelFormat: "@colLabel, @rowLabel: @valueLabel"

            ItemModelBarDataProxy {
                itemModel: dataModel
                // Mapping model roles to bar series rows, columns, and values.
                rowRole: "year"
                columnRole: "city"
                valueRole: "expenses"
            }
        }
    }

    ListModel {
        id: dataModel
        ListElement{ year: "2012"; city: "Oulu";     expenses: "4200"; }
        ListElement{ year: "2012"; city: "Rauma";    expenses: "2100"; }
        ListElement{ year: "2012"; city: "Helsinki"; expenses: "7040"; }
        ListElement{ year: "2012"; city: "Tampere";  expenses: "4330"; }
        ListElement{ year: "2013"; city: "Oulu";     expenses: "3960"; }
        ListElement{ year: "2013"; city: "Rauma";    expenses: "1990"; }
        ListElement{ year: "2013"; city: "Helsinki"; expenses: "7230"; }
        ListElement{ year: "2013"; city: "Tampere";  expenses: "4650"; }
    }
}

자세한 사용 예는 간단한 막대 그래프를 참조하세요.

Bar3DSeries, ItemModelBarDataProxy, Scatter3D, Surface3D, 및 Qt Data Visualization C++ Classes.

속성 문서

barSeriesMargin : size [since 6.3]

X 및 Z 차원의 계열 열 사이의 여백입니다. 기본적으로 (0.0, 0.0) 로 사전 설정되어 있습니다. 적절한 값은 [0,1) 범위입니다.

이 프로퍼티는 Qt 6.3에 도입되었습니다.

barSpacing : size

X 및 Z 치수의 막대 간격.

기본적으로 (1.0, 1.0) 로 사전 설정됩니다. 간격은 barSpacingRelative 속성의 영향을 받습니다.

barSpacingRelative : bool

간격이 절대적인지 막대 두께에 상대적인지 여부.

true 값이 0.0 인 경우 막대가 좌우로 배치됨을 의미하며, 1.0 는 막대 사이에 막대 한 개 두께만큼의 공간이 남는다는 의미입니다. true 로 사전 설정합니다.

barThickness : real

X와 Z 치수 사이의 막대 두께 비율입니다. 1.0 값은 막대가 너비만큼 깊다는 것을 의미하며, 0.5 값은 너비보다 두 배 깊다는 것을 의미합니다.

columnAxis : CategoryAxis3D

활성 열 축입니다.

축을 지정하지 않으면 레이블이 없는 임시 기본 축이 생성됩니다. 이 임시 축은 다른 축이 명시적으로 같은 방향으로 설정되어 있으면 삭제됩니다.

floorLevel : real

Y축 데이터 좌표의 막대 그래프에 대한 바닥 레벨입니다.

실제 바닥 레벨은 Y축의 최소값과 최대값에 의해 제한됩니다. 기본값은 0입니다.

multiSeriesUniform : bool

여러 계열이 표시되는 경우에도 단일 계열 막대로 비율을 설정하여 막대 배율을 조정할지 여부를 정의합니다. true 로 설정하면 bar spacing 이 X축에만 올바르게 적용됩니다. 기본값은 false 으로 설정되어 있습니다.

primarySeries : Bar3DSeries

그래프의 기본 계열입니다. 축에 레이블이 명시적으로 설정되어 있지 않은 경우 행 및 열 축 레이블을 결정하는 데 사용됩니다.

지정된 계열이 아직 그래프에 추가되지 않은 경우, 주 계열로 설정하면 암시적으로 그래프에 추가됩니다.

기본 계열 자체가 그래프에서 제거되면 이 속성은 기본값으로 재설정됩니다.

계열이 null인 경우 이 속성은 기본값으로 재설정됩니다. 기본값은 처음 추가된 계열이며, 그래프에 계열이 추가되지 않은 경우 0이 됩니다.

rowAxis : CategoryAxis3D

활성 행 축입니다.

축을 지정하지 않으면 레이블이 없는 임시 기본 축이 생성됩니다. 이 임시 축은 다른 축이 명시적으로 같은 방향으로 설정되어 있으면 파괴됩니다.

selectedSeries : Bar3DSeries

선택한 시리즈 또는 null. selectionMode 에 SelectionMultiSeries 플래그가 설정된 경우, 이 속성은 선택한 막대를 소유한 시리즈를 보유합니다.

seriesList : list<Bar3DSeries> [default]

그래프의 계열입니다. 기본적으로 이 속성에는 빈 목록이 포함됩니다. 계열을 설정하려면 addSeries() 함수를 사용하거나 그래프의 하위 항목으로 정의합니다.

valueAxis : ValueAxis3D

활성 값 축입니다.

축을 지정하지 않으면 레이블이 없고 자동으로 조정되는 범위가 있는 임시 기본 축이 생성됩니다. 이 임시 축은 다른 축이 명시적으로 같은 방향으로 설정되면 파괴됩니다.

메서드 문서

void addSeries(Bar3DSeries series)

그래프에 series 을 추가합니다. 그래프에는 여러 계열이 포함될 수 있지만 축은 한 세트만 있으므로 시각화된 데이터가 의미가 있으려면 모든 계열의 행과 열이 일치해야 합니다. 그래프에 표시되는 계열이 여러 개인 경우, 축에 라벨이 명시적으로 설정되어 있지 않은 경우에는 처음 추가된 계열만 축에 행 또는 열 라벨을 생성합니다. 새로 추가된 계열에 선택된 막대가 지정되어 있는 경우 해당 막대가 강조 표시되고 기존 선택 항목은 모두 지워집니다. 추가된 시리즈는 하나만 활성 선택 항목을 가질 수 있습니다.

AbstractGraph3D::hasSeries()도 참조하세요 .

void insertSeries(int index, Bar3DSeries series)

시리즈 목록의 index 위치에 series 을 삽입합니다. series 이 이미 목록에 추가된 경우 새 index 으로 이동됩니다.

AbstractGraph3D::hasSeries()도 참조하세요 .

void removeSeries(Bar3DSeries series)

그래프에서 series 을 제거합니다.

AbstractGraph3D::hasSeries()도 참조하세요 .