본문으로 건너뛰기

Checkbox (체크박스) Widget Control

정보

예제 파일: 07_Work_with_Widgets/checkbox_objet.lfp

Checkbox(체크박스) 위젯을 스크립트에서 제어할 때 사용하는 Widget Control(Property · Method · Event) 목록입니다. 위젯 소개와 사용법은 Checkbox 문서를 참고하세요.

정보

아래 예시의 checkboxID는 캔버스에서 Checkbox 위젯에 지정한 이름(ID)입니다. 스크립트에서는 위젯ID.멤버 형태로 접근합니다.

Widget Control 요약​

Widget Control종류시그니처설명
checkPropertyboolean (읽기/쓰기)현재 체크 상태
onChangedEventonChanged = (value) => { ... }체크 상태가 바뀔 때 실행

Property​

check​

현재 체크 상태입니다. true면 체크된 상태입니다. 읽기와 쓰기가 모두 가능합니다.

  • 타입: boolean
  • 접근: 읽기 / 쓰기

Example

// 체크된 상태로 변경하기
checkboxID.check = true;

// 현재 상태 읽기
const isChecked = checkboxID.check;

Method​

정보

해당 없음 - Checkbox 위젯에는 전용 Method가 없습니다. 아래 공통 Widget Control을 사용합니다.

Event​

onChanged​

체크 상태가 바뀔 때 실행됩니다.

  • 종류: Event
  • 핸들러 인자
    • value (boolean): 바뀜 뒤의 체크 상태 (true면 체크됨)
  • Returns: 없음

Example

checkboxID.onChanged = (value) => {
  // value: 바뀜 체크 상태
};

공통 Widget Control (모든 위젯)​

노트

모든 위젯은 setProperty(name, value) / getProperty(name) / setStyleProperty(styleName, styleProperty, value) 같은 공통 Widget Control(Method)도 사용할 수 있습니다. 자세한 규칙은 공통 Widget Control 레퍼런스를 참고하세요.