Form (폼) Widget Control

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

정보

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

Widget Control	종류	시그니처	설명
`loadForm`	Method	`formID.loadForm(formPath, linkArg)`	컨테이너에 표시할 폼을 불러오거나 교체
`postMessage`	Method	`formID.postMessage(name, data)`	담긴 폼의 메시지 핸들러로 데이터 전송

Property

정보

해당 없음 - Form 위젯에는 스크립트 전용 Property가 없습니다. 스크립트에서는 아래 공통 Widget Control(getProperty / setProperty)로 값을 읽고 씁니다.

컨테이너에 표시할 폼을 불러오거나, 이미 표시 중인 폼을 다른 폼으로 교체합니다. 같은 폼이 이미 로드되었거나 로드 중이면 아무 것도 하지 않습니다.

종류: Method
Parameters
- formPath (문자열): 불러올 폼의 ID(경로)
- linkArg: 불러온 폼에 전달할 링크 인자 (null 허용)
Returns: 없음 (반환값 없음)

Example

formID.loadForm("group/myForm", arg);

담긴 폼의 onMessage 핸들러로 메시지를 보냅니다. 폼이 아직 로딩 중이면 메시지를 큐에 넣었다가 로드가 끝난 뒤 전달합니다.

종류: Method
Parameters
- name (문자열): 폼이 수신 대기하는 메시지 이름
- data: 폼의 메시지 핸들러로 전달할 데이터
Returns: 없음 (반환값 없음)

Example

formID.postMessage("refresh", { code: "005930" });

정보

해당 없음 - Form 위젯에는 전용 Event가 없습니다.

노트

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