Back to Qt.io
Contact Us Blog Download Qt

ChartView QML Type

차트의 계열, 범례 및 축의 그래픽 표현을 관리합니다. 더 보기...

Import Statement: import QtCharts 2.8
Inherited By:

PolarChartView

속성

신호

방법

상세 설명

차트뷰 유형은 다양한 계열 유형을 차트로 표시합니다.

이 예는 간단한 꺾은선형 차트를 만드는 방법을 보여줍니다:

ChartView {
    title: "Line Chart"
    anchors.fill: parent
    antialiasing: true

    LineSeries {
        name: "Line"
        XYPoint { x: 0; y: 0 }
        XYPoint { x: 1.1; y: 2.1 }
        XYPoint { x: 1.9; y: 3.3 }
        XYPoint { x: 2.1; y: 2.1 }
        XYPoint { x: 2.9; y: 4.9 }
        XYPoint { x: 3.4; y: 3.0 }
        XYPoint { x: 4.1; y: 3.3 }
    }
}

속성 문서

animationDuration : int

차트의 애니메이션 지속 시간입니다.


animationEasingCurve : easing

차트에 대한 애니메이션의 완화 곡선입니다.


animationOptions : enumeration

차트에서 활성화된 애니메이션입니다:

상수설명
ChartView.NoAnimation차트에서 애니메이션이 비활성화됩니다. 기본값입니다.
ChartView.GridAxisAnimations차트에서 그리드 축 애니메이션이 활성화됩니다.
ChartView.SeriesAnimations차트에서 시리즈 애니메이션이 활성화됩니다.
ChartView.AllAnimations차트에서 모든 애니메이션 유형이 활성화됩니다.

axes : list<AbstractAxis>

차트의 축입니다.


backgroundColor : color

차트 배경의 색상입니다. 기본적으로 배경색은 차트 테마에 의해 지정됩니다.

theme 를참조하세요 .


backgroundRoundness : real

차트 배경 모서리에 있는 둥근 원의 지름입니다.


count : int

차트에 추가된 시리즈 수입니다.


dropShadowEnabled : bool

배경 그림자 효과를 사용할지 여부입니다.

true 로 설정하면 배경 그림자 효과가 활성화됩니다. false 로 설정하면 비활성화됩니다.


legend : Legend

차트의 범례입니다. 범례에는 차트에 추가된 모든 시리즈, 파이 슬라이스 및 막대 세트가 나열됩니다.


locale : locale [since QtCharts 2.0]

다양한 차트 레이블 서식을 지정하는 데 사용되는 로캘입니다.

레이블은 localizeNumbers 가 true 일 때만 현지화되며, DateTimeAxis 레이블은 항상 이 속성으로 설정된 QLocale 을 사용합니다.

기본값은 차트가 생성될 당시의 애플리케이션 기본 로캘입니다.

이 속성은 QtCharts 2.0에 도입되었습니다.

localizeNumbers 를참조하십시오 .


localizeNumbers : bool [since QtCharts 2.0]

숫자의 현지화 여부.

true 로 설정하면 다양한 계열 및 축 레이블에 표시되는 모든 생성된 숫자는 locale 속성으로 설정된 QLocale 을 사용하여 현지화됩니다. false 인 경우 항상 C 로캘이 사용됩니다. 기본값은 false 입니다.

참고: 이 속성은 항상 로캘 속성과 함께 설정된 QLocale 을 사용하는 DateTimeAxis 레이블에는 영향을 미치지 않습니다.

이 속성은 QtCharts 2.0에 도입되었습니다.

locale 를참조하십시오 .


margins : Margins

차트 사각형의 가장자리와 그림 영역 사이에 허용되는 최소 여백입니다. 여백은 제목, 축 및 범례를 그리는 데 사용됩니다.


plotArea : rect

차트가 그려지는 사각형입니다.

그림 영역에는 여백으로 정의된 영역이 포함되지 않습니다. 기본적으로 ChartView 안에 있는 경우 크기가 조정됩니다. 플롯 영역에 명시적인 직사각형이 설정되어 있으면 이를 존중하고 기본 동작으로 되돌리려면 Qt.rect(0, 0, 0, 0) 으로 설정하면 됩니다.

margins 를참조하세요 .


plotAreaColor : color

차트 그림 영역의 배경색입니다. 기본적으로 플롯 영역 배경은 차트 테마에 지정된 차트의 배경색을 사용합니다.

backgroundColor 및 theme 을참조하세요 .


theme : enumeration

차트에서 사용하는 테마입니다.

테마는 색상, 펜, 브러시, 계열의 글꼴, 축, 제목, 범례 등 차트의 모든 시각적 요소에 적용되는 UI 스타일 관련 설정의 기본 제공 모음입니다. Qml 오실로스코프 예시에서는 테마를 설정하는 방법을 설명합니다.

참고: 테마를 변경하면 이전에 시리즈에 적용된 모든 사용자 지정을 덮어씁니다.

지원되는 값은 다음과 같습니다:

상수설명
ChartView.ChartThemeLight기본 테마인 밝은 테마.
ChartView.ChartThemeBlueCerulean청록색 테마.
ChartView.ChartThemeDark어두운 테마.
ChartView.ChartThemeBrownSand샌드 브라운 테마.
ChartView.ChartThemeBlueNcs자연색 시스템(NCS) 파란색 테마.
ChartView.ChartThemeHighContrast고대비 테마.
ChartView.ChartThemeBlueIcy아이스 블루 테마.
ChartView.ChartThemeQtQt 테마.

title : string

제목은 차트 상단에 헤드라인으로 표시됩니다. 차트 제목은 HTML 서식을 지원합니다.

