Checkbox
Checkbox(체크박스) 위젯은 켜짐/꺼짐 두 상태를 오가는 선택 위젯입니다. 약관 동의, 여러 항목 다중 선택 등에 사용합니다.
정보
예제 파일: 07_Work_with_Widgets/checkbox_objet.lfp
정의 / 역할
Checkbox 위젯은 네모난 체크 영역을 그려주고, 누르면 체크/해제가 애니메이션과 함께 전환됩니다. 상태가 바뀌면 onChanged 동작이 실행됩니다. 크기·색·테두리를 설정할 수 있습니다.
- 카테고리: Contents (입력·선택)
- 기본 상태: 꺼짐(미체크)
기능
| 기능 | 설명 |
|---|---|
| 두 상태 토글 | 누르면 체크/해제가 전환됩니다(전환 애니메이션 포함). |
| 상태 변경 감지 | 상태가 바뀔 때 onChanged가 실행되며 바뀐 값을 전달합니다. |
| 모양 설정 | 크기·테두리·체크됨/미체크 배경색·체크 표시 색을 조정합니다. |
사용 방법
- 왼쪽 위젯 팔레트에서 Contents 카테고리를 엽니다.
- Checkbox 항목을 캔버스로 끌어다 놓습니다.
- 속성 패널에서 기본 상태(
value)와 크기·색을 설정합니다. onChanged에 상태가 바뀔 때 실행할 동작을 연결합니다.
속성 (Property)
| 속성 | 설명 | 기본값 | 값 / 타입 |
|---|---|---|---|
value | 체크 여부(초기 상태) | 꺼짐(false) | 참 / 거짓 |
size | 체크박스 크기 | 30 | 숫자(px) |
borderColor | 테두리 색 | #666666 | 색상 |
borderWidth | 테두리 두께 | 1 | 숫자(0 이상) |
borderRadius | 모서리 둥글기 | 0 | 숫자 |
activeColor | 체크됐을 때 배경색 | #00AAFF | 색상 |
inactiveColor | 체크 안 됐을 때 배경색 | #FFFFFF | 색상 |
checkColor | 체크 표시(✔) 색 | #FF0000 | 색상 |
unCheckColor | 미체크 표시 색 | 투명 | 색상 |
주의 / 팁
팁
onChanged에 연결한 동작은 바뀐 뒤의 상태값(참/거짓)을 전달받습니다.
팁
체크됐을 때 모양은 activeColor(배경)와 checkColor(✔ 표시)로 함께 조정합니다.
더 알아보기
팁
이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 Checkbox (체크박스) Widget Control 문서에서 확인하세요.