setLayoutProperty

위젯의 레이아웃 관련 속성을 설정합니다. 대상은 두 갈래입니다: (1) 위젯 자체의 레이아웃 메타 속성, (2) 부모 컨테이너 안에서의 배치 속성.

정보

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

• Parameters
  • name (string): 설정할 레이아웃 속성의 이름
  • value (any): 설정할 값
• Returns: 위젯 자신을 반환합니다(설정을 이어서 호출하는 체이닝 가능). 보통은 반환값을 사용하지 않고 설정 용도로 씁니다.

사용할 수 있는 이름:

• 항상 사용 가능(위젯 메타): visible, tag, responsive, id, description, analytics
• 부모가 Row/Column일 때: flex, fit
• 부모가 Stack일 때: top, left, right, bottom, width, height

Example

imgID.setLayoutProperty("visible", false);
imgID.setLayoutProperty("flex", 2);
imgID.setLayoutProperty("top", 20);

경고

flex·top·width 같은 배치 속성은 위젯의 부모 컨테이너 종류에 따라 달라집니다. top은 Stack 자식일 때만, flex는 Row/Column 자식일 때만 적용되며, 조건이 맞지 않으면 오류 없이 무시됩니다. 여백(margin)·안쪽 여백(padding)이나 비활성화(disable)는 이 컨트롤 대상이 아닙니다(여백은 스타일 파츠, 비활성화는 disable 프로퍼티를 사용하세요).