탭 아이템에 화면을 임포트 시키는 API이다.
| Parameters | Type | Description |
|---|---|---|
| strText | STRING | 탭 제목 |
| nAlign | short | 탭 제목 정렬상수 (*Remark 참조) |
| nItemSize | short | 탭 아이템 크기 |
| strScreenURL | STRING | 탭에 링크시킬 포틀릿 화면 경로 |
| bVisible | BOOL | [옵션] 화면에 보여줄지 말지 여부 (기본값: true) |
| extra_data | INSTANCE | [옵션] 탭 화면에 전달할 부가 데이터 |
| bChildScreenEventLock | BOOL | [옵션] 탭 화면의 이벤트 잠금 여부 |
| bFocusItem | BOOL | [옵션] 탭 아이템 포커스 처리 여부 (기본값: true) |
| bInnerFocus | BOOL | [옵션] 탭 화면에 포커스 전달 여부 (기본값: true) |
| Type | Description |
|---|---|
| short | 추가된 탭 아이템의 인덱스, 오류 발생시 -1 |
async/await 문법을 사용하여 addimporttab API을 동기 방식으로 처리하는 함수이며, IE 브라우저는 지원하지 않는다.
파라미터에 대한 자세한 설명은 addimporttab API 도움말을 참조한다.
addimporttabsync 함수를 통해 화면을 임포트하는 경우, addimporttabsync 함수 호출 이후 시점은 탭 아이템에 화면 임포트가 완료된 상태이다. 화면 임포트 완료시 탭 컴포넌트의 on_itemcreate 이벤트도 발생한다.
async function btn_on_mouseup(objInst)
{
var tab_index, ret;
factory.consoleprint("addimporttabsync start");
factory.consoleprint("before call addimporttabsync");
// 화면을 SYNC 방식으로 임포트 시작함.
// addimporttabsync API가 리턴시 화면 로드가 완료된 것을 의미함
// 화면 로드 완료시, 탭 컴포넌트 on_itemcreate 이벤트가 발생함.
// extra_data 옵션 파라미터를 통해서 화면으로 값을 전달할 수 있음.
// (화면에서는 on_load 이벤트 함수에서
// screen.getextradata API 호출을 통해서 전달된 값을 얻을 수 있음)
// await의 동기화 처리는 async 함수내에서만 수행된다.
tab_index = await tab_link.addimporttabsync("SYNC_IMPORT", 1, 100, "/import_target_screen", true, 'EXTRADATA");
factory.consoleprint("after call addimporttabsync, addimporttabsync return = " + tab_index);
factory.consoleprint("addimporttabsync end");
}