개요

WebBrowser 컴포넌트는 웹페이지를 로딩하고 화면에 표시하는 컴포넌트입니다.

지원 환경

- WebBrowser 컴포넌트 내에서 웹접근성 기능이 정상적으로 동작하려면 가상커서 기능을 사용하여야 합니다.
   가상커서 기능에 관한 안내 메시지는 WebBrowser 컴포넌트로 선택상자가 이동되거나 나갈 때 출력되도록 설정하는 것을 권장합니다.
   선택상자가 이동되거나 나갈 때 접근성이 출력되게 하려면 accessibilityaction과 accessibilityleavemessage 속성을 사용하여야 합니다.


◆ macOS NRE 제약

- macOS NRE에서 WebBrowser 컴포넌트를 사용하려면
   Xcode 프로젝트의 info 항목에서 "App Transport Security Settings > Allow Arbitrary Loads" 값을 "YES"로 설정하여야 합니다.


◆ Windows NRE 제약

- Windows NRE에서 WebBrowser 컴포넌트는 Microsoft WebBrowser Control 기반으로 작성됐습니다. 
  Microsoft WebBrowser Control의 제약으로 Internet Explorer를 지원하지 않는 콘텐츠는 정상적으로 로딩할 수 없습니다.
  24.0.0.100 이후 버전에서 WRE로 배포된 콘텐츠 역시 Internet Explorer를 지원하지 않으며 WebBrowser 컴포넌트에서 정상적으로 로딩할 수 없습니다.
  Internet Explorer를 지원하지 않는 콘텐츠가 필요한 경우에는 WebView 컴포넌트를 사용해 주세요.


◆ Mobile NRE 제약

- WebBrowser 컴포넌트에 로드한 페이지에서 window.open 메서드 실행 시 Nexacro in-app browser가 팝업 형태로 표시됩니다. 
  열린 창은 상단 왼쪽 닫기 버튼을 터치해 닫을 수 있습니다.
  window.opener 속성을 사용해 WebBrowser 컴포넌트에서 로드한 페이지와 Nexacro in-app browser에서 로드한 페이지 간 데이터를 주고받을 수 있습니다.

컴포넌트 구조

생성자

WebBrowser.init( strName, vLeft, vTop , vWidth, vHeight [, vRight, vBottom, [vMinWidth, [vMaxWidth, [vMinHeight, [vMaxHeight]]]]] )

var objComp = new WebBrowser();

objComp.init( "WebBrowser00", 30, 120, 196, 46 );
objComp.init( "WebBrowser00", 30, 120, 196, 46, null, null );
objComp.init( "WebBrowser00", null, null, 300, "400px", "80%", 300 );
objComp.init( "WebBrowser00", 0, 0, 200, 100, null, null, 300, 500, 200, 500 );
objComp.init( "WebBrowser00", "WebBrowser22:10", 300, null, null, "WebBrowser33:10", "20%", 300, 500, 200, 500 );

// Create Object  
var objWebBrowser = new WebBrowser();  
objWebBrowser.init("WebBrowser", 30, 120, 196, 46, null, null);
objWebBrowser.init("WebBrowser", null, null, 300, "400px", "80%", 300);
or
var objWebBrowser = new WebBrowser("WebBrowser", 30, 120, 196, 46, null, null);
var objWebBrowser = new WebBrowser("WebBrowser", null, null, 300, "400px", "80%", 300);
 
// Add Object to Parent Form  
this.addChild("WebBrowser", objWebBrowser); 
 
// Insert Object to Parent Form  
this.insertChild(1, "WebBrowser", objWebBrowser); 
 
// Remove Object form Parent Form  
this.removeChild("WebBrowser"); 
 
// Show Object  
objWebBrowser.show(); 
 
// Destroy Object  
objWebBrowser.destroy(); 
objWebBrowser = null;

Status

속성

accessibilityaction

WebBrowser에 선택상자 이동 시 accessibilitydescreadtype 속성에 따라 스크린 리더의 음성 출력 대상으로 포함할 action 정보를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.accessibilityaction[= strAction]

문법 설정

this.WebBrowser00.accessibilityaction = "Accessibility Action Message"; 
this.WebBrowser00.accessibilityaction = "Select by direction key";

참고

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

- 컴포넌트에 선택상자 이동 시 사용자가 추가적인 정보를 얻기 위해 필요한 동작을 안내하는 용도로 사용합니다. 
  예를 들어 컴포넌트 특성에 따라 다음과 같이 속성값을 설정할 수 있습니다.
  
  - CheckBox 컴포넌트의 경우 아래와 같은 안내문을 accessibilityaction 속성값으로 설정할 수 있습니다.
  "선택 상태를 전환하려면 스페이스 바를 누릅니다."
  
  - WebBrowser, WebView 컴포넌트의 경우 스크린 리더 사용자를 위한 안내문을 accessibilityaction 속성값으로 설정할 수 있습니다.
  "웹 브라우저 컴포넌트 내 콘텐츠를 이용하기 위해서는 가상커서를 해제해 주세요."
  그리고 WebBrowser, WebView 컴포넌트를 벗어났을 때 필요한 안내문을 accessibilityleavemessage 속성값으로 설정합니다.
  "가상커서를 설정해 주세요"

accessibilitydesclevel

WebBrowser 에 선택상자 이동 시 하위 컴포넌트의 접근성 출력여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.accessibilitydesclevel[= enumLevel]

문법 설정

enumLevel ::= 'all' | 'self' | 'child' | 'none'

this.WebBrowser00.accessibilitydesclevel = "all";

참고

- accessibilitydesclevel 속성값을 설정하지 않으면 "all" 로 적용됩니다.

- Button 과 같이 자식 컴포넌트가 없는 컴포넌트는 "all" 또는 "child" 로 설정 시 "self" 로 적용됩니다.

- Div 와 같은 컨테이너 컴포넌트는 "child" 설정 시 실제 컨텐츠의 접근성만을 출력합니다.

- accessibilitydesclevel 속성은 선택상자의 이동에 영향을 주지 않으므로 방향키로 선택상자가 WebBrowser 에 이동되게 하지 않으려면 accessibilityenable 속성을 설정하여야 합니다.

accessibilitydescription

WebBrowser에 선택상자 이동 시 accessibilitydescreadtype 속성에 따라 스크린 리더의 음성 출력 대상으로 포함할 description 정보를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.accessibilitydescription[= strDescription]

문법 설정

this.WebBrowser00.accessibilitydescription = "Option";

참고

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

accessibilityenable

WebBrowser 에 선택상자 이동 시 접근성 관련 속성값 출력여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.accessibilityenable[= bEnable]

문법 설정

bEnable ::= 'true' | 'false'

this.WebBrowser00.accessibilityenable = false;

참고

- accessibilityenable 속성값을 설정하지 않으면 true 로 적용됩니다.

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

- 선택상자 이동 시 컴포넌트의 ARIA-LABEL + Status + Role 순서로 정보가 조합되어 접근성으로 출력됩니다.
   각 정보의 조합순서는 스크린 리더의 종류에 따라 달라질 수 있습니다.
   > ARIA-LABEL : Environment 의 accessbilitydescreadtype 속성에 설정된 속성값이 반영됩니다.
   > Status : WebBrowser 의 현재 상태가 반영됩니다.
   > Role : accessibilityrole 속성값이 반영됩니다. accessibilityrole 속성값을 설정하지 않으면 WebBrowser 의 고유 Role 이 반영됩니다.

- 접근성 기능이 활성화 되어 있을때 웹브라우저 내부로 들어가기 위해서는 가상커서의 활성/비활성화 작업이 필요합니다.

- accessibilityenable 속성값이 false 일 때 데스크탑 환경에서 방향키 외의 방법으로 선택상자를 WebBrowser 로 이동시키면 스크린 리딩 프로그램에서 임의의 값을 출력할 수 있습니다.


◆ 컨테이너 컴포넌트 선택상자 이동 제약

아래와 같은 환경에서 컨테이너 컴포넌트로 선택상자가 이동하지 않고 컨테이너 컴포넌트 내에 배치된 컴포넌트로 이동합니다.
- Android, iOS/iPadOS 운영체제에서 실행 시 (Div, PopupDiv, TabpageControl, View)
- Windows 운영체제에서 센스리더 가상커서 사용 시 (Div, PopupDiv, View)

