getProperty

위젯 본체의 속성 값을 이름으로 읽어옵니다. setProperty와 같은 대상(위젯 본체 속성)을 다룹니다.

정보

모든 위젯이 공통으로 사용하는 Widget Control입니다. 아래 예시의 widgetID는 캔버스에서 위젯에 지정한 이름(ID)이며, 스크립트에서는 위젯ID.멤버 형태로 접근합니다.

• Parameters
  • name (string): 읽을 위젯 속성의 이름
• Returns: any - 속성 값. 해당 이름의 속성이 없으면 null. 색상이나 열거형 계열 속성은 문자열로 반환됩니다.

Example

const t = textID.getProperty("text");

경고

존재하지 않는 속성 이름은 오류 없이 null을 반환합니다. 따라서 값이 실제로 비어 있는 것인지 이름이 틀린 것인지는 반환값만으로 구분되지 않습니다. 위젯마다 사용할 수 있는 속성 이름이 다르므로 해당 위젯의 속성 이름을 확인 후 사용하세요.