titleColor 를참조하십시오 .


titleColor : color

제목 텍스트의 색상입니다.


titleFont : font

차트의 제목 글꼴입니다.

자세한 내용은 font 을 참조하세요.


신호 문서

seriesAdded(AbstractSeries series)

이 신호는 series 시리즈가 차트에 추가될 때 발산됩니다.

참고: 해당 핸들러는 onSeriesAdded 입니다.


seriesRemoved(AbstractSeries series)

이 신호는 차트에서 series 시리즈가 제거될 때 발생합니다. 신호 핸들러가 완료되면 시리즈 개체는 유효하지 않게 됩니다.

참고: 해당 핸들러는 onSeriesRemoved 입니다.


메서드 문서

Axis axisX(AbstractSeries series)

series.

setAxisX()도 참조하세요 .


Axis axisY(AbstractSeries series)

series 의 y 축입니다.

setAxisY()도 참조하십시오 .


AbstractSeries createSeries(enumeration type, string name, AbstractAxis axisX, AbstractAxis axisY)

이름 name 및 선택적으로 축 axisX 및 axisY 을 사용하여 차트에 type 유형의 계열을 추가합니다. 예를 들어

// lineSeries is a LineSeries object that has already been added to the ChartView; re-use its axes
var myAxisX = chartView.axisX(lineSeries);
var myAxisY = chartView.axisY(lineSeries);
var scatter = chartView.createSeries(ChartView.SeriesTypeScatter, "scatter series", myAxisX, myAxisY);

다음 열거형 값을 type 의 값으로 사용할 수 있습니다:

상수설명
ChartView.SeriesTypeLine선 시리즈.
ChartView.SeriesTypeArea면적 계열입니다.
ChartView.SeriesTypeBar막대 시리즈.
ChartView.SeriesTypeStackedBar누적 막대 시리즈입니다.
ChartView.SeriesTypePercentBar퍼센트 막대 시리즈.
ChartView.SeriesTypeBoxPlot박스 플롯 시리즈.
ChartView.SeriesTypeCandlestick촛대 시리즈.
ChartView.SeriesTypePie파이 시리즈.
ChartView.SeriesTypeScatter분산 계열.
ChartView.SeriesTypeSpline스플라인 계열.
ChartView.SeriesTypeHorizontalBar수평 막대 시리즈.
ChartView.SeriesTypeHorizontalStackedBar수평 누적 막대 시리즈.
ChartView.SeriesTypeHorizontalPercentBar가로 퍼센트 막대 시리즈입니다.

isZoomed()

시리즈에 확대/축소된 도메인이 있는 경우 true 를 반환합니다.


point mapToPosition(point value, AbstractSeries series)

series 시리즈에서 value 값의 차트 내 위치를 반환합니다.


point mapToValue(point position, AbstractSeries series)

차트에서 position 위치에 있는 series 계열의 값을 반환합니다.


removeAllSeries()

차트에서 모든 시리즈를 제거하고 모든 시리즈 개체를 영구적으로 삭제합니다.


removeSeries(AbstractSeries series)

차트에서 series 시리즈를 제거하고 시리즈 개체를 영구 삭제합니다.


scrollDown(real pixels)

pixels 에 지정된 픽셀 수만큼 아래로 스크롤합니다. 이 방법은 예를 들어 키 탐색에 적합한 편리한 방법입니다.


scrollLeft(real pixels)

pixels 에 지정된 픽셀 수만큼 왼쪽으로 스크롤합니다. 예를 들어 키 탐색에 적합한 편리한 방법입니다.


scrollRight(real pixels)

pixels 에 지정된 픽셀 수만큼 오른쪽으로 스크롤합니다. 예를 들어 키 탐색에 적합한 편리한 방법입니다.


scrollUp(real pixels)

pixels 에 지정된 픽셀 수만큼 위로 스크롤합니다. 예를 들어 키 탐색에 적합한 편리한 방법입니다.


AbstractSeries series(int index)

차트에 index 인덱스가 있는 계열을 반환합니다. 차트의 count 속성과 함께 사용하면 차트의 계열을 반복할 수 있습니다.

count도 참조하세요 .


AbstractSeries series(string name)

차트에서 이름이 name 인 첫 번째 계열을 반환합니다. 해당 이름의 계열이 없으면 null을 반환합니다.


setAxisX(AbstractAxis axis, AbstractSeries series)

series 의 x 축을 axis 으로 설정합니다.

axisX()도 참조하십시오 .


setAxisY(AbstractAxis axis, AbstractSeries series)

series 의 y 축을 axis 으로 설정합니다.

axisY()도 참조하세요 .


zoom(real factor)

사용자 지정 계수 factor 로 차트를 확대합니다.

1.0을 초과하는 배율은 뷰를 확대하고 0.0에서 1.0 사이의 배율은 뷰를 축소합니다.


zoomIn()

뷰를 2배로 확대합니다.


zoomIn(rect rectangle)

사각형 rectangle 이 여전히 완전히 표시되는 최대 수준까지 뷰를 확대합니다.

참고: 극좌표형 차트에는 이 기능이 지원되지 않습니다.


zoomOut()

뷰를 2배 축소합니다.

참고: 결과에 잘못된 로그 축 범위가 포함된 경우 아무 작업도 수행되지 않습니다.


zoomReset()

시리즈 도메인을 확대/축소 메서드를 호출하기 전의 상태로 초기화합니다.

참고: 첫 번째 확대/축소 작업과 이 메서드 호출 사이에 지정된 스크롤 및 명시적 축 범위 설정도 초기화됩니다. 확대/축소 작업이 수행되지 않은 경우 이 메서드는 아무 작업도 수행하지 않습니다.


© 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.