accessibilitylabel

WebBrowser에 선택상자 이동 시 accessibilitydescreadtype 속성에 따라 스크린 리더의 음성 출력 대상으로 포함할 label 정보를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.accessibilitylabel[= strLabel]

문법 설정

this.WebBrowser00.accessibilitylabel = "OK Button"; 
this.WebBrowser00.accessibilitylabel = "[@static00]"; 
this.WebBrowser00.accessibilitylabel = "[@static00][@static01]"; 
this.WebBrowser00.accessibilitylabel = "[@static00][@static01] OK Button";

참고

- enableaccessibility 속성값이 true인 경우만 적용되는 속성입니다.

- accessibilitydescreadtype 속성값에 "label"이 포함되었으나 accessibilitylabel 속성값을 설정하지 않으면 스크린 리더의 음성 출력 대상에 포함하지 않습니다.

accessibilityleavemessage

WebBrowser 컴포넌트에서 다른 컴포넌트로 선택상자가 이동하기 전에 스크린 리더의 음성 출력 대상으로 포함할 정보를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.accessibilityleavemessage[= strMsg]

문법 설정

this.WebBorwser00.accessibilityleavemessage = "Leave Message";

참고

- enableaccessibility 속성값이 true인 경우만 적용되는 속성입니다.

- 컴포넌트의 특성에 따라 스크린 리더의 특정 옵션을 변경한 상태에서 컴포넌트를 탐색하고 다른 컴포넌트로 이동하기 전 스크린 리더의 옵션을 다시 변경하기 위한 안내를 하기 위한 용도로 사용할 수 있습니다.
컴포넌트 내부 콘텐츠를 모두 탐색 후 아래방향키 입력 시 스크린 리더에서 읽어줍니다.
예를 들어 윈도우 운영체제에서 센스리더의 가상커서 기능을 끈 상태로 사용하는 경우 WebBrowser 컴포넌트 내 콘텐츠를 탐색하기 위해서는 가상커서를 켠 상태로 변경해야 합니다. 이런 경우 accessibilityaction 속성에서는 가상커서를 켜도록 안내하고 accessibilityleavemessage 속성에서는 다시 가상커서를 끄도록 안내합니다.

accessibilityrole

WebBrowser에 선택상자 이동 시 스크린 리더가 읽어주는 Role 정보를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.accessibilityrole[= enumRole]

문법 설정

enumRole ::= 'none' | 'alert' | 'application' | 'button' | 'calendar' | 'chart' | 'checkbox' | 'columnheader' | 'combobox' | 'datepicker' | 'edit' | 'fileupload' | 'form' | 'frame' | 'grid' | 'gridcell' | 'groupbox' | 'heading' | 'heading1' | 'heading2' | 'heading3' | 'heading4' | 'heading5' | 'heading6' | 'image' | 'link' | 'listbox' | 'menubar' | 'progressbar' | 'radio' | 'rowheader' | 'scrollbar' | 'spin' | 'static' | 'statusbar' | 'tab' | 'tabpage' | 'textarea' | 'titlebar' | 'toolbar' | 'tooltip' | 'treegrid' | 'treeitem' | 'webbrowser'

this.WebBrowser00.accessibilityrole = "none"; 
this.WebBrowser00.accessibilityrole = "button";

참고

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

- accessibilityenable 속성값을 설정하지 않으면 WebBrowser의 기본 Role 로 적용됩니다.

- 추가적인 속성값이 필요한 Role 설정 시 WebBrowser에 해당 속성이 없으면 스크린 리더에 따라 정상적으로 정보를 읽지 못할 수 있습니다.

bottom

WebBrowser 을(를) 표시하기 위한 하단 좌표값을 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.bottom[= nBottom]

문법 설정

nBottom ::= [<strCompID> ':'] <nVal> ['px' | '%' | 'em' | 'rem']

this.WebBrowser00.bottom = 10; 
this.WebBrowser00.bottom = "10px"; 
this.WebBrowser00.bottom = "10%"; 
this.WebBrowser00.bottom = "Button00:10px"; 
this.WebBrowser00.bottom = "Button00:10%";

참고

- 좌표값에 단위를 생략할 경우 pixel 값으로 적용됩니다.

- 좌표값에 기준 컴포넌트 또는 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

◆ 기준 컴포넌트 설정 시 유의할 점

- 속성값을 기준 컴포넌트(<strCompID>)를 참조하도록 설정한 경우 다음 사항을 유의해주세요.

스크립트로 속성값에 설정한 기준 컴포넌트 값(<strCompID>)을 변경하는 경우 유효한 컴포넌트 값이 아니면(잘못된 컴포넌트 id, 부모 또는 stepindex가 다른 컴포넌트) 기준 컴포넌트 값은 무시하고 부모를 기준으로 좌표값(<nVal>)을 적용합니다.
스크립트로 기준 컴포넌트의 크기나 위치 속성값을 변경되는 경우(속성값에 영향을 주는 메소드 실행으로 인한 변경 포함) 변경된 속성값이 기준 컴포넌트를 참조하는 컴포넌트에 바로 반영되지 않습니다.
예를 들어 Button01 컴포넌트의 left 속성값이 "Button00:10px"인 경우 스크립트로 Button00 컴포넌트의 right 속성값이 변경하더라도 Button01 컴포넌트의 위치는 변경되지 않습니다.
기준 컴포넌트의 크기나 위치 속성값이 변경된 것을 기준 컴포넌트를 참조하는 컴포넌트에 반영하려면 스크립트에서 기준 컴포넌트의 크기나 위치 속성값 변경 후 Form 오브젝트의 resetScroll 메소드를 실행해주어야 합니다.

cssclass

WebBrowser 의 Style 을 XCSS 파일에 정의된 class 로 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.cssclass[= strcssclass]

문법 설정

strcssclass ::= <ClassName> [ , &ltClassName> ]*

this.WebBrowser00.cssclass = "TestClass"; 
this.WebBrowser00.cssclass = "TestClass,TestClass2";

참고

- XCSS 에 정의된 ".classname" 형식에서 "." 를 제외하고 "classname" 만 설정합니다.

- Style 에 적용되는 방식은 XCSS Attribute 지정과 동일하게 XCSS 내의 순서대로 적용됩니다.

- Status 를 적용하고자 할 경우는 "classname" 에 Status 를 붙여서 사용합니다.

- ',' 를 사용하여 class 를 다중으로 지정하게 되면 class 가 중첩되어 적용됩니다.
   중첩된 class 의 내용에 중복이 있다면 XCSS 내의 순서상 마지막으로 기술된 것이 적용됩니다.


◆ web runtime environment 제약

- web runtime environment 는 cssclass 명의 첫문자가 숫자일 경우 속성값이 적용되지 않으므로 주의하여야 합니다.

enable

WebBrowser 의 사용가능 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.enable[= benable]

문법 설정

benable ::= 'true' | 'false'

this.WebBrowser00.enable = true; 
this.WebBrowser00.enable = false;

참고

- enable 속성값을 설정하지 않으면 true 로 적용됩니다.

- enable 속성값이 false 이면 컴포넌트가 화면에 표시되지만 포커스나 입력을 받을 수 없습니다.

- Div 와 같은 컨테이너 컴포넌트의 enable 속성값을 false 로 설정하면 자식 컴포넌트도 모두 Disable 됩니다.

flexgrow

Layout 컨테이너 내 Main Axis(type 속성값이 "horizontal"이면 수평축, type 속성값이 "vertical"이면 수직축) 여백을 설정한 비율만큼 나누어 컴포넌트의 크기를 재조정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.flexgrow[= fVal]

문법 설정

참고

- flexgrow 속성값을 설정하지 않으면 undefined로 설정되고 0 값으로 동작합니다.
  속성값이 0이면 크기를 재조정하지 않습니다.
    
- Layout 컨테이너 내 배치된 컴포넌트 중 flexgrow 속성값이 0보다 큰 값으로 설정된 컴포넌트를 대상으로 Main Axis의 여백을 설정한 비율만큼 나누어 크기에 적용합니다.

