SimpleBarChart
SimpleBarChart(심플 바 차트) 위젯은 값 목록을 세로 막대로 그려 카테고리 간 크기를 한눈에 비교하게 해주는 가벼운 막대 차트입니다.
양수·음수를 함께 표시할 수 있고, 막대마다 색과 너비를 지정할 수 있습니다.
정의 / 역할
SimpleBarChart 위젯은 값(value)에 비례한 높이의 막대들을 나란히 그려줍니다. 막대별로 색·너비를 개별 지정할 수 있고, 기준선(0선) 방식을 골라 양수/음수 막대의 배치를 바꿀 수 있습니다.
- 카테고리: Contents
- 팔레트 항목 이름:
SimpleBar
기능
| 기능 | 설명 |
|---|---|
| 막대 데이터 | series에 값·색·너비를 가진 막대 목록을 넣어 막대를 그립니다. 스크립트로도 채울 수 있습니다. |
| 기준선 방식 | baseStyle로 0선 위치를 바닥(zero)·가운데(centerzero)·최소값 기준(min) 중에서 선택합니다. |
| 0선 표시 | drawZeroLine을 켜면 기준선을 가로선으로 그립니다. |
| 등장 애니메이션 | useAnimation을 켜면 막대가 0에서 자라나는 애니메이션을 재생합니다. |
| 간격·모서리 | spacing으로 막대 사이 간격을, radius·baseRadius로 막대 양 끝 모서리 둥글기를 조정합니다. |
| 그리기 여백 | topInset·bottomInset으로 위·아래 그리기 여백(%)을 지정합니다. |
사용 방법
- 왼쪽 위젯 팔레트에서 Contents 카테고리를 엽니다.
SimpleBar항목을 캔버스로 끌어다 놓습니다.- 오른쪽 속성 패널에서
series에 막대 데이터를 추가하거나, 스크립트로setListData·setStringData를 호출해 값을 채웁니다. - 필요하면
baseStyle·spacing·radius등으로 모양을 조정합니다.
노트
스크린샷 필요: 왼쪽 위젯 팔레트 Contents 카테고리의 SimpleBar 항목을 캔버스로 드래그하는 모습
속성 (Property)
| 속성 | 설명 | 기본값 | 값 / 타입 |
|---|---|---|---|
series | 막대 목록. 각 항목은 값(value)·색(color)·너비(width)를 가집니다. | 빈 목록 | 막대 데이터 목록 |
baseStyle | 기준선(0선) 방식 | zero | zero, centerzero, min |
drawZeroLine | 기준선을 가로선으로 표시 | false | 참 / 거짓 |
useAnimation | 등장 시 막대가 자라나는 애니메이션 사용 | false | 참 / 거짓 |
spacing | 막대 사이 간격 | 5 | 숫자 (0 이상) |
radius | 막대의 값 쪽 끝 모서리 둥글기 | 미지정 | 숫자 (0 이상) |
baseRadius | 막대의 기준선 쪽 끝 모서리 둥글기 | 미지정 | 숫자 (0 이상) |
topInset | 위쪽 그리기 여백 (%) | 미지정 | 숫자 (0~100) |
bottomInset | 아래쪽 그리기 여백 (%) | 미지정 | 숫자 (0~100) |
주의 / 팁
경고
series가 비어 있으면 편집 화면에서는 'SimpleBarChart' 안내 상자가 보이고, 실행 화면에서는 막대가 그려지지 않습니다. 데이터를 넣어야 차트가 나타납니다.
팁
radius나 baseRadius 중 하나라도 지정하면 막대가 둥근 모서리로 그려집니다. 둘 다 미지정이면 각진 사각형으로 그려집니다.
더 알아보기
팁
이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 SimpleBarChart (심플 바차트) Widget Control 문서에서 확인하세요.