본문으로 건너뛰기

Wrap (랩) Widget Control

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

정보

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

Widget Control 요약​

Widget Control종류시그니처설명
lineCountPropertyconst n = wrapID.lineCount현재 배치된 줄(행·열) 수 (읽기 전용)
onLineCountChangedEventonLineCountChanged = (lineCount) => { ... }표시되는 줄 수가 바뀔 때만 실행

Property​

lineCount​

현재 화면에 배치된 줄(가로 배치면 행, 세로 배치면 열)의 개수입니다. 자식이 줄바꿈될 때마다 자동으로 갱신됩니다.

  • 종류: Property (읽기 전용)
  • 타입: number (정수)
  • 쓰기: 불가 (읽기 전용)

Example

const count = wrapID.lineCount;
console.log(`현재 줄 수: ${count}`);

Method​

정보

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

Event​

onLineCountChanged​

표시되는 줄 수가 바뀔 때만 실행됩니다. 자식이 추가·제거되거나 크기가 변해 줄바꿈 개수가 달라지는 순간에 발화합니다. 실행할 동작을 콜백 함수로 지정합니다.

  • 종류: Event
  • 핸들러: 인자 lineCount(새 줄 수, number)를 받는 콜백 함수
  • Returns: 없음

Example

wrapID.onLineCountChanged = (lineCount) => {
  // 줄 수가 바뀔 때 실행할 코드
  console.log(`줄 수 변경: ${lineCount}`);
};

공통 Widget Control (모든 위젯)​

노트

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