- maxwidth, maxheight 속성값을 설정한 경우에는 해당 크기보다 크게 크기가 조정되지는 않습니다.


◆ fittocontents 속성과 같이 사용하는 경우

아래와 같은 경우 컴포넌트의 flexgrow 속성값이 무시되고 fittocontents 속성만 적용됩니다.

- Layout 오브젝트 또는 Panel 컴포넌트의 type 속성값이 "horizontal"이고
  컴포넌트의 fittocontents 속성값이 "width" 또는 "both"일 때
- Layout 오브젝트 또는 Panel 컴포넌트의 type 속성값이 "vertical"이고
  컴포넌트의 fittocontents 속성값이 "height" 또는 "both"일 때

flexshrink

Layout 컨테이너 내 Main Axis(type 속성값이 "horizontal"이면 수평축, type 속성값이 "vertical"이면 수직축)에 컴포넌트가 배치되는 영역이 컨테이너 영역을 초과하지 않도록 설정한 비율만큼 나누어 컴포넌트의 크기를 재조정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.flexshrink[= fVal]

문법 설정

참고

- flexshrink 속성값을 설정하지 않으면 undefined로 설정되고 1 값으로 동작합니다.
  속성값이 0이면 크기를 재조정하지 않습니다.
    
- Layout 컨테이너 내 배치된 컴포넌트 중 flexshrink 속성값이 0보다 큰 값으로 설정된 컴포넌트를 대상으로 Main Axis의 초과 영역을 설정한 비율만큼 나누어 크기에 적용합니다.

- minwidth, minheight 속성값을 설정한 경우에는 해당 크기보다 작게 크기가 조정되지는 않습니다.


◆ fittocontents 속성과 같이 사용하는 경우

아래와 같은 경우 컴포넌트의 flexshrink 속성값이 무시되고 fittocontents 속성만 적용됩니다.

- Layout 오브젝트 또는 Panel 컴포넌트의 type 속성값이 "horizontal"이고
  컴포넌트의 fittocontents 속성값이 "width" 또는 "both"일 때
- Layout 오브젝트 또는 Panel 컴포넌트의 type 속성값이 "vertical"이고
  컴포넌트의 fittocontents 속성값이 "height" 또는 "both"일 때

height

WebBrowser 을(를) 표시하기 위한 높이를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.height[= nHeight]

문법 설정

nHeight ::= [<strCompID> ':'] <nVal> ['px' | '%' | 'em' | 'rem']

this.WebBrowser00.height = 10; 
this.WebBrowser00.height = "10px"; 
this.WebBrowser00.height = 10%"; 
this.WebBrowser00.height = Button00:10%";

참고

- 높이값에 단위를 생략할 경우 pixel 값으로 적용됩니다.

- 높이값에 기준 컴포넌트 또는 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

◆ 기준 컴포넌트 설정 시 유의할 점

- 속성값을 기준 컴포넌트(<strCompID>)를 참조하도록 설정한 경우 다음 사항을 유의해주세요.

스크립트로 속성값에 설정한 기준 컴포넌트 값(<strCompID>)을 변경하는 경우 유효한 컴포넌트 값이 아니면(잘못된 컴포넌트 id, 부모 또는 stepindex가 다른 컴포넌트) 기준 컴포넌트 값은 무시하고 부모를 기준으로 좌표값(<nVal>)을 적용합니다.
스크립트로 기준 컴포넌트의 크기나 위치 속성값을 변경되는 경우(속성값에 영향을 주는 메소드 실행으로 인한 변경 포함) 변경된 속성값이 기준 컴포넌트를 참조하는 컴포넌트에 바로 반영되지 않습니다.
예를 들어 Button01 컴포넌트의 left 속성값이 "Button00:10px"인 경우 스크립트로 Button00 컴포넌트의 right 속성값이 변경하더라도 Button01 컴포넌트의 위치는 변경되지 않습니다.
기준 컴포넌트의 크기나 위치 속성값이 변경된 것을 기준 컴포넌트를 참조하는 컴포넌트에 반영하려면 스크립트에서 기준 컴포넌트의 크기나 위치 속성값 변경 후 Form 오브젝트의 resetScroll 메소드를 실행해주어야 합니다.

id

WebBrowser의 고유 식별자를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.id

문법 설정

참고

-  addChild나 insertChild 메소드를 사용하여 컴포넌트를 등록할때 parent 가 자식컴포넌트를 구별하기 위한 고유한 key값입니다.

- 속성명이나 메소드명과 같은 예약어를 id 속성값으로 설정할 경우 오류가 발생할 수 있습니다.

- 컴포넌트의 속성은 아니지만 편의를 위하여 넥사크로 스튜디오에서 설정할 수 있는 기능이 제공됩니다.

- name 속성은 사용자가 지정한 컴포넌트의 이름으로 논리적으로 중복이 가능합니다.

- 넥사크로 스튜디오에서 컴포넌트를 생성하거나 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.

initvalueid

WebBrowser 에 적용될 InitValue 의 ID 를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.initvalueid[= strValueID]

문법 설정

참고

- WebBrowser 가 화면에 표시된 후에는 속성값을 설정하거나 변경 할 수 없습니다.
   WebBrowser 를 동적으로 생성 시 show() 메소드 실행 전에 속성값을 설정하여야 합니다.

- Screen 별로 Environment 의 initvaluefileid 속성을 각각 설정하면 Screen 에 따라 다른 초기값을 설정할 수 있습니다.

- InitValueDefinition 영역에 한 개 이상의 InitValue 파일을 정의할 수 있고,
   InitValue 파일에는 컴포넌트별로 여러개의 초기값 정의를 할 수 있습니다.

layoutorder

Layout 컨테이너 내 Main Axis(type 속성값이 "horizontal"이면 수평축, type 속성값이 "vertical"이면 수직축)에 컴포넌트가 배치되는 순서를 설정합니다.

지원 환경

속성 타입

문법

WebBrowser.layoutorder[= nVal]

문법 설정

참고

- layoutorder 속성값을 설정하지 않으면 0으로 설정됩니다.

- 속성값이 음수인 경우에는 0으로 설정됩니다.

- 같은 값으로 2개 이상의 컴포넌트의 속성값을 설정할 수 있습니다. 
  속성값이 같은 경우에는 생성 순서(Z-Order)에 따라 배치 순서가 달라집니다.

left

WebBrowser 을(를) 표시하기 위한 좌측 좌표값을 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.left[= nLeft]

문법 설정

nLeft ::= [<strCompID> ':'] <nVal> ['px' | '%' | 'em' | 'rem']

this.WebBrowser00.left = 10; 
this.WebBrowser00.left = "10px"; 
this.WebBrowser00.left = "10%"; 
this.WebBrowser00.left = "Button00:10px"; 
this.WebBrowser00.left = "Button00:10%";

참고

- 좌표값에 단위를 생략할 경우 pixel 값으로 적용됩니다.

- 좌표값에 기준 컴포넌트 또는 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

◆ 기준 컴포넌트 설정 시 유의할 점

- 속성값을 기준 컴포넌트(<strCompID>)를 참조하도록 설정한 경우 다음 사항을 유의해주세요.

스크립트로 속성값에 설정한 기준 컴포넌트 값(<strCompID>)을 변경하는 경우 유효한 컴포넌트 값이 아니면(잘못된 컴포넌트 id, 부모 또는 stepindex가 다른 컴포넌트) 기준 컴포넌트 값은 무시하고 부모를 기준으로 좌표값(<nVal>)을 적용합니다.
스크립트로 기준 컴포넌트의 크기나 위치 속성값을 변경되는 경우(속성값에 영향을 주는 메소드 실행으로 인한 변경 포함) 변경된 속성값이 기준 컴포넌트를 참조하는 컴포넌트에 바로 반영되지 않습니다.
예를 들어 Button01 컴포넌트의 left 속성값이 "Button00:10px"인 경우 스크립트로 Button00 컴포넌트의 right 속성값이 변경하더라도 Button01 컴포넌트의 위치는 변경되지 않습니다.
기준 컴포넌트의 크기나 위치 속성값이 변경된 것을 기준 컴포넌트를 참조하는 컴포넌트에 반영하려면 스크립트에서 기준 컴포넌트의 크기나 위치 속성값 변경 후 Form 오브젝트의 resetScroll 메소드를 실행해주어야 합니다.

