setProperty

위젯 본체의 속성 값을 이름으로 지정해 설정하고 화면에 반영합니다. 여기서 이름은 해당 위젯이 가진 속성의 이름으로, 위젯마다 다릅니다(예: Text 위젯의 text, textAlign).

정보

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

• Parameters
  • name (string): 설정할 위젯 속성의 이름
  • value (any): 설정할 값. 색상이나 열거형 계열 속성은 문자열 형식으로 지정합니다.
• Returns: 위젯 자신을 반환합니다(설정을 이어서 호출하는 체이닝 가능). 보통은 반환값을 사용하지 않고 설정 용도로 씁니다.

Example

textID.setProperty("text", "Hello");

경고

존재하지 않는 속성 이름을 지정하면 오류 없이 아무 일도 일어나지 않습니다(값이 반영되지 않습니다). 위젯마다 사용할 수 있는 속성 이름이 다르므로 해당 위젯의 속성 이름을 확인 후 사용하세요.