본문으로 건너뛰기

Timer (타이머) Widget Control

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

정보

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

Widget Control 요약​

Widget Control종류시그니처설명
startMethodstart()타이머를 시작 값부터 시작
stopMethodstop()타이머를 정지 (표시 값 유지)
resetMethodreset()타이머를 정지하고 시작 값으로 되돌림
isRunningMethodisRunning(): boolean실행 중이면 true 반환
onExpiredEventonExpired = () => { ... }카운트다운이 00:00에 도달했을 때 실행

Property​

정보

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

Method​

start​

타이머를 시작 값부터 시작합니다. 카운트다운 모드는 설정한 시간에서, 카운트업 모드는 0부터 시작합니다. 실행 중에 다시 호출하면 먼저 초기화한 뒤 다시 시작합니다. 편집(디자인) 모드에서는 동작하지 않습니다.

  • 종류: Method
  • Parameters: 없음
  • Returns: 없음

Example

timerID.start();

stop​

타이머를 정지합니다. 현재 표시된 값은 그대로 유지됩니다.

  • 종류: Method
  • Parameters: 없음
  • Returns: 없음

Example

timerID.stop();

reset​

타이머를 정지하고 표시 값을 시작 값으로 되돌립니다. 카운트다운 모드는 설정한 시간으로, 카운트업 모드는 0으로 되돌립니다.

  • 종류: Method
  • Parameters: 없음
  • Returns: 없음

Example

timerID.reset();

isRunning​

타이머가 실행 중인지 여부를 반환합니다.

  • 종류: Method
  • Parameters: 없음
  • Returns: boolean - 실행 중이면 true, 정지 상태면 false

Example

const running = timerID.isRunning();

Event​

onExpired​

카운트다운 타이머가 00:00에 도달했을 때 실행됩니다. 실행할 동작을 콜백 함수로 지정합니다. 카운트업 모드에서는 발생하지 않습니다.

  • 종류: Event
  • 핸들러: 인자 없는 콜백 함수
  • Returns: 없음

Example

timerID.onExpired = () => {
  // 만료 시 실행할 코드
};

공통 Widget Control (모든 위젯)​

노트

모든 위젯은 setProperty / getProperty / setStyleProperty 같은 이름 기반 공통 Widget Control(Method)을 사용할 수 있습니다. 공통 레퍼런스 문서(작성 예정)를 참고하세요.