포틀릿 화면을 모달 팝업으로 띄우는 API이다.
| Parameters | Type | Description |
|---|---|---|
| strPopupName | STRING | 팝업 이름 |
| strScreenURL | STRING | 팝업시킬 화면의 경로 |
| strTitle | STRING | 팝업화면 타이틀 |
| bNoTitle | bool | 타이틀바를 안보이게 할 지에 대한 여부(true, false) |
| nBorderStyle | short | 팝업 BorderStyle 상수(*Remark 참조) |
| nXWindowPos | long | 화면에 보여줄 모니터 상 X 좌표 |
| nYWindowPos | long | 화면에 보여줄 모니터 상 Y 좌표 |
| nWidth | short | 팝업화면의 너비 |
| nHeight | short | 팝업화면의 높이 |
| bCenter | bool | 좌표값을 무시하고 무조건 윈도우 중앙에 뜨게할지 여부(true, false) |
| bAutoPopupSize | bool | 지정한 사이즈를 무시하고 본래화면 사이즈로 뜨게할지 여부(true, false) |
| bMaximize | BOOL | 최대화하여 표시 여부 |
| extra_data | INSTANCE | [옵션] 팝업 화면에 전달할 부가 데이터 |
| bLocal | BOOL | [옵션] 탭 내부 팝업 여부 (기본값 false) |
| bVisible | BOOL | [옵션] 팝업 표시 여부 (기본값 true) |
| bHideProtect | BOOL | [옵션] 모달 배경 잠금 영역 숨김 처리 여부 (기본값 false) |
| Type | Description |
|---|---|
| BOOL | 포틀릿 화면을 정상적으로 로딩을 시작했는지 여부(true, false) |
strPopupName 파라미터는 _, 영문자, 숫자로 구성할 수 있지만, 숫자만으로 구성할 수 없습니다.
strPopupName 파라미터는 팝업을 구별하는 이름으로 사용되며, 동일한 이름의 팝업이 이미 존재하는 경우에는 팝업이 생성되지 않는다.
strPopupName 파라미터는 팝업 화면 로드 완료시, 로드된 포틀릿 팝업 화면의 멤버가 할당된 변수의 이름으로 팝업을 로드한 화면에 동적으로 정의되기 때문에, 팝업을 로드한 화면의 컴포넌트 이름이나 변수 이름과 중복된 값을 사용하는 경우에 기존 값이 오바라이트되고, 팝업이 닫힌 경우, undefined 값으로 지정된다.
이 함수는 포틀릿 팝업 화면을 ASYNC 방식으로 로드를 시작한다. 이 API가 리턴됐다고 해서, 포틀릿 팝업 화면 로드가 완료된 것이 아니다. 리턴값은 포틀릿 팝업 화면 로드가 정상작으로 시작되었다는 것만을 의미한다.
포틀릿 팝업 화면 로드 완료시, 화면의 on_popupload 이벤트가 발생한다.
포틀릿 팝업 화면이 닫히는 경우, 화면의 on_popupdestroy 이벤트가 발생한다.
* nBorderStyle 상수 XFD_BORDER_NONE = 0 (테두리 없음) XFD_BORDER_FLAT = 1 (선 테두리) XFD_BORDER_RAISED = 2 (리사이즈 불가능한 창 테두리) XFD_BORDER_RESIZE = 4 (리사이즈 가능한 창 테두리)
* bLocal 파라미터 탭에 링크된 화면에서 bLocal 파라미터를 true로 지정하면 팝업창이 탭내부에 표시된다.
bVisible 파라미터를 false로 지정한 경우, 팝업 화면이 보이지 않으며, 팝업 화면 오브젝트의 setvisible 함수를 통해 팝업 화면 표시/숨김 처리를 수행한다.
function btnfullparam_on_mouseup()
{
var strPopupName, strScreenURL, strTitle, bNoTitle, nBorderStyle,
nXWindowPos, nYWindowPos, nWidth, nHeight, bCenter, bAutoPopupSize,
bMaximize, extra_data, bLocal, bVisible, bHideProtect;
strPopupName = "PopupName";
strScreenURL = "/POPUP/PopupScreen";
strTitle = "PopupTitle";
bNoTitle = false;
nBorderStyle = 4; // 리사이즈 가능한 창 테두리
nXWindowPos = 0;
nYWindowPos = 0;
nWidth = 0;
nHeight = 0;
bCenter = true; // 화면 중앙에 표시
bAutoPopupSize = true; // 화면 크기로 팝업 화면 크기 표시
bMaximize = false; // 최대회 표시 여부
extra_data = null; // 팝업 화면에게 전달할 데이터
bLocal = false; // 전역 모달 처리
bVisible = true; // 팝업 화면 표시 여부
bHideProtect = false; // 모달 배경 잠금 영역 숨김 처리 여부
screen.loadportletpopup(strPopupName, strScreenURL, strTitle, bNoTitle,
nBorderStyle, nXWindowPos, nYWindowPos, nWidth, nHeight,
bCenter, bAutoPopupSize, bMaximize, extra_data, bLocal, bVisible);
}
function btnLoadpopupex_on_mouseup()
{
var no_title, is_center, auto_popup_size, is_maximize, extra_data;
no_title = false;
is_center = true;
auto_popup_size = true;
is_maximize = false;
extra_data = null;
screen.loadportletpopup("TestPortletPopup", "/PortletPopup", "팝업테스트중",
no_title, XFD_BORDER_RAISED, 0, 0, 200, 500,
is_center, auto_popup_size, is_maximize, extra_data);
}
function screen_on_popupload(popup_screen, popup_name)
{
// 로드된 포틀릿 화면의 멤버가 screen.loadportletpopup API 호출시
// strPopupName 파라미터에 지정한 이름으로 팝업을 로드한 화면에
// 동적으로 정의됨
factory.consoleprint(this.TestPortletPopup);
}