본문으로 건너뛰기

setStyleProperty

정보

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

위젯에 적용된 스타일(배경·테두리·여백·크기 등 Styles 파츠)의 속성 값을 설정합니다. 스타일 이름으로 대상 파츠를 지정하고, 그 파츠의 속성 이름과 값을 지정합니다. setProperty(위젯 본체)와 달리 위젯에 덧입힌 스타일 파츠를 대상으로 합니다.

  • Parameters
    • styleName (string): 대상 스타일 파츠의 이름(위젯의 Styles 목록에 표시되는 파츠 이름)
    • styleProperty (string): 그 파츠의 속성 이름
    • value (any): 설정할 값
  • Returns: 위젯 자신을 반환합니다(설정을 이어서 호출하는 체이닝 가능). 보통은 반환값을 사용하지 않고 설정 용도로 씁니다.

styleProperty"enabled"를 주고 값에 boolean을 지정하면, 그 스타일 파츠 자체를 켜거나 끕니다.

Example

boxID.setStyleProperty("DecoratedBox", "color", "#FF0000");
boxID.setStyleProperty("DecoratedBox", "enabled", false);
경고

존재하지 않는 스타일 이름이나 속성 이름을 지정하면 오류 없이 무시됩니다(값이 반영되지 않음). 위젯에 실제로 적용된 스타일 파츠의 이름을 사용하세요.