화면에 존재하는 함수를 호출하는 API이다. 주로 제어 대상이 되는 화면의 외부 화면에서 제어 대상 화면에 구현된 스크립트 함수를 호출하기 위해서 사용된다.
| Parameters | Type | Description |
|---|---|---|
| strCallMethod | STRING | 호출할 함수명 |
| nScriptKind | short | 스크립트 종류 상수(*Remark 참조) |
| bAsync | BOOL | [옵션] 비동기로 처리할 지 여부(true, false) (기본값: false) |
| Type | Description |
|---|---|
| class | 호출된 함수의 리턴값 또는 true/false |
특별한 경우가 아닌 경우에는, callscriptmethodparam API 사용을 권고한다.
nScriptkind 파라미터는 HTML5 환경에서는 무시된다.
화면 오브젝트를 가져오는 API들은 다음의 것들이 있다.
파라미터 값이 유효하지 않은 경우, false값이 리턴된다.
bAsync 파라미터를 true로 지정한 경우, 함수는 비동기 방식으로 호출되며, callscriptmethod API의 리턴값은 파라미터값이 유효 여부를 기준으로 true/false 값이 리턴된다.
function btnCallScript_on_mouseup(objInst)
{
var RetVal = "";
// 팝업 화면의 화면 오브젝트를 구함
var objPopupScreen = factory.findpopup("Test");
factory.consoleprint("Before Async Call Script Method");
objPopupScreen.callscriptmethodex("showAlert(\"홍길동\")", XFD_JAVASCRIPT, false);
// 팝업 화면에서 Alert 메시지 박스의 확인을 누루기 전까지는
// 아래의 라인이 수행되지 않음.
factory.consoleprint("After Async Call Script Method, RetVal = " + RetVal);
}
// -------------------------------------------------------------------------
// 참고: 아래의 내용은 /SAMPLE/API_HELP/Popup 화면의 스크립트 내용입니다.
// 파라미터로 넘어온 값을 Alert로 표시
function showAlert(strName)
{
screen.alert("Hi! " + strName);
return strName;
}