SimpleLineChart

SimpleLineChart(심플 라인차트) 위젯은 숫자 값 목록을 꺾은선으로 그려 추세를 시각화하는 가벼운 라인 차트입니다.
주가·수치 변화처럼 흐름을 간단히 보여줄 때 사용합니다.

정의 / 역할

SimpleLineChart 위젯은 데이터 값 목록(dataList)을 받아 각 값을 점으로 잇는 선을 그립니다. 직선 또는 곡선(스플라인)으로 표현할 수 있고, 선 아래 영역 채움, 최소·최대 지점 강조, 등장 애니메이션을 지원합니다.

기능	설명
라인 그리기	`dataList`의 값을 점으로 이어 선을 그립니다. `lineColor`·`lineWidth`로 색과 두께를 정합니다.
곡선/직선 전환	`isSpline`을 켜면 부드러운 곡선으로, 끄면 직선으로 그립니다. (곡선은 점이 4개 이상일 때 적용)
영역 채움	`areaColor` 또는 `areaGradient`를 지정하면 선 아래 영역을 채웁니다.
최소·최대 표시	`showMinMax`를 켜면 데이터의 최소·최대 지점에 점과 텍스트(`minText`·`maxText`)를 표시합니다.
등장 애니메이션	`useAnimation`을 켜면 가운데 가로선에서 그래프가 펼쳐지는 애니메이션으로 나타납니다.
범위·여백 조정	`min`·`max`로 세로축 범위를, `topInset`·`bottomInset`으로 위·아래 여백을 조정합니다.

속성	설명	기본값	값 / 타입
`dataList`	차트에 그릴 숫자 값 목록. 각 값이 선의 한 점이 됩니다.	빈 목록	숫자 목록
`useAnimation`	등장 애니메이션 사용 여부	`false`	참/거짓
`showMinMax`	최소·최대 지점 강조 표시 여부	`false`	참/거짓
`minText`	최소 지점에 표시할 텍스트	미지정	문자열
`minColor`	최소 지점 점·텍스트 색	미지정 (파랑으로 표시)	색상
`maxText`	최대 지점에 표시할 텍스트	미지정	문자열
`maxColor`	최대 지점 점·텍스트 색	미지정 (빨강으로 표시)	색상
`isSpline`	곡선(스플라인)으로 그릴지 여부	`false`	참/거짓
`lineWidth`	선 두께	`1.0`	숫자 (0.1~10.0)
`lineColor`	선 색	`#FF0000` (빨강)	색상
`lineGradient`	선에 적용할 그라디언트 (지정 시 `lineColor` 대신 사용)	미지정	그라디언트
`areaColor`	선 아래 영역 채움 색	미지정	색상
`areaGradient`	선 아래 영역 채움 그라디언트	미지정	그라디언트
`topInset`	위쪽 여백 (차트 높이 대비 %)	미지정	숫자 (0~100)
`bottomInset`	아래쪽 여백 (차트 높이 대비 %)	미지정	숫자 (0~100)
`min`	세로축 최소값 (미지정 시 데이터 최소값으로 자동)	미지정	숫자
`max`	세로축 최대값 (미지정 시 데이터 최대값으로 자동)	미지정	숫자

경고

dataList가 비어 있으면 선이 그려지지 않습니다. 편집 화면에서는 SimpleLineChart 자리표시 상자만 보입니다.

팁

min·max를 지정하지 않으면 데이터의 최소·최대값을 기준으로 세로축이 자동 조정됩니다. isSpline 곡선은 점이 4개 이상일 때만 적용되며, 그보다 적으면 직선으로 그려집니다.

팁

이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 SimpleLineChart (심플 라인차트) Widget Control 문서에서 확인하세요.