maxheight

WebBrowser 이(가) 화면에 표시되는 최대 높이를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.maxheight[= nMaxHeight]

문법 설정

nMaxHeight ::= <nVal> ['px']

this.WebBrowser00.maxheight = 20; 
this.WebBrowser00.maxheight = "20px";

참고

- height 속성값이 maxheight 보다 크면 화면에 표시되는 WebBrowser 의 높이는 maxheight 속성값으로 적용됩니다.
  표시되는 높이만 적용되고 height 속성값은 변경되지 않습니다.

- maxheight 속성값에 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

- maxheight 속성값을 minheight 속성값보다 작게 설정하면 minheight 속성값이 maxheight 속성값으로 설정됩니다.

- Position 관련 속성(left, top 등)에 기준컴포넌트를 설정하여 WebBrowser 의 높이가 상대적으로 설정될 경우에도 적용되는 속성입니다.
   maxheight > height > top(상대값) > bottom(상대값) > top(절대값) > bottom(절대값) 순서로 설정값이 적용됩니다.
   이 때, height, top, bottom 값 중 먼저 2개가 설정되면 나머지는 무시됩니다.

- fittocontents 속성이 있는 컴포넌트는 속성값에 의해 높이가 자동 설정될 때도 적용되는 속성입니다.

maxwidth

WebBrowser 이(가) 화면에 표시되는 최대 너비를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.maxwidth[= nMaxWidth]

문법 설정

nMaxWidth ::= <nVal> ['px']

this.WebBrowser00.maxwidth = 20; 
this.WebBrowser00.maxwidth = "20px";

참고

- width 속성값이 maxwidth 보다 크면 화면에 표시되는 WebBrowser 의 너비는 maxwidth 속성값으로 적용됩니다.
  표시되는 너비만 적용되고 width 속성값은 변경되지 않습니다.

- maxwidth 속성값에 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

- maxwidth 속성값을 minwidth 속성값보다 작게 설정하면 minwidth 속성값이 maxwidth 속성값으로 설정됩니다.

- Position 관련 속성(left, top 등)에 기준컴포넌트를 설정하여 WebBrowser 의 너비가 상대적으로 설정될 경우에도 적용되는 속성입니다.
   maxwidth > width > left(상대값) > right(상대값) > left(절대값) > right(절대값) 순서로 설정값이 적용됩니다.
   이 때, width, left, right 값 중 먼저 2개가 설정되면 나머지는 무시됩니다.

- fittocontents 속성이 있는 컴포넌트는 속성값에 의해 너비가 자동 설정될 때도 적용되는 속성입니다.

minheight

WebBrowser 이(가) 화면에 표시되는 최소 높이를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.minheight[= nMinHeight]

문법 설정

nMinHeight ::= <nVal> ['px']

this.WebBrowser00.minheight = 20; 
this.WebBrowser00.minheight = "20px";

참고

- height 속성값이 minheight 보다 작다면 화면에 표시되는 WebBrowser 의 높이는 minheight 속성값으로 적용됩니다.
  표시되는 높이만 적용되고 height 속성값은 변경되지 않습니다.

- minheight 속성값에 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

- minheight 속성값을 maxheight 속성값보다 크게 설정하면 maxheight 속성값이 minheight 속성값으로 설정됩니다.

- Position 관련 속성(left, top 등)에 기준컴포넌트를 설정하여 WebBrowser 의 높이가 상대적으로 설정될 경우에도 적용되는 속성입니다.
   minheight > height > top(상대값) > bottom(상대값) > top(절대값) > bottom(절대값) 순서로 설정값이 적용됩니다.
   이 때, height, top, bottom 값 중 먼저 2개가 설정되면 나머지는 무시됩니다.

- fittocontents 속성이 있는 컴포넌트는 속성값에 의해 높이가 자동 설정될 때도 적용되는 속성입니다.

minwidth

WebBrowser 이(가) 화면에 표시되는 최소 너비를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.minwidth[= nMinWidth]

문법 설정

nMinWidth ::= <nVal> ['px']

this.WebBrowser00.minwidth = 20; 
this.WebBrowser00.minwidth = "20px";

참고

- width 속성값이 minwidth 보다 작으면 화면에 표시되는 WebBrowser 의 너비는 minwidth 속성값으로 적용됩니다.
  표시되는 너비만 적용되고 width 속성값은 변경되지 않습니다.

- minwidth 속성값에 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

- minwidth 속성값을 maxwidth 속성값보다 크게 설정하면 maxwidth 속성값이 minwidth 속성값으로 설정됩니다.

- Position 관련 속성(left, top 등)에 기준컴포넌트를 설정하여 WebBrowser 의 너비가 상대적으로 설정될 경우에도 적용되는 속성입니다.
   minwidth > width > left(상대값) > right(상대값) > left(절대값) > right(절대값) 순서로 설정값이 적용됩니다.
   이 때, width, left, right 값 중 먼저 2개가 설정되면 나머지는 무시됩니다.

- fittocontents 속성이 있는 컴포넌트는 속성값에 의해 너비가 자동 설정될 때도 적용되는 속성입니다.

name

WebBrowser 의 이름을 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.name[= strName]

문법 설정

참고

- name 속성은 사용자가 지정한 컴포넌트의 이름으로 논리적으로 중복이 가능합니다.

- 넥사크로 스튜디오에서 컴포넌트를 생성하거나 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.

-nexa-border

WebBrowser 의 테두리를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.border[= strborder]

문법 설정

strborder ::= <line-width> <line-style> <color> [,<line-width> <line-style> <color>]{3}

<line-width> ::= 'thin' | 'medium' | 'thick' | <nWidth> 'px'
<line-style> ::= 'none' | 'hidden' | 'dotted' | 'dashed' | 'solid' | 'double' | 'groove' | 'ridge' | 'inset' | 'outset'
<color> ::= <NamedColor> | <NumericColor>

1회 입력 : top/right/bottom/left 에 모두 적용됩니다.
2회 입력 : top/bottom, right/left 에 첫번째 값부터 각각 적용됩니다.
3회 입력 : top, right/left, bottom 에 첫번째 값부터 각각 적용됩니다.
4회 입력 : top, right, bottom, left 에 첫번째 값부터 각각 적용됩니다.

* XCSS
-nexa-border : 1px solid #999999;
-nexa-border : 1px solid #999999, 1px solid #999999, 1px solid #999999, 1px solid #999999;

* Script ( normal property )
this.WebBrowser00.border = "1px solid #999999";
this.WebBrowser00.border = "1px solid #999999, 1px solid #999999, 1px solid #999999, 1px solid #999999";

참고

- -nexa-border 속성값을 설정하지 않으면 undefined 가 설정되고, "medium none #999999" 로 동작합니다.

- <line-style> 이 "double" 일 때 두 줄을 다른 색으로 설정할 수 없습니다.
   <color> 에 설정된 색이 두 줄에 모두 적용됩니다.

- 스크립트로 접근 시 속성명은 "border"를 사용해야 합니다.


◆ NRE 제약

- 각 테두리의 색상이나 두께를 다르게 설정했을 경우 top > right > bottom > left 순으로 겹쳐서 표시됩니다.

- <line-style> 에 "double","groove","ridge","inset","outset" 값을 설정해도 적용되지 않습니다.

- <line-width> 에 "thin","medium","thick" 값을 설정해도 적용되지 않습니다.


◆ WRE 제약

- 각 테두리의 색상이나 두께를 다르게 설정했을 경우 웹브라우저에 따라 테두리가 겹쳐지는 순서가 다르게 처리될 수 있습니다.

- XCSS 를 사용하지 않고 rgba(), hsl(), hsla() 메소드를 속성에 직접 설정할 경우 브라우저 버전에 따라 적용되지 않을 수 있습니다.

parent

WebBrowser 의 부모 오브젝트를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.parent

문법 설정

var objParent = this.WebBrowser00.parent;

