탭 » Api
getchildscreeninstance
Description
지정한 탭 아이템 안에 링크된 화면의 인스턴스를 가져오는 API이다.
Parameters
| Parameters |
Type |
Description |
| nTabItem |
short |
탭 아이템 인덱스 |
Return Value
| Type |
Description |
| INSTANCE |
탭 아이템에 화면이 링크된 경우에는 링크된 화면 인스턴스가 리턴되고, 탭 아이템에 화면이 링크되어 있지 않은 경우에는 null이 리턴된다. |
Remark
화면이 링크된 탭을 가지고 있는 화면에서 탭에 링크된 화면에 대해서 조작을 수행하기 위해서는 탭에 링크되 화면의 오브젝트가 필요하다.
getchildscreeninstance 함수를 통해서 리턴된 탭에 링크된 화면 오브젝트는 screen 오브젝트와 동일한 기능을 제공하는 오브젝트이다.
이 오브젝트를 이용해서 탭에 링크된 화면의 스크립트 함수를 호출하거나(getmembers 함수 참조), 링크된 화면의 UI 콘트롤 오브젝트에 접하거나(getinstancebyname 함수 참조), 링크된 화면의 데이터셋에 접근(getxdataset 함수 참조)할 수 있다.
Example
<![CDATA[/**
* 탭에 링크된 화면의 경로를 읽어오는 함수
* @param objTab 탭 오브젝트
* @param nTabItemIndex 탭 아이템의 인덱스 (Zero-Base)
* @return 탭의 아이템에 링크된 화면의 URL
*/
function GetTabLinkScreenUrl(objTab, nTabItemIndex)
{
// nTabIndex 파라미터 Validation
var nTabItemCount = objTab.gettabitemcount();
if(nTabItemIndex < 0 || nTabItemIndex >= nTabItemCount) {
factory.consoleprint("Invalid Tab Item Index");
return "";
}
// Tab Item에 링크된 화면 오브젝트를 구하고, Validation
var objTabLinkStreen = objTab.getchildscreeninstance(nTabItemIndex);
if(factory.isobject(objTabLinkStreen) == false) {
factory.consoleprint("Fail To Get Screen Instance");
return "";
}
// Tab Item에 링크돤 화면의 경로를 리턴
return objTabLinkStreen.getscreenurl();
}
]]>
See Also
screen.getmembers
screen.getinstancebyname
screen.getxdataset
Viewer Ver.
9.1.1.1
Update Date
20121105