컨테이너 화면에서만 사용되는 함수이며, 탭 아이템에 화면을 링크 타입이 Content 형식으로 화면을 추가시키는 API이다.
| Parameters | Type | Description |
|---|---|---|
| strText | STRING | 탭 제목 |
| nAlign | short | 탭 제목 정렬상수 (*Remark 참조) |
| nItemSize | short | 탭 아이템 크기 |
| strScreenURL | STRING | 탭에 링크시킬 화면 경로 |
| bVisible | BOOL | [옵션] 화면에 보여줄지 말지 여부 (기본값: true) |
| extra_data | INSTANCE | [옵션] 탭 화면에 전달할 부가 데이터 |
| bChildScreenEventLock | BOOL | [옵션] 탭 화면의 이벤트 잠금 여부 |
| bInnerFocus | BOOL | [옵션] 탭 화면에 포커스 전달 여부 (기본값: true) |
| Type | Description |
|---|---|
| short | 추가된 탭 아이템의 인덱스, 오류 발생시 -1 |
추가된 탭은 마지막에 위치하게 되고 자동으로 추가된 탭에 포커스가 가게되어 해당 화면 임베딩한 탭이 활성화 되게 된다.
bChildScreenEventLock 파라미터를 true로 지정하는 경우, 링크된 화면의 이벤트 잠금 처리를 수행한다. 지정하지 않은 경우, 탭 컴포넌트에 지정된 이벤트 Lock 상태가 반영된다.
오류시 리턴값
nAlign 파라미터
nItemSize 파라미터는 tabitem_position속성에 따라 너비 또는 높이가 된다.
bVisible 파라미터는 옵션 파라미터로 값을 주지 않으면 기본은 true이다.
bInnerFocus 파라미터는 옵션 파라미터로 값을 지정하지 않으면 기본은 true이다. bVisible 파라미터값이 false인 경우, bInnerFocus 파라미터 값은 무시된다.
extra_data 파라미터는 탭에 링크된 화면에게 전달될 데이터를 지정한다. 링크된 화면에서는 화면 객체(screen)의 getextradata 함수를 통해서 전달된 데이터를 받아올 수 있다. extra_data 파라미터 값으로는 일반 문자열 이외에도 객체 오브젝트도 지정이 가능하다.
addcontenttab 함수를 통해 화면을 로드하는 경우, addcontenttab 함수 호출 이후에 바로 탭 아이템에 화면 로드가 완료되지 않는다. 화면 로드 완료시 탭 컴포넌트의 on_itemcreate 이벤트가 발생한다.
function btnAddContenttab_on_mouseup()
{
// tab item 추가.
tabFrame.addcontenttab("화면1", 1, 60, "/test");
}