AreaSeries QML Type
데이터를 영역 차트로 표시합니다. 더 보기...
| Import Statement: | import QtCharts 2.11 |
| In C++: | QAreaSeries |
| Inherits: |
속성
- axisAngular : AbstractAxis
- axisRadial : AbstractAxis
- axisX : AbstractAxis
- axisXTop : AbstractAxis
- axisY : AbstractAxis
- axisYRight : AbstractAxis
- borderColor : color
- borderWidth : real
- brush : brush
- brushFilename : string
- color : color
- lowerSeries : LineSeries
- pointLabelsClipping : bool
- pointLabelsColor : font
- pointLabelsFont : font
- pointLabelsFormat : string
- pointLabelsVisible : bool
- upperSeries : LineSeries
신호
- clicked(point point)
- doubleClicked(point point)
- hovered(point point, bool state)
- pressed(point point)
- released(point point)
상세 설명
면적 계열은 정량적 데이터를 표시하는 데 사용됩니다. 경계선 사이의 면적을 색상으로 강조하는 방식으로 선 계열을 기반으로 합니다. LineSeries 유형은 영역의 위쪽 경계를 정의합니다. 영역 차트는 기본적으로 플롯 영역의 하단을 하단 경계로 사용하여 그려집니다. 플롯 영역의 아래쪽 대신 다른 선으로 아래쪽 경계를 지정할 수 있습니다. 이 경우 AreaSeries는 두 개의 LineSeries 유형을 사용해야 합니다.
참고: 하한 경계 값이 상한 경계 값보다 큰 경우 상한 및 하한 경계라는 용어가 오해의 소지가 있을 수 있습니다. 요점은 이 두 경계선 사이의 영역이 채워진다는 것입니다.

