이 페이지에서

AreaSeries QML Type

데이터를 면적 차트로 표시합니다. 더 보기...

Import Statement: import QtCharts 2.12
In C++: QAreaSeries
Inherits:

AbstractSeries

Status: Deprecated

이 유형은 더 이상 권장되지 않습니다. 새로운 코드에서는 이 유형을 사용하지 않는 것을 강력히 권장합니다.

속성

신호

상세 설명

면적 시리즈는 정량적 데이터를 표시하는 데 사용됩니다. 이 시리즈는 선 시리즈를 기반으로 하며, 경계선 사이의 면적을 색상으로 강조 표시한다는 점에서 선 시리즈와 유사합니다. 상단 경계선( LineSeries ) 유형은 면적의 상단 경계를 정의합니다. 영역 차트는 기본적으로 플롯 영역의 하단을 하단 경계로 사용하여 그려집니다. 플롯 영역의 하단 대신 다른 선을 하단 경계로 지정할 수도 있습니다. 이 경우 AreaSeries는 두 개의 LineSeries 유형을 사용해야 합니다.

참고: 하한값이 상한값보다 큰 경우, ‘상한’과 ‘하한’이라는용어가 오해를 불러일으킬 수 있습니다. 중요한 점은 이 두 경계선 사이의 영역이 채워진다는 것입니다.

2000년부터 2011년까지 연도별 러시아, 스웨덴, 핀란드 출신 선수 수를 표시한 면적 차트

다음 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축입니다. axisX와 axisXTop 를 모두 정의하지 않으면, 시리즈에 값 축이 생성됩니다.

axisXTop 및 ValueAxis도 참조하십시오 .

axisXTop : AbstractAxis

차트 뷰 위에 그려진, 해당 시리즈에 사용되는 x축입니다.

참고: axisX 와 axisXTop 중 하나만 지정할수 있으며 , 둘 다 지정할 수는 없습니다.

axisX도 참조하십시오 .

axisY : AbstractAxis

시리즈에 사용되는 y축입니다. axisY와 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

데이터 포인트 레이블에 대한 클리핑을 정의합니다. 기본값은 True입니다. 클리핑이 활성화되면 플롯 영역 가장자리에 있는 레이블이 잘립니다.

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 `가 되고, 시리즈에서 멀어지면 ` false `가 됩니다.

이에 대응하는 신호 핸들러는 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.