탭 » Api

setinnerscreenurlsync

Description

지정한 탭 아이템에 화면을 링크시키는 API이다.

Parameters

Parameters Type Description
nTabItem short 탭 아이템 인덱스
strScreenURL STRING 탭에 링크시킬 화면의 경로
extra_data INSTANCE [옵션] 탭 화면에 전달할 부가 데이터
nLinkType short [옵션] 링크타입
strPortletName STRING [옵션] 포틀릿 이름
bFocusItem BOOL [옵션] 탭 아이템 포커스 처리 여부 (기본값: true)
bInnerFocus BOOL [옵션] 탭 화면에 포커스 전달 여부 (기본값: true)
strScreenXML STRING [옵션] 탭에 표시할 화면의 XML
strScreenJS STRING [옵션] 탭에 표시할 화면의 스크립트

Return Value

Type Description
short 결과값

Remark

async/await 문법을 사용하여 setinnerscreenurl을 동기 방식으로 처리하는 함수이며, IE 브라우저는 지원하지 않는다.

탭 인덱스를 추가하지 않고 이미 특정 화면이 링크된 탭 패널에 다른 화면을 링크할 경우 사용한다.

리턴값

링크 타입을 지정하여 일반 화면 또는 포틀릿 화면을 링크할 수 있다.(기본값:-1(변경안함))

링크 타입은 아래와 같다.

포틀릿 화면을 링크하는 경우, 포틀릿 화면에 접근하기 위해서는 포틀릿 이름을 지정해야 한다.

Example

async function btnSetinnerscreenurlsync_on_mouseup() { // 화면을 SYNC 방식으로 로드를 시작함. // setinnerscreenurlsync API가 리턴시 화면 로드가 완료된 것을 의미함 // 화면 로드 완료시, 탭 컴포넌트 on_itemcreate 이벤트가 발생함. // extra_data 옵션 파라미터를 통해서 화면으로 값을 전달할 수 있음. // (화면에서는 screen.getextradata API 호출을 통해서 전달된 값을 얻을 수 있음) // await의 동기화 처리는 async 함수내에서만 수행된다. var nResult = await tabTest.setinnerscreenurlsync(1, "/TestScreen"); if(nResult == 1) { screen.alert("성공"); } else if(nResult == -2) { screen.alert("화면이 존재 하지 않습니다."); } else if(nResult < 1) { screen.alert("오류.."); } } async function btnSetinnerscreenurlsync_portlet_on_mouseup() { // 화면을 SYNC 방식으로 로드를 시작함. // setinnerscreenurlsync API가 리턴시 화면 로드가 완료된 것을 의미함 // 화면 로드 완료시, 탭 컴포넌트 on_itemcreate 이벤트가 발생함. // extra_data 옵션 파라미터를 통해서 화면으로 값을 전달할 수 있음. // (화면에서는 screen.getextradata API 호출을 통해서 전달된 값을 얻을 수 있음) // await의 동기화 처리는 async 함수내에서만 수행된다. var nResult = await tabTest.setinnescreenurlsync(1, "/TestPortletScreen", null, 1, "MyPortlet"); if(nResult == 1) { screen.alert("성공"); } else if(nResult == -2) { screen.alert("화면이 존재 하지 않습니다."); } else if(nResult < 1) { screen.alert("오류.."); } }

See Also

getinnerscreenurl
setinnerscreenurl

Viewer Ver.

9.1.1.1

Update Date

20220801