Bars3D QML Type

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

Import Statement:	`import QtDataVisualization 1.8`
Since:	QtDataVisualization 1.0
Inherits:	AbstractGraph3D

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

속성

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 으로 이동됩니다.

참고: 시리즈를 이전 색인 뒤에 있는 새 index 로 이동하는 경우 목록에서 새 위치는 해당 시리즈가 여전히 이전 색인에 있는 것처럼 계산되므로 최종 색인은 실제로 1씩 줄어든 index 이 됩니다.

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

void removeSeries(Bar3DSeries series)

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

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

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.