참고

- parent 속성은 일반적으로 컴포넌트가 속한 Form을 갖습니다.

- WebBrowser 이(가) Div 와 같은 컨테이너 컴포넌트에 자식으로 존재한다면 parent 속성은 해당 컨테이너 컴포넌트를 갖습니다.

- Calendar 와 같이 서브컨트롤이 존재하는 컴포넌트에서 서브컨트롤의 parent 속성은 해당 컴포넌트를 갖습니다.

positionstep

부모 오브젝트가 화면분할기능을 사용할 때 WebBrowser 이(가) 표시될 화면의 인덱스를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.positionstep[= nStep]

문법 설정

this.WebBrowser00.positionstep = 0; 
this.WebBrowser00.positionstep = -1;

참고

- positionstep 에 설정된 인덱스값과 일치하는 분할화면에만 컴포넌트가 표시됩니다.

- 분할화면에 표시되지 않는 컴포넌트의 visible 속성값은 "false"로 변경되지 않습니다.

활용 예제

• 화면을 스탭 단위로 나누기

right

WebBrowser 를 표시하기 위한 우측 좌표값을 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.right[= nRight]

문법 설정

nRight ::= [<strCompID> ':'] <nVal> ['px' | '%' | 'em' | 'rem']

this.WebBrowser00.right = 10; 
this.WebBrowser00.right = "10px"; 
this.WebBrowser00.right = "10%"; 
this.WebBrowser00.right = "Button00:10px"; 
this.WebBrowser00.right = "Button00:10%";

참고

- 좌표값에 단위를 생략할 경우 pixel 값으로 적용됩니다.

- 좌표값에 기준 컴포넌트 또는 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

◆ 기준 컴포넌트 설정 시 유의할 점

- 속성값을 기준 컴포넌트(<strCompID>)를 참조하도록 설정한 경우 다음 사항을 유의해주세요.

스크립트로 속성값에 설정한 기준 컴포넌트 값(<strCompID>)을 변경하는 경우 유효한 컴포넌트 값이 아니면(잘못된 컴포넌트 id, 부모 또는 stepindex가 다른 컴포넌트) 기준 컴포넌트 값은 무시하고 부모를 기준으로 좌표값(<nVal>)을 적용합니다.
스크립트로 기준 컴포넌트의 크기나 위치 속성값을 변경되는 경우(속성값에 영향을 주는 메소드 실행으로 인한 변경 포함) 변경된 속성값이 기준 컴포넌트를 참조하는 컴포넌트에 바로 반영되지 않습니다.
예를 들어 Button01 컴포넌트의 left 속성값이 "Button00:10px"인 경우 스크립트로 Button00 컴포넌트의 right 속성값이 변경하더라도 Button01 컴포넌트의 위치는 변경되지 않습니다.
기준 컴포넌트의 크기나 위치 속성값이 변경된 것을 기준 컴포넌트를 참조하는 컴포넌트에 반영하려면 스크립트에서 기준 컴포넌트의 크기나 위치 속성값 변경 후 Form 오브젝트의 resetScroll 메소드를 실행해주어야 합니다.

tablecellarea

Layout 컨테이너 내 가상의 Table Cell 영역 내에서 컴포넌트가 배치되는 영역을 설정합니다.

지원 환경

속성 타입

문법

WebBrowser.tablecellarea[= strArea]

문법 설정

strArea ::= <rowstart> <rowend> '/' <columnstart> <columnend> | <strArea>

<strPosition> ::= <rowstart> <rowend> '/' <columnstart> <columnend>

참고

- 유효하지 않은 값을 설정한 경우에는 layoutorder, tabledirection 속성값에 따라 배치됩니다.

- 같은 영역에 2개 이상의 컴포넌트를 배치할 수 있습니다.

- row와 column의 start, end는 반대 방향으로 설정할 수 있습니다.
  예를 들어 "2 0 / 2 0"과 "0 2 / 0 2"은 같은 영역으로 처리합니다.

활용 예제

• 메가 메뉴 만들기

taborder

탭키 입력으로 컴포넌트간 포커스를 이동할 때 WebBrowser 의 순서를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.taborder[= nTabOrder]

문법 설정

참고

- taborder 속성값이 작은 컴포넌트에 포커스가 먼저 이동되고, 속성값이 클수록 나중에 포커스가 이동됩니다.

- taborder 속성값이 동일한 컴포넌트는 폼에 먼저 생성된 컴포넌트에 포커스가 먼저 이동됩니다.

- 스크립트로 taborder 속성값 변경 시 포커스 이동 순서가 변경됩니다.

- Div 와 같은 컨테이너 컴포넌트는 자식 컴포넌트 레벨에서 포커스 이동 순서가 별도로 정의됩니다.

활용 예제

• 자동 포커스 이동

tabstop

탭키 입력으로 컴포넌트간 포커스를 이동할 때 WebBrowser 이(가) 포커스를 받을 지 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.tabstop[= bTabStop]

문법 설정

bTabStop ::= 'true' | 'false'

참고

- tabstop 속성값이 "false"인 경우 taborder 속성값과 관계없이 포커스가 해당 컴포넌트를 건너뜁니다.

- tabstop 속성값에 관계없이 마우스로 직접 포커스를 주거나, setfocus() 메소드 사용 시 포커스를 갖습니다.

- Div 와 같은 컨테이너 컴포넌트에서 포커스를 받을 수 있는 자식 컴포넌트가 존재하면 해당 컴포넌트가 포커스를 갖습니다.

top

WebBrowser 을(를) 표시하기 위한 상단 좌표값을 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.top[= nTop]

문법 설정

nTop ::= [<strCompID> ':'] <nVal> ['px' | '%' | 'em' | 'rem']

this.WebBrowser00.top = 10; 
this.WebBrowser00.top = "10px"; 
this.WebBrowser00.top = "10%"; 
this.WebBrowser00.top = "Button00:10px"; 
this.WebBrowser00.top = "Button00:10%";

참고

- 좌표값에 단위를 생략할 경우 pixel 값으로 적용됩니다.

- 좌표값에 기준 컴포넌트 또는 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

◆ 기준 컴포넌트 설정 시 유의할 점

- 속성값을 기준 컴포넌트(<strCompID>)를 참조하도록 설정한 경우 다음 사항을 유의해주세요.

스크립트로 속성값에 설정한 기준 컴포넌트 값(<strCompID>)을 변경하는 경우 유효한 컴포넌트 값이 아니면(잘못된 컴포넌트 id, 부모 또는 stepindex가 다른 컴포넌트) 기준 컴포넌트 값은 무시하고 부모를 기준으로 좌표값(<nVal>)을 적용합니다.
스크립트로 기준 컴포넌트의 크기나 위치 속성값을 변경되는 경우(속성값에 영향을 주는 메소드 실행으로 인한 변경 포함) 변경된 속성값이 기준 컴포넌트를 참조하는 컴포넌트에 바로 반영되지 않습니다.
예를 들어 Button01 컴포넌트의 left 속성값이 "Button00:10px"인 경우 스크립트로 Button00 컴포넌트의 right 속성값이 변경하더라도 Button01 컴포넌트의 위치는 변경되지 않습니다.
기준 컴포넌트의 크기나 위치 속성값이 변경된 것을 기준 컴포넌트를 참조하는 컴포넌트에 반영하려면 스크립트에서 기준 컴포넌트의 크기나 위치 속성값 변경 후 Form 오브젝트의 resetScroll 메소드를 실행해주어야 합니다.

url

WebBrowser 에 표시될 웹페이지의 URL 을 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.url[= strUrl]

문법 설정

strUrl ::= <Web-Url> | <Local-Url>

this.WebBrowser00.url = "http://www.tobesoft.co.kr"; 

this.WebBrowser00.url = "http://m.naver.com"; 

this.WebBrowser00.url = "about:blank"; 

this.WebBrowser00.url = "file://C:\\Test.html";

참고

- 모바일 디바이스에서 사용하는 경우는 모바일용으로 개발된 웹페이지 URL로 설정할 것을 권장합니다.

- WebBrowser 컴포넌트에 빈페이지를 로드하려면 "about:blank" 을 설정하여야 합니다.