다음 QML은 간단한 영역 차트를 만드는 방법을 보여줍니다:
ChartView { title: "NHL All-Star Team Players" anchors.fill: parent antialiasing: true // Define x-axis to be used with the series instead of default one ValueAxis { id: valueAxis min: 2000 max: 2011 tickCount: 12 labelFormat: "%.0f" } AreaSeries { name: "Russian" axisX: valueAxis upperSeries: LineSeries { XYPoint { x: 2000; y: 1 } XYPoint { x: 2001; y: 1 } XYPoint { x: 2002; y: 1 } XYPoint { x: 2003; y: 1 } XYPoint { x: 2004; y: 1 } XYPoint { x: 2005; y: 0 } XYPoint { x: 2006; y: 1 } XYPoint { x: 2007; y: 1 } XYPoint { x: 2008; y: 4 } XYPoint { x: 2009; y: 3 } XYPoint { x: 2010; y: 2 } XYPoint { x: 2011; y: 1 } } }
참고: 차트와 영역 계열에 동일한 선 계열을 추가하는 것은 지원되지 않습니다. 경계선으로 사용되는 계열은 영역 계열에 대해서만 정의해야 합니다.
속성 문서
axisAngular : AbstractAxis
극좌표 차트 뷰를 중심으로 그려지는 계열에 사용되는 각도 축입니다.
axisX 및 PolarChartView 을참조하십시오 .
axisRadial : AbstractAxis
극좌표 차트 뷰 내부에 그려지는 계열에 사용되는 방사형 축입니다.
axisY 및 PolarChartView 을참조하십시오 .
axisX : AbstractAxis
시리즈에 사용되는 x축입니다. 축X와 axisXTop 를 모두 정의하지 않으면 계열에 대한 값 축이 만들어집니다.
axisXTop : AbstractAxis
차트 뷰 위에 그려지는 시리즈에 사용되는 X축입니다.
참고: axisX 또는 axisXTop 중 하나만 제공할 수 있으며 둘 다 제공할 수는 없습니다.
axisX 를참조하세요 .
axisY : AbstractAxis
시리즈에 사용되는 Y축입니다. Y축과 axisYRight 축을 모두 정의하지 않으면 계열에 대한 값 축이 만들어집니다.
axisYRight 및 ValueAxis 을참조하세요 .
axisYRight : AbstractAxis
차트 보기에서 오른쪽에 그려지는 시리즈에 사용되는 Y축입니다.
참고: axisY 또는 axisYRight 중 하나만 제공할 수 있으며 둘 다 제공할 수는 없습니다.
axisY 를참조하세요 .
borderColor : color
시리즈의 선(펜) 색상입니다.
borderWidth : real
테두리 선의 너비입니다. 기본적으로 너비는 2.0입니다.
brush : brush
이 시리즈의 선을 그리는 데 사용되는 브러시입니다.
brushFilename : string
시리즈의 브러시 이미지로 사용되는 파일의 이름입니다.
color : color
시리즈의 채우기(브러시) 색상을 선택합니다.
lowerSeries : LineSeries [read-only]
영역 계열 경계를 정의하는 데 사용되는 두 개의 선 계열 중 아래쪽 계열입니다.
참고: AreaSeries 가 lowerSeries 없이 구성된 경우 이 값은 null입니다.
pointLabelsClipping : bool
데이터 요소 레이블의 클리핑을 정의합니다. 기본적으로 참입니다. 클리핑이 활성화되면 플롯 영역의 가장자리에 있는 레이블이 잘립니다.
pointLabelsVisible 를참조하십시오 .
pointLabelsColor : font
데이터 포인트 레이블에 사용되는 색상을 정의합니다. 기본적으로 색상은 테마에서 레이블에 정의된 브러시 색상입니다.
pointLabelsFormat 을참조하세요 .
pointLabelsFont : font
데이터 포인트 레이블에 사용되는 글꼴을 정의합니다.
pointLabelsFormat도 참조하세요 .
pointLabelsFormat : string
계열점이 있는 레이블을 표시하는 데 사용되는 형식입니다.
QAreaSeries::pointLabelsFormat, pointLabelsVisible, pointLabelsFont, pointLabelsColor도 참조하세요 .
pointLabelsVisible : bool
데이터 포인트 레이블의 가시성을 정의합니다.
pointLabelsFormat 및 pointLabelsClipping 을참조하세요 .
upperSeries : LineSeries [read-only]
영역 계열 경계를 정의하는 데 사용되는 두 개의 선 계열 중 위쪽 계열입니다.
신호 문서
clicked(point point)
이 신호는 사용자가 영역 차트에서 point 을 클릭하여 누르면 발생합니다.
해당 신호 핸들러는 onClicked 입니다.
참고: 해당 핸들러는 onClicked 입니다.
pressed, released, doubleClicked도 참조하세요 .
doubleClicked(point point)
이 신호는 사용자가 영역 차트에서 point 을 두 번 클릭하여 첫 번째 프레스를 트리거할 때 발생합니다.
해당 신호 핸들러는 onDoubleClicked 입니다.
참고: 해당 핸들러는 onDoubleClicked 입니다.
pressed, released, clicked도 참조하십시오 .
hovered(point point, bool state)
이 신호는 사용자가 마우스 커서를 시리즈 위로 가져가거나 시리즈에서 멀어질 때 발생합니다. point 은 호버 이벤트의 원점(좌표)을 보여줍니다. state 은 커서가 시리즈 위로 가져가면 true 이 되고 시리즈에서 멀어지면 거짓으로 바뀝니다.
해당 신호 핸들러는 onHovered 입니다.
참고: 해당 핸들러는 onHovered 입니다.
pressed(point point)
이 신호는 사용자가 영역 차트에서 point 에 지정된 지점을 누르면 발산됩니다.
해당 신호 핸들러는 onPressed 입니다.
참고: 해당 핸들러는 onPressed 입니다.
clicked, released, doubleClicked도 참조하세요 .
released(point point)
이 신호는 사용자가 영역 차트에서 point 에서 트리거된 프레스를 놓을 때 발생합니다.
해당 신호 핸들러는 onReleased 입니다.
참고: 해당 핸들러는 onReleased 입니다.
pressed, clicked, doubleClicked도 참조하세요 .
© 2026 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.