탭 아이템에 화면을 임포트 시키는 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 |
추가된 탭은 마지막에 위치하게 되고 자동으로 추가된 탭에 포커스가 가게되어 해당 화면 임베딩한 탭이 활성화 되게 된다.
bChildScreenEventLock 파라미터를 true로 지정하는 경우, 링크된 화면의 이벤트 잠금 처리를 수행한다. 지정하지 않은 경우, 탭 컴포넌트에 지정된 이벤트 Lock 상태가 반영된다.
오류시 리턴값
nAlign 파라미터
nItemSize 파라미터는 tabitem_position속성에 따라 너비 또는 높이가 된다.
bVisible 파라미터는 옵션 파라미터로 값을 지정하지 않으면 기본은 true이다.
bFocusItem 파라미터는 옵션 파라미터로 값을 지정하지 않으면 기본은 true이다. bVisible 파라미터값이 false인 경우, bFocusItem 파라미터 값은 무시된다.
addimporttab 함수를 통해 화면을 임포트하는 경우, addimporttab 함수 호출 이후에 바로 탭 아이템에 화면 로드가 완료되지 않는다. 화면 로드 완료시 탭 컴포넌트의 on_itemcreate 이벤트가 발생한다.
function btn_on_mouseup()
{
var nTabItem;
// tab item 추가.
nTabItem = tab.addimporttab("IMPORT", 1, 60, "/import_target_screen");
}
function tab_on_itemcreate(objInst, itemindex)
{
screen.alert("화면 임포트 완료");
}