◆ Web Runtime Environment 제약

- <Local-Url> 형태의 로컬파일 로드를 지원하지 않습니다.

활용 예제

• MS 오피스 뷰어 사용하기

useurlhistory

WebBrowser 컴포넌트의 url 속성이 변경되었을 때 History 기능을 사용할지 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.useurlhistory[= bHistory]

문법 설정

bHistory ::= 'true' | 'false'

this.WebBrowser00.userurlhistory = false;

참고

- useurlhistory 속성값을 설정하지 않으면 true 로 적용됩니다.

- macOS NRE, iOS/iPadOS NRE 는 지원하지 않는 속성입니다.

visible

WebBrowser 이(가) 화면에 표시될지 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.visible[= bVisible]

문법 설정

bVisible ::= 'true' | 'false'

this.WebBrowser00.visible = true; 
this.WebBrowser00.visible = false;

참고

- visible 속성값을 변경하는 즉시 컴포넌트의 표시 여부가 화면에 반영됩니다.

- visible 속성값이 "false"이면 컴포넌트가 화면에 표시되지 않고, 포커스를 받을 수 없으므로 입력이나 사용이 불가능합니다.

- Div 와 같은 컨테이너 컴포넌트의 visible 속성값을 "false"로 설정하면 자식 컴포넌트도 함께 화면에 표시되지 않습니다.

- visible 속성값이 "false"이어도 컴포넌트는 존재하기 때문에 스크립트로 제어가 가능합니다.

- 넥사크로 스튜디오에서는 visible 속성값을 'false'로 설정해도 디자인화면에서 사라지지 않습니다.

width

WebBrowser 을(를) 표시하기 위한 너비를 설정하는 속성입니다.

지원 환경

속성 타입

문법

WebBrowser.width[= nWidth]

문법 설정

nWidth ::= [<strCompID> ':'] <nVal> ['px' | '%' | 'em' | 'rem']

this.WebBrowser00.width = 10; this.WebBrowser00.width = "10px"; 
this.WebBrowser00.width = "10%"; 
this.WebBrowser00.width = "Button00:10%";

참고

- 너비값에 단위를 생략할 경우 pixel 값으로 적용됩니다.

- 너비값에 기준 컴포넌트 또는 단위문자를 포함할 경우 문자열 형태로 설정하여야 합니다.

◆ 기준 컴포넌트 설정 시 유의할 점

- 속성값을 기준 컴포넌트(<strCompID>)를 참조하도록 설정한 경우 다음 사항을 유의해주세요.

스크립트로 속성값에 설정한 기준 컴포넌트 값(<strCompID>)을 변경하는 경우 유효한 컴포넌트 값이 아니면(잘못된 컴포넌트 id, 부모 또는 stepindex가 다른 컴포넌트) 기준 컴포넌트 값은 무시하고 부모를 기준으로 좌표값(<nVal>)을 적용합니다.
스크립트로 기준 컴포넌트의 크기나 위치 속성값을 변경되는 경우(속성값에 영향을 주는 메소드 실행으로 인한 변경 포함) 변경된 속성값이 기준 컴포넌트를 참조하는 컴포넌트에 바로 반영되지 않습니다.
예를 들어 Button01 컴포넌트의 left 속성값이 "Button00:10px"인 경우 스크립트로 Button00 컴포넌트의 right 속성값이 변경하더라도 Button01 컴포넌트의 위치는 변경되지 않습니다.
기준 컴포넌트의 크기나 위치 속성값이 변경된 것을 기준 컴포넌트를 참조하는 컴포넌트에 반영하려면 스크립트에서 기준 컴포넌트의 크기나 위치 속성값 변경 후 Form 오브젝트의 resetScroll 메소드를 실행해주어야 합니다.

메서드

addEvent

WebBrowser 에 특정 이벤트를 선언하여 추가하는 메소드입니다.

지원 환경

문법

WebBrowser.addEvent( strEventID )

파라미터

var bResult = this.WebBrowser00.addEvent( "onmove" );

반환

참고

- Composite Component 와 같은 사용자 컴포넌트에 특정 이벤트를 추가할 때 사용하는 메소드입니다.

- WebBrowser 에서 특정 이벤트를 제거하려면 removeEvent() 메소드를 사용하여야 합니다.

addEventHandler

WebBrowser 의 특정 이벤트에 핸들러 함수를 추가하는 메소드입니다.

지원 환경

문법

WebBrowser.addEventHandler( strEventID, objFunc, objTarget )

파라미터

this.WebBrowser00_onmove = function( obj:nexacro.WebBrowser,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.WebBrowser00.addEventHandler( "onmove", this.WebBrowser00_onmove, this);

반환

addEventHandlerLookup

함수를 검색하여 WebBrowser 의 특정 이벤트에 핸들러 함수로 추가하는 메소드입니다.

지원 환경

문법

WebBrowser.addEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

this.WebBrowser00_onmove = function( obj:nexacro.WebBrowser,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.WebBrowser00.addEventHandlerLookup( "onmove", "WebBrowser00_onmove", this);

반환

참고

- strFunc 이름의 함수를 objTarget 영역부터 상위로 올라가며 검색합니다.
  검색된 함수가 있다면 이벤트에 핸들러 함수로 추가합니다.

bringToFront

부모가 동일한 컴포넌트 중 WebBrowser 이(가) 화면의 제일 앞에 표시되게 합니다.

지원 환경

문법

WebBrowser.bringToFront()

파라미터

this.WebBrowser.bringToFront();

참고

- 디자인 시 소스에 컴포넌트가 선언된 순서대로 화면에 표시됩니다.
  소스에서 위에 선언된 컴포넌트가 먼저 표시되고, 아래에 선언된 컴포넌트가 나중에 표시되게 됩니다.
  컴포넌트가 겹쳐져 있을 경우 화면에 표시되는 순서에 따라 먼저 표시된 컴포넌트가 나중에 표시되는 컴포넌트에 가려지게 됩니다.

- bringToFront() 메소드는 WebBrowser 을(를) 가장 나중에 표시되게 순서를 바꿉니다.
  따라서 화면에 표시될때는 제일 앞에 표시되게 됩니다.

bringToPrev

부모가 동일한 컴포넌트 중 WebBrowser 이(가) 화면에 한단계 앞에 표시되게 합니다.

지원 환경

문법

WebBrowser.bringToPrev()

파라미터

this.WebBrowser.bringToPrev();

참고

- 디자인 시 소스에 컴포넌트가 선언된 순서대로 화면에 표시됩니다.
  소스에서 위에 선언된 컴포넌트가 먼저 표시되고, 아래에 선언된 컴포넌트가 나중에 표시되게 됩니다.
  컴포넌트가 겹쳐져 있을 경우 화면에 표시되는 순서에 따라 먼저 표시된 컴포넌트가 나중에 표시되는 컴포넌트에 가려지게 됩니다.

- bringToPrev() 메소드는 WebBrowser 을(를) 한단계 나중에 표시되는 컴포넌트와 순서를 바꿉니다.
  따라서 화면에 표시될때는 원래 순서보다 한단계 앞에 표시되게 됩니다.

callMethod

WebBrowser 의 window 객체에 정의된 메소드를 호출하는 메소드입니다.

지원 환경

문법

WebBrowser.callMethod( strMethodID [, varArg1 [, varArg2 ]] );

파라미터

반환

참고

- Cross Domain 상황이면 사용에 제한이 있습니다.

- WebBrowser 컴포넌트의 url 속성값을 Local-Url로 설정하면 iOS/iPadOS에서 callMethod 메소드를 사용할 수 없습니다. 
  아래 제품제약사항 문서를 참고해주세요.
  - WebBrowser 컴포넌트의 url 속성으로 Local-Url 접근 시 제약
    http://docs.tobesoft.com/product_information_nexacro_n_v24_ko/product_restrictions#129b7876db079a2e

- 반환된 PluginObject 객체에서 getProperty(), setProperty(), callMethod() 메소드를 사용할 수 있습니다.
   각 메소드로 하위 객체나 속성에 접근하고, 메소드를 실행 할 수 있습니다.

- 사용을 완료한 PluginObject 객체는 명시적으로 destroy 하여야 합니다.
   PluginObject 객체를 destroy 하지 않을 경우 메모리 누수가 발생할 수 있습니다.

활용 예제

• 엘리먼트 속성값 가져오기

• 엘리먼트 속성값 설정하기

• 스크립트의 함수 호출하기

• 외부 웹에디터 사용하기

clearEventHandler

특정 이벤트에 등록된 핸들러 함수를 모두 제거하는 메소드입니다.

지원 환경

문법

WebBrowser.clearEventHandler( strEventID )

파라미터

var nCnt = this.WebBrowser00.clearEventHandler( "onmove" );

반환

참고

- 특정 핸들러 함수만 제거하려면 removeEventHandler() 메소드를 사용하여야 합니다.

destroy

스크립트에서 동적으로 생성한 WebBrowser 을(를) 삭제하는 메소드입니다.

지원 환경

문법

WebBrowser.destroy()

파라미터

var bSucc = this.WebBrowser00.destroy();

반환

참고

- 동적으로 생성한 WebBrowser 을(를) 완전히 삭제하기 위해서는 destroy() 메소드를 호출해야 합니다.

findEventHandler

WebBrowser 의 특정 이벤트에서 핸들러 함수를 찾아 인덱스를 반환하는 메소드입니다.

지원 환경

문법

WebBrowser.findEventHandler( strEventID, objFunc, objTarget )

파라미터

this.WebBrowser00_onmove = function( obj:nexacro.WebBrowser,  e:nexacro.MoveEventInfo ) { //수행할 스크립트 };

var nIndex = this.WebBrowser00.findEventHandler( "onmove", this.WebBrowser00_onmove, this );

반환

참고

- 핸들러 함수의 인덱스는 0 부터 시작합니다.

getEventHandler

WebBrowser 의 특정 이벤트에서 지정된 인덱스에 해당하는 핸들러 함수를 반환하는 메소드입니다.

지원 환경

문법

WebBrowser.getEventHandler( strEventID, nIdx )

파라미터

var objFunc = WebBrowser00.getEventHandler( "onmove", 0 );

반환

getOffsetBottom

부모 컴포넌트의 Top 위치를 기준으로 WebBrowser 의 bottom 값을 픽셀단위의 숫자로 반환하는 메소드입니다.

지원 환경

문법

WebBrowser.getOffsetBottom();

파라미터

var nBottom = this.WebBrowser.getOffsetBottom();

반환

참고

- 화면에 표시된 부모 컴포넌트의 Top 위치를 기준으로 WebBrowser 의 bottom 값을 동적으로 계산합니다.

getOffsetHeight

WebBrowser 의 높이를 픽셀단위의 숫자로 반환하는 메소드입니다.

지원 환경

문법

WebBrowser.getOffsetHeight();

파라미터

var nHeight = this.WebBrowser.getOffsetHeight();

반환

참고

- 화면에 표시된 WebBrowser 의 높이를 동적으로 계산합니다.

활용 예제

• 마지막 좌표값 처리하기

• PopupDiv 배치하기

getOffsetLeft

부모 컴포넌트의 Left 위치를 기준으로 WebBrowser 의 left 값을 픽셀단위의 숫자로 반환하는 메소드입니다.

지원 환경

문법

WebBrowser.getOffsetLeft();

파라미터

var nleft = this.WebBrowser.getOffsetLeft();

반환

참고

- 화면에 표시된 부모 컴포넌트의 Left 위치를 기준으로 WebBrowser 의 left 값을 동적으로 계산합니다.

getOffsetRight

부모 컴포넌트의 Left 위치를 기준으로 WebBrowser 의 right 값을 픽셀단위의 숫자로 반환하는 메소드입니다.

지원 환경

문법

WebBrowser.getOffsetRight();

파라미터

var nRight = this.WebBrowser.getOffsetRight();

반환

참고

- 화면에 표시된 부모 컴포넌트의 Left 위치를 기준으로 WebBrowser 의 right 값을 동적으로 계산합니다.

getOffsetTop

부모 컴포넌트의 Top 위치를 기준으로 WebBrowser 의 top 값을 픽셀단위의 숫자로 반환하는 메소드입니다.

지원 환경

문법

WebBrowser.getOffsetTop();

파라미터

var nTop = this.WebBrowser.getOffsetTop();

반환

참고

- 화면에 표시된 부모 컴포넌트의 Top 위치를 기준으로 WebBrowser 의 top 값을 동적으로 계산합니다.

getOffsetWidth

WebBrowser 의 너비를 픽셀단위의 숫자로 반환하는 메소드입니다.

지원 환경

문법

WebBrowser.getOffsetWidth();

파라미터

var nWidth = this.WebBrowser.getOffsetWidth();

반환

참고

- 화면에 표시된 WebBrowser 의 너비를 동적으로 계산합니다.

활용 예제

• 마지막 좌표값 처리하기

• PopupDiv 배치하기

getPixelBottom

WebBrowser 의 bottom 속성값을 픽셀단위로 반환하는 메소드입니다.

지원 환경

문법

WebBrowser.getPixelBottom();

파라미터

var nbottom = this.WebBrowser.getPixelBottom();

반환

참고

- bottom 속성에 설정한 값의 단위가 퍼센트(%)여도 픽셀(pixel) 단위의 값을 반환합니다.

getPixelHeight

WebBrowser 의 height 속성값을 픽셀단위로 반환하는 메소드입니다.

지원 환경

문법

WebBrowser.getPixelHeight();

파라미터

var nheight = this.WebBrowser.getPixelHeight();

반환

참고

- height 속성에 설정한 값의 단위가 퍼센트(%)여도 픽셀(pixel) 단위의 값을 반환합니다.

getPixelLeft

WebBrowser 의 left 속성값을 픽셀단위로 반환하는 메소드입니다.

지원 환경

문법

WebBrowser.getPixelLeft();

파라미터

var nleft = this.WebBrowser.getPixelLeft();

반환

참고

- left 속성에 설정한 값의 단위가 퍼센트(%)여도 픽셀(pixel) 단위의 값을 반환합니다.

getPixelRight

WebBrowser 의 right 속성값을 픽셀단위로 반환하는 메소드입니다.

지원 환경

문법

WebBrowser.getPixelRight();

파라미터

var nright = this.WebBrowser.getPixelRight();

반환

참고

- right 속성에 설정한 값의 단위가 퍼센트(%)여도 픽셀(pixel) 단위의 값을 반환합니다.

getPixelTop

WebBrowser 의 top 속성값을 픽셀단위로 반환하는 메소드입니다.

지원 환경

문법

WebBrowser.getPixelTop();

파라미터

var ntop = this.WebBrowser.getPixelTop();

반환

참고

- top 속성에 설정한 값의 단위가 퍼센트(%)여도 픽셀(pixel) 단위의 값을 반환합니다.

getPixelWidth

WebBrowser 의 width 속성값을 픽셀단위로 반환하는 메소드입니다.

지원 환경

문법

WebBrowser.getPixelWidth();

파라미터

var nwidth = this.WebBrowser.getPixelWidth();

반환

참고

- width 속성에 설정한 값의 단위가 퍼센트(%)여도 픽셀(pixel) 단위의 값을 반환합니다.

getProperty

WebBrowser 에 로드된 웹페이지의 window 또는 document 객체를 반환하는 메소드입니다.

지원 환경

문법

WebBrowser.getProperty( strObjID );

파라미터

this.WebBrowser00.getProperty( "window" );
this.WebBrowser00.getProperty( "document" );

반환

참고

- Cross Domain 상황이면 사용에 제한이 있습니다.

- 반환된 PluginObject 객체에서 getProperty(), setProperty(), callMethod() 메소드를 사용할 수 있습니다.
   각 메소드로 하위 객체나 속성에 접근하고, 메소드를 실행 할 수 있습니다.
   PluginObject 객체에 대한 설명은 여기를 참고하세요.

- 사용을 완료한 PluginObject 객체는 명시적으로 destroy 하여야 합니다.
   PluginObject 객체를 destroy 하지 않을 경우 메모리 누수가 발생할 수 있습니다.

활용 예제

• 엘리먼트 속성값 가져오기

• 엘리먼트 속성값 설정하기

• 스크립트의 변수값 가져오기

• 스크립트의 함수 호출하기

init

스크립트로 WebBrowser 을(를) 동적 생성한 후에 초기화하는 메소드입니다.

지원 환경

문법

WebBrowser.init( strName, vLeft, vTop , vWidth, vHeight [, vRight, vBottom, [vMinWidth, [vMaxWidth, [vMinHeight, [vMaxHeight]]]]] )

파라미터

var objComp = new WebBrowser();

objComp.init( "WebBrowser00", 30, 120, 196, 46 );
objComp.init( "WebBrowser00", 30, 120, 196, 46, null, null );
objComp.init( "WebBrowser00", null, null, 300, "400px", "80%", 300 );
objComp.init( "WebBrowser00", 0, 0, 200, 100, null, null, 300, 500, 200, 500 );
objComp.init( "WebBrowser00", "WebBrowser22:10", 300, null, null, "WebBrowser33:10", "20%", 300, 500, 200, 500 );

참고

- 인수값에 기준 컴포넌트를 포함하면 WebBrowser 의 위치는 기준 컴포넌트를 기준으로 상대적으로 결정됩니다.
  vLeft, vTop, vWidth, vHeight, vRight, vBottom 값에 기준 컴포넌트를 포함할 때는 "ID:Value" 형태로 설정하여야 합니다.

- 기준 컴포넌트는 WebBrowser 와(과) 부모(Parent)가 동일하여야 하며, Form 로딩 시 WebBrowser 보다 먼저 생성되어야 합니다.
  기준 컴포넌트를 설정하지 않거나 잘못된 값을 설정하면 부모(Parent)를 기준으로 좌표값이 적용됩니다.

- 인수값에 기준 컴포넌트 또는 단위를 포함할 경우 문자열로 설정하여야 합니다.

- 스크립트에서 동적으로 컴포넌트를 생성한 후에만 사용할 수 있습니다.
  동적으로 생성한 컴포넌트가 아닌 경우에는 오동작이 발생할수 있습니다.

- show() 메소드로 컴포넌트가 화면에 표시되면 초기화가 끝난 상태입니다.
  초기화가 끝난 후에 init() 메소드를 호출하면 오류가 발생하며 설정한 값은 적용되지 않습니다.

- 동적으로 생성한 컴포넌트를 컨테이너 컴포넌트에 추가하기 위해서는 addChild() 메소드나 insertChild() 메소드를 사용하여야 합니다.

insertEventHandler

WebBrowser 의 특정 이벤트에 핸들러 함수를 지정한 위치에 삽입하는 메소드입니다.

지원 환경

문법

WebBrowser.insertEventHandler( strEventID, nIndex, objFunc, objTarget )

파라미터

this.WebBrowser00_onmove = function( obj:nexacro.WebBrowser,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };

var nIndex = this.WebBrowser00.insertEventHandler( "onmove", 0, this.WebBrowser00_onmove, this);

반환

참고

- 첫번째 핸들러 함수의 인덱스는 0 입니다.

move

WebBrowser 의 위치와 크기를 변경하는 메소드입니다.

지원 환경

문법

WebBrowser.move( vLeft, vTop [, vWidth, vHeight [, vRight, vBottom]] )

파라미터

this.WebBrowser00.move(10,10);
this.WebBrowser00.move(10,10,100,100);
this.WebBrowser00.move(null, null, 300, "400px", "80%", 300 );

참고

- 인수값에 기준 컴포넌트를 포함하면 WebBrowser 의 위치는 기준 컴포넌트를 기준으로 상대적으로 결정됩니다.
  vLeft, vTop, vWidth, vHeight, vRight, vBottom 값에 기준 컴포넌트를 포함할 때는 "ID:Value" 형태로 설정하여야 합니다.

- 기준 컴포넌트는 WebBrowser 와(과) 부모(Parent)가 동일하여야 하며, Form 로딩 시 WebBrowser 보다 먼저 생성되어야 합니다.
  기준 컴포넌트를 설정하지 않거나 잘못된 값을 설정하면 부모(Parent)를 기준으로 좌표값이 적용됩니다.

- 인수값에 기준 컴포넌트 또는 단위를 포함할 경우 문자열로 설정하여야 합니다.

moveToNext

부모가 동일한 컴포넌트 중 인수로 전달된 컴포넌트보다 WebBrowser 이(가) 화면에 한단계 뒤에 표시되게 합니다.

지원 환경

문법

WebBrowser.moveToNext( objComp )
WebBrowser.moveToNext( strComp )

파라미터

this.WebBrowser.moveToNext( this.Button00 );
this.WebBrowser.moveToNext( "Button00" );

참고

- 인수로 전달되는 기준 컴포넌트와 WebBrowser 은(는) 부모가 동일하여야 합니다.

- 디자인 시 소스에 컴포넌트가 선언된 순서대로 화면에 표시됩니다.
  소스에서 위에 선언된 컴포넌트가 먼저 표시되고, 아래에 선언된 컴포넌트가 나중에 표시되게 됩니다.
  컴포넌트가 겹쳐져 있을 경우 화면에 표시되는 순서에 따라 먼저 표시된 컴포넌트가 나중에 표시되는 컴포넌트에 가려지게 됩니다.

- moveToNext() 메소드는 기준 컴포넌트보다 WebBrowser 이(가) 한단계 먼저 표시되게 순서를 바꿉니다.
  따라서 화면에 표시될때는 기준 컴포넌트보다 한단계 뒤에 표시되게 됩니다.

moveToPrev

부모가 동일한 컴포넌트 중 인수로 전달된 컴포넌트보다 WebBrowser 이(가) 화면에 한단계 앞에 표시되게 합니다.

지원 환경

문법

WebBrowser.moveToPrev( objComp )
WebBrowser.moveToPrev( strComp )

파라미터

this.WebBrowser.moveToPrev( this.Button00 );
this.WebBrowser.moveToPrev( "Button00" );

참고

- 인수로 전달되는 기준 컴포넌트와 WebBrowser 은(는) 부모가 동일하여야 합니다.

- 디자인 시 소스에 컴포넌트가 선언된 순서대로 화면에 표시됩니다.
  소스에서 위에 선언된 컴포넌트가 먼저 표시되고, 아래에 선언된 컴포넌트가 나중에 표시되게 됩니다.
  컴포넌트가 겹쳐져 있을 경우 화면에 표시되는 순서에 따라 먼저 표시된 컴포넌트가 나중에 표시되는 컴포넌트에 가려지게 됩니다.

- moveToPrev() 메소드는 기준 컴포넌트보다 WebBrowser 이(가) 한단계 나중에 표시되게 순서를 바꿉니다.
  따라서 화면에 표시될때는 기준 컴포넌트보다 한단계 앞에 표시되게 됩니다.

reload

WebBrowser 에 표시되고 있는 웹페이지를 새로고침하는 메소드입니다.

지원 환경

문법

WebBrowser.reload()

파라미터

this.WebBrowser00.reload();

참고

- Cross Domain 상황이면 사용에 제한이 있습니다.

removeEvent

WebBrowser 에 선언된 특정 이벤트를 삭제하는 메소드입니다.

지원 환경

문법

WebBrowser.removeEvent( strEventID )

파라미터

var bResult = this.WebBrowser00.removeEvent( "onmove" );

반환

참고

- Composite Component 와 같은 사용자 컴포넌트에서 특정 이벤트를 삭제할 때 사용하는 메소드입니다.

- 이벤트에 핸들러 함수가 정의되어 있을 경우 이벤트를 삭제할 수 없습니다.

- WebBrowser 에 특정 이벤트를 추가하려면 addEvent() 메소드를 사용하여야 합니다.

- WebBrowser 에 기본으로 선언되어 있는 이벤트 삭제 시 오동작 할 수 있으므로 주의하여야 합니다.

removeEventHandler

WebBrowser 의 특정 이벤트에서 핸들러 함수를 제거하는 메소드입니다.

지원 환경

문법

WebBrowser.removeEventHandler( strEventID, objFunc, objTarget )

파라미터