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)

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

AbstractGraph3D::hasSeries()도 참조하십시오 .

void removeSeries(Bar3DSeries series)

그래프에서 ‘ series ’를 제거하십시오.

AbstractGraph3D::hasSeries()항목도 참조하십시오 .