본문으로 건너뛰기

Switch (스위치) Widget Control

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

정보

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

Widget Control 요약​

Widget Control종류시그니처설명
onChangedEventonChanged = (value) => { ... }스위치 상태가 바뀔 때 실행

Property​

정보

해당 없음 — Switch 위젯에는 스크립트 전용 Property가 없습니다. 스크립트에서는 아래 공통 Widget Control(getProperty / setProperty)로 값(value)을 읽고 씁니다.

Method​

정보

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

Event​

onChanged​

스위치를 켜거나 꺼서 상태가 바뀔 때 실행됩니다.

  • 종류: Event
  • 핸들러 인자
    • value (boolean): 바뀐 뒤의 상태 (true면 켜짐)
  • Returns: 없음

Example

switchID.onChanged = (value) => {
  // value: 바뀐 스위치 상태(true=켜짐)
};

공통 Widget Control (모든 위젯)​

노트

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