개요

운영체제, 하드웨어, 입력장치 등의 정보를 제공하는 오브젝트입니다.

지원 환경

- 스크립트에서 system 전역객체를 통해 접근합니다.

- OS 와 브라우저에 따라 지원되는 기능이 달라집니다.

속성

computername

어플리케이션이 실행된 컴퓨터의 NetBIOS 이름을 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

참고

- 어플리케이션이 시작될 때 레지스트리에서 정보를 읽어와 저장합니다.

cpuarchitecture

어플리케이션이 실행된 컴퓨터의 CPU 제조사 이름을 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

참고

- CPU 제조사 얻기에 실패했을 경우 "UNKNOWN" 값을 갖습니다.

cpucount

어플리케이션이 실행된 컴퓨터의 CPU 갯수를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

cputype

어플리케이션이 실행된 컴퓨터의 CPU 종류 정보를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

참고

- Processor Architecture, Processor Level, Processor Revision 정보가 순서대로 공백으로 구분되어 저장됩니다.

- CPU 종류 정보얻기에 실패했을 경우 "UNKNOWN PROCESSOR" 값을 갖습니다.

locale

어플리케이션이 실행된 컴퓨터의 locale 코드값을 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

참고

- locale은 "language[_country]"  형식으로 작성된 문자열입니다.
  "language" 는 ISO 639-1에서 정의하고 있는 2-알파벳 Language 코드이고,
  "country" 는 ISO 3166-1에서 정의하고 있는 2-알파벳 Country 코드입니다.

- 국가 및 언어 코드는 "Appendix > Locale Code List" 항목을 참고하세요.

loginuser

어플리케이션이 실행된 컴퓨터에 로그인된 사용자의 ID 를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

mobileorientation

어플리케이션이 실행된 모바일 기기의 현재 방향정보를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

참고

- "Portrait" 일 경우 "0" 값을 갖습니다.
  "Reverse Portrait" 일 경우 "1" 값을 갖습니다.
  "LandScape Left" 일 경우 "2" 값을 갖습니다.
  "LandScape Right" 일 경우 "3" 값을 갖습니다.

mobileproducttype

어플리케이션이 실행된 모바일 기기의 기종명을 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

참고

- 모바일 기기의 기종명 또는 제조코드를 반환하며 형식은 각 제조사에 따라 다를 수 있습니다.
  예) "SHV-E160K", "iPhone"

- PC에서 실행하는 경우에는 빈값을 반환합니다.

monitorcount

어플리케이션이 실행된 컴퓨터의 모니터 갯수를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

navigatorfullname

어플리케이션이 실행된 Windows 넥사크로의 엔진종류를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법 설정

var navigatorFullName = system.navigatorfullname;

참고

- Windows NRE 만 지원하는 속성입니다.

navigatorname

어플리케이션이 실행된 브라우저 정보를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

참고

- "nexacro", "Chrome", "Gecko" 등의 값을 갖습니다.

활용 예제

• Grid에서 엑셀로 복사/붙여넣기

navigatorversion

어플리케이션이 실행된 브라우저의 버전을 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

참고

- 버전명 전체를 반환하지 않고 메이저 버전만 반환합니다.
  예를 들어 사용하는 웹브라우저가 구글 크롬이고 버전이 '28.0.1500.95'라면 '28'만 반환합니다.

notificationtoken

어플리케이션이 실행된 모바일 기기에서 Push 알림을 받기 위한 Device Token 값을 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

osversion

어플리케이션이 실행된 환경의 운영체제 명칭과 버전을 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법 설정

var osVersion = system.osversion;

참고

- "Android 2.3", "iOS 6", "Windows 7", "Windows Vista" 등의 값을 갖습니다.

◆ WRE 제약

- WRE 실행 시 Chromium 기반 브라우저(Edge, Chrome, Opera)의 User-Agent Reduction 반영에 따라 최신 버전에서는 실행 환경과 통신 프로토콜에 따라 실제 운영체제와 다른 값이 속성값으로 처리되며 정상적인 동작을 보장하지 못할 수 있습니다.
  * 참고: https://www.chromium.org/updates/ua-reduction/

  - HTTPS 통신: 실제 운영체제 정보가 포함된 문자열을 속성값으로 가집니다.
  - HTTP 통신: 실제 운영체제 버전 정보가 아닌 고정된 문자열을 속성값으로 가집니다.
     Windows(Edge, Chrome, Opera): "Windows 10"
     macOS(Chrome): "Mac OS 10.15.7"
     Android(Chrome, Opera): "Android 10"
        * HTTP 통신 시 Android 운영체제에서 화면 로딩, 화면 회전 시 화면 비율이 확대 또는 축소될 수 있습니다.

활용 예제

• 텍스트를 동적으로 표현하기

taskbarsize

어플리케이션이 실행된 모바일 기기의 TaskBar(Android 는 IndicatorBar)의 크기를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법 설정

var nTask = system.taskbarsize;

참고

- Taskbar(IndicatorBar) 의 표시 유무와 상관없이 기본 TaskBar 의 크기를 갖습니다.

메서드

attachChildFrame

웹브라우저에서 넥사크로 스튜디오로 Generate 된 "xfdl" 파일을 사용자 DOM 에 로드하는 메소드입니다.

지원 환경

문법

system.attachChildFrame(window, document, strKey, stradlurl, strDivId, strxfdlurl)

파라미터

system.attachChildFrame(window, document, "nexacro", "nexacro.xadl.quickview.js", "div_user", "./Base/test.xfdl.js");

참고

- 스크립트에서 mainframe 을 사용하여 접근할 수 없습니다.

- 넥사크로 스튜디오로 개발된 xfdl 파일을 웹브라우저에서 사용할 수 있도록 제공되는 메소드입니다.

checkDevicePermission

권한 설정 여부를 확인하는 메소드입니다.

지원 환경

문법

system.checkDevicePermission(arrPermissiontypes);

파라미터

system.checkDevicePermission(["camera","photo"]);

참고

- 설정 여부는 Environment의 ondevicepermission 이벤트에서 확인할 수 있습니다.

clearClipboard

시스템의 클립보드에 저장된 내용을 삭제하는 메소드입니다.

지원 환경

문법

system.clearClipboard()

파라미터

system.clearClipboard();

참고

◆ WRE 제약 

- Edge, Chrome, FireFox, Opera 브라우저는 https 또는 localhost 통신 인 경우만 clearClipboard() 메소드가 정상동작 합니다.

활용 예제

• Grid에서 엑셀로 복사/붙여넣기

clientToScreenX

컴포넌트의 클라이언트 기준의 x 좌표값을 스크린 기준의 x 좌표값으로 반환하는 메소드입니다.

지원 환경

문법

system.clientToScreenX(objComp, nPosX)

파라미터

var nX = system.clientToScreenX(this.Button00, 10);

반환

참고

- 컴포넌트의 클라이언트 기준 좌표이므로 border 속성과 같이 클라이언트 영역이 아닌 부분은 계산에서 제외됩니다.
  예를 들어 클라이언트 기준 좌표계에서 좌표값(0,0)은 border 내부의 왼쪽상단 영역을 의미합니다.

◆ WRE 제약

- Form 오브젝트의 onload 이벤트 발생 후 마우스 이벤트 발생 전에 메소드가 실행되면 변환되지 않은 컴포넌트 좌표값을 그대로 반환합니다. 
  WRE 환경에서는 마우스 이벤트가 발생하기 전에 정확한 브라우저 영역 계산을 할 수 없습니다. 이 때문에 부정확한 변환값을 반환하지 않고 컴포넌트 좌표값을 반환합니다.
  마우스 이벤트(사용자의 컴포넌트 클릭, 마우스 이동 등의 동작)가 발생하지 않은 경우에는 WRE 환경에서 해당 메소드를 사용하지 않을 것을 권장합니다.

clientToScreenY

컴포넌트의 클라이언트 기준의 y 좌표값을 스크린 기준의 y 좌표값으로 반환하는 메소드입니다.

지원 환경

문법

system.clientToScreenY(objComp, nPosY)

파라미터

var nY = system.clientToScreenY(this.Button00, 10);

반환

참고

- 컴포넌트의 클라이언트 기준 좌표이므로 border 속성과 같이 클라이언트 영역이 아닌 부분은 계산에서 제외됩니다.
  예를 들어 클라이언트 기준 좌표계에서 좌표값(0,0)은 border 내부의 왼쪽상단 영역을 의미합니다.

◆ WRE 제약

- Form 오브젝트의 onload 이벤트 발생 후 마우스 이벤트 발생 전에 메소드가 실행되면 변환되지 않은 컴포넌트 좌표값을 그대로 반환합니다. 
  WRE 환경에서는 마우스 이벤트가 발생하기 전에 정확한 브라우저 영역 계산을 할 수 없습니다. 이 때문에 부정확한 변환값을 반환하지 않고 컴포넌트 좌표값을 반환합니다.
  마우스 이벤트(사용자의 컴포넌트 클릭, 마우스 이동 등의 동작)가 발생하지 않은 경우에는 WRE 환경에서 해당 메소드를 사용하지 않을 것을 권장합니다.

◆ Mobile WRE 제약

- Mobile WRE 실행 시 웹브라우저의 주소창 영역에 대한 정보가 운영체제, 브라우저 버전에 따라 다르게 처리될 수 있습니다.
때문에 스크린 좌표값 처리 시 웹브라우저의 주소창 영역은 제외하고 실제 화면이 표시되는 영역을 기준으로 처리합니다.

convertRealPath

Alias 가 포함된 경로를 실제 절대경로로 변환하는 메소드입니다.

지원 환경

문법

system.convertRealPath(strAlias)

파라미터

var strPath = system.convertRealPath("%INSTALLROOT%");

반환

참고

- 경로에 사용되는 Alias 실제경로입니다.

execBrowser

전달된 문자열 정보에 따라 브라우저(또는 앱)를 실행하는 메소드입니다.

지원 환경

문법

system.execBrowser( strUrl )

파라미터

system.execBrowser("http://www.dummy.com");
system.execBrowser("mailto:test@dummy.com");
system.execBrowser("tel:2025550145");

참고

- 윈도우 운영체제 NRE에서는 시스템에 설정된 기본 브라우저가 아닌 Edge 브라우저가 실행됩니다.
  윈도우 10에서 최신 업데이트를 적용하지 않았거나 윈도우 8.1 이하 버전에서는 인터넷 익스플로러가 실행될 수 있습니다.
  시스템에 설정된 기본 브라우저를 실행하려면 execDefaultBrowser 메소드를 사용합니다.

- WRE에서 메소드 실행 시 해당 웹브라우저에 새 탭(또는 새 창)으로 실행됩니다.

- Android NRE, iOS/iPadOS NRE에서 아래와 같은 문자열을 사용해 특정 파일에 접근하거나 설치된 앱을 실행할 수 있습니다. 
  URL Scheme은 운영체제에 따라 지원하는 항목이 다르며 연결된 앱에 따라 다를 수 있습니다. 운영체제 또는 해당 앱 가이드 문서를 참고하세요.
  특정 앱에서 지원하는 Custom URL Scheme은 앱이 설치되지 않았다면 동작하지 않습니다.
  
  // 상대경로
  system.execBrowser("/storage/emulated/0/Download/test.mp3");

  // 프로토콜 (ftp, file 등)
  system.execBrowser("file:///storage/emulated/0/Download/test.mp3");

  // URL Scheme
  system.execBrowser("Intent://command?parameter=option&version=1");
  system.execBrowser("android-app://com.android.chrome"); 
  system.execBrowser( "fb://profile" );
  system.execBrowser( "twitter://user?screen_name=unity3d" );

활용 예제

• URL 링크 클릭 시 해당 사이트로 이동하기

execDefaultBrowser

전달된 URL을 기본앱으로 지정한 웹브라우저에서 실행하는 메소드입니다.

지원 환경

문법

system.execDefaultBrowser( strUrl, [bNewWindow] );

파라미터

system.execDefaultBrowser("https://www.google.com/")

참고

- NRE에서 메소드 실행 시 시스템에 설정된 기본 브라우저가 실행됩니다. 
- Desktop WRE 에서 메소드 실행 시 해당 웹브라우저에 새탭(또는 새창)으로 실행됩니다.

◆ Windows NRE 제약

- 윈도우 운영체제 NRE에서는 strUrl 파라미터값이 "http://", "https://"로 시작하지 않을 경우 execShell 메소드와 같은 수준의 실행 제약을 적용합니다. 
  자세한 내용은 execShell 도움말을 참고하세요.

execNexacro

전달된 실행경로와 인수값으로 넥사크로를 실행하는 메소드입니다.

지원 환경

문법

system.execNexacro(strCommand)

파라미터

system.execNexacro(" -S \"file://c:\\prj1\\start.json\" -K \"key\" ");
system.execNexacro(" -S \"file://c:\\prj1\\start.json\" -K \"key\" -V \"val1:ev=EnvVal,val2:ec=EnvCook,val3:av=AppVal");

참고

- "실행경로 + 인수의 길이"가 256 자리를 넘는 경우 뒷부분이 짤려 정상적으로 적용되지 않기 때문에 꼭 필요한 옵션만 사용하도록 주의해야 합니다.

- "-AU" 옵션을 설정하면 Build App 과정에서 설정할 수 있는 "Auto Update" 옵션값이 적용되지 않습니다.

- 어플리케이션 실행 시 적용된 Config 파일에 tracemode, loglevel 속성이 정의되어 있지 않으면 Environment 에 설정된 해당 속성값이 적용됩니다.

execShell

윈도우 셸(Shell)에 설정한 값을 전달하는 메소드입니다.

지원 환경

문법

system.execShell( strShellCmd )

파라미터

// file name
system.execShell("%MYDOCUMENT%test.png"); // alias
system.execShell("C:\\Users\\test\\Documents\\test.png");
system.execShell("file://C:\\Users\\test\\Documents\\test.png");

// url
system.execShell("http://www.test.com");
system.execShell("http://www.test.com/test.png");

// email
system.execShell("mailto:user00@test.com?subject=TestSubject&cc=user01@test.com&body=TestBody");

참고

- execShell 메소드는 설정한 값을 윈도우 셸에 전달할 뿐 직접 특정 프로그램을 실행하지 않습니다.
때문에 사용자 PC 환경 설정에 따라 다르게 동작할 수 있습니다.

- 보안상의 이유로 아래와 같은 경우 설정한 값을 윈도우 셸에 전달하지 않습니다.

(1) 특정 실행 파일 확장자 (38종)
사용자 PC에 악성 코드를 설치하거나 실행할 수 있는 확장자를 제한합니다.
해당 확장자를 가진 파일명으로 설정한 값을 윈도우 셸에 전달하지 않습니다.
bat, bin, cmd, com, cpl, dll, exe, gadget, hta, inf1,
ins, inx, isu, job, js, jse, lnk, msc, msi, msp,
mst, paf, pif, ps1, reg, rgs, scr, sct, shb, shs,
u3p, vb, vbe, vbs, vbscript, ws, wsf, wsh

(2) 사용자 PC에 파일이 없는 경우
파라미터값으로 파일명을 설정한 경우 사용자 PC에 해당 파일이 있는지 확인하고 없으면 설정한 값을 윈도우 셸에 전달하지 않습니다.

(3) 확장자가 없는 경우
아래와 같이 확장자 없는 파일명 또는 시스템 등록 프로그램명을 파라미터값으로 전달해서 실행할 수 없습니다.
(X) system.execShell("notepad")

exportPDF

지정한 컴포넌트의 이미지를 PDF 파일로 출력하는 메소드입니다.

지원 환경

문법

system.exportPDF(objComponent, strFileName)

파라미터

var bSucc;
bSucc = system.exportPDF(this.Grid00, "document.pdf");

반환

참고

- 파일 저장 시 애플리케이션 샌드박스 정책이 적용됩니다.
- 운영체제별 PDF 파일 저장 위치는 아래와 같습니다.
  - Windows NRE: 내문서
  - macOS NRE: 내문서

getClipboard

시스템의 클립보드에 저장된 데이터를 지정된 형식으로 반환하는 메소드입니다.

지원 환경

문법

system.getClipboard( strFormat [, objCallBackFunc [, objTarget]] )

파라미터

var varData = system.getClipboard("CF_TEXT");

this.callback = function(data){ trace(data); };
system.getClipboard("CF_TEXT", this.callback, this);

반환

참고

◆ NRE 제약 
- 모바일 NRE는 "CF_TEXT" 형식만 지원합니다.

◆ WRE 제약 
- web runtime environment 는 "CF_TEXT" 형식만 지원합니다.
- Edge, Chrome, Opera 브라우저는 Async 방식으로 클립보드의 데이터를 반환합니다.
  따라서 objCallBackFunc, objTarget 파라미터를 설정하여 CallBack 함수로 데이터를 반환받아야 합니다.
- Edge, Chrome, Opera 브라우저는 https 또는 localhost 통신 인 경우만 getClipboard() 메소드가 정상동작 합니다.
- FireFox 브라우저는 보안 정책상 getClipboard() 메소드를 지원하지 않습니다.
  단, 클립보드의 데이터를 붙여넣기는 가능합니다.

getCursorX

마우스 커서가 위치한 곳의 x 좌표값을 반환하는 메서드입니다.

지원 환경

문법

system.getCursorX()

파라미터

system.getCursorX()

반환

참고

- ontimer 이벤트에서 getCursorX 메서드 실행 시 정상적인 좌표값을 반환하지 못합니다.


◆ Desktop WRE 제약

- 화면이 로딩된 후 실행 화면 영역 내에서 마우스 커서를 이동하지 않은 경우에는 undefined를 반환합니다.

getCursorY

마우스 커서가 위치한 곳의 y 좌표값을 반환하는 메서드입니다.

지원 환경

문법

system.getCursorY()

파라미터

system.getCursorY()

반환

참고

- ontimer 이벤트에서 getCursorY 메서드 실행 시 정상적인 좌표값을 반환하지 못합니다.


◆ Desktop WRE 제약

- 화면이 로딩된 후 실행 화면 영역 내에서 마우스 커서를 이동하지 않은 경우에는 undefined를 반환합니다.

getMonitorIndex

다중 모니터 일 때 전달된 좌표값에 가장 가까운 모니터의 번호를 반환하는 메소드입니다.

지원 환경

문법

system.getMonitorIndex(nCursorX, nCursorY)

파라미터

var nMoniterIndex = system.getMonitorIndex(-10,10);

반환

참고

- 모니터의 번호는 1 부터 시작합니다.

- 웹브라우저 환경에서는 지원하지 않는 메소드입니다.

getPackageVersion

앱 버전 정보를 반환하는 메소드입니다.

지원 환경

문법

system.getPackageVersion()

반환

getScreenHeight

어플리케이션이 실행된 스크린의 높이를 반환하는 메소드입니다.

지원 환경

문법

system.getScreenHeight()

파라미터

system.getScreenHeight()

반환

getScreenPosition

애플리케이션이 실행된 스크린을 기준으로 컴포넌트의 x, y 좌표값을 가지는 오브젝트를 반환하는 메서드입니다.

지원 환경

문법

system.getScreenPosition(objComp)

파라미터

var x = system.getScreenPosition(this.Button00).x;
var y = system.getScreenPosition(this.Button00).y;

반환

getScreenPrintString

지정한 컴포넌트를 HTML 문자열 형태로 출력하는 메소드입니다.

지원 환경

문법

system.getScreenPrintString(objComponent)

파라미터

반환

참고

- WebBrowser, WebView 컴포넌트를 objComponent 파라미터로 설정한 경우 로딩된 콘텐츠가 출력되지 않습니다.

- 컴포넌트에 스크롤바가 활성화된 경우에 화면에 표시되지 않는 영역은 처리되지 않습니다.

◆ 윈도우 운영체제 NRE 제약

- VideoPlayer, Plugin 컴포넌트를 objComponent 파라미터로 설정한 경우 로딩된 콘텐츠가 출력되지 않습니다.

getScreenRect

지정한 모니터의 스크린정보를 Rect 오브젝트로 반환하는 메소드입니다.

지원 환경

문법

system.getScreenRect(nMonitorIndex)

파라미터

var objRect  =  system.getScreenRect( 1 );

반환

참고

- 모니터의 번호는 1 부터 시작합니다.

getScreenResolution

지정한 모니터의 해상도를 반환하는 메소드입니다.

지원 환경

문법

system.getScreenResolution(nMonitorIndex)

파라미터

var strRes = system.getScreenResolution(1);

반환

참고

- 모니터의 번호는 1 부터 시작합니다.

getScreenWidth

어플리케이션이 실행된 스크린의 너비를 반환하는 메소드입니다.

지원 환경

문법

system.getScreenWidth()

파라미터

system.getScreenWidth()

반환

isPrimaryMonitor

다중 모니터 일 때, 지정한 모니터가 주 모니터인지 반환하는 메소드입니다.

지원 환경

문법

system.isPrimaryMonitor(nMonitorIndex)

파라미터

var bPri = system.isPrimaryMonitor(1);

반환

참고

- 모니터의 번호는 1 부터 시작합니다.

print

지정한 컴포넌트의 이미지를 프린터로 출력하는 메소드입니다.

지원 환경

문법

system.print( objComponent [, bHideDialog [, strVAlign [, strHAlign [, bFitOnePage [, strOrientation]]]]] )

파라미터

var bSucc;
bSucc = system.print( this.Grid00 );
bSucc = system.print( this.Grid00, false, "top", "left" );
bSucc = system.print( this.Grid00, false, "top", "left", false );
bSucc = system.print( this.Grid00, false, "top", "left", false, "landscape" );

반환

참고

- Grid, ListView 컴포넌트에 표시할 데이터가 많으면 스크롤바가 활성화되고 일부 데이터가 화면에 표시되지 않습니다. 이때 print 메소드의  objComponent 파라미터로 Grid, ListView 컴포넌트를 설정하고 실행하면 화면에 보이는 컴포넌트 영역만 출력합니다.
  Grid, ListView 컴포넌트의 전체 내용을 출력하기 위해서는 컴포넌트의 크기를 데이터에 맞추어 조정해야 합니다. 데이터가 많은 경우에는 ExcelExportObject 오브젝트를 사용해 출력할 파일을 따로 생성하거나 리포팅 툴을 사용해야 합니다.

◆ Desktop WRE 제약

- objComponent 파라미터로 설정된 컴포넌트에 WebBrowser 컴포넌트가 포함되어 있을 경우
   화면에 표시된 Form 전체가 출력되며 스크롤로 가려진 부분은 출력되지 않습니다.

requestDevicePermission

설정한 권한을 요청하는 메소드입니다.

지원 환경

문법

system.requestDevicePermission(arrPermissionTypes[, strDescription])

파라미터

system.requestDevicePermission(["camera","location"], "Permissions required");

참고

- 설정 결과는 Environment의 ondevicepermission 이벤트에서 확인할 수 있습니다.
- 메소드를 호출했지만 권한 설정 화면을 볼 수 없을 수가 있습니다.
- iOS는 사용자가 거부한 권한에 대해 요청을 할 수 없습니다.
- 안드로이드는 사용자가 "다시 묻지 않기"를 선택한 후 거부한 권한은 요청할 수 없습니다. 해당 권한은 시스템 설정에서만 변경 가능합니다.

saveToImageBase64String

지정한 컴포넌트의 이미지를 Base64 로 인코딩 된 String 으로 반환하는 메소드입니다.

지원 환경

문법

system.saveToImageBase64String( objComponent [, bWholeForm [,strImageType [,strOptions]]] )

파라미터

var strResult;

strResult = system.saveToImageBase64String( this.Button00 );
strResult = system.saveToImageBase64String( this, true );
strResult = system.saveToImageBase64String( this.Div00.form, true );
strResult = system.saveToImageBase64String( this.Div00.form, true, "TIF_MONO","Compress:CCITT3;ResolutionX:300;ResolutionY:300" );

반환

참고

- 알파(alpha) 채널값을 유지하여 반투명값을 저장하기 위해서는 이미지 형식이 "PNG" 이어야 합니다.
   단, "PNG" 파일의 알파(alpha) 채널값 처리 특성상 배경색이 "black" 이 아닌 경우 이미지에 일부 변형이 있을 수 있습니다.

- 컴포넌트의 모습에 따라 차이가 있으나 대체적으로 각 이미지 형식별 특징은 다음과 같습니다.
   용량 : BMP > TIF > PNG > JPG(100) > GIF > JPG(0)
   품질 : (BMP = PNG) > TIF > JPG(100) > GIF > JPG(0)

- 이미지 압축방식이 "CCITT3"나 "CCITT4"인 경우 ColorDepth 는 무조건 1bit 모노크롬으로 저장됩니다.

- "BMP_MONO", "TIF_MONO" 이미지 형식은 1bit 흑백 모노크롬 이미지로 저장됩니다.

- "TIF_24" 이미지 형식은 24bit RGB 이미지로 저장됩니다.

saveToImageFile

지정한 컴포넌트의 이미지를 파일로 출력하는 메소드입니다.

지원 환경

문법

system.saveToImageFile(objComponent, strFileName, strImageType[,strOptions [,bWholeForm]])

파라미터

var bSucc;
bSucc = system.saveToImageFile(this.Grid00, "test.jpg","PNG");
bSucc = system.saveToImageFile(this.Button00, "test.tif","TIF_MONO","Compress:CCITT3;ResolutionX:300;ResolutionY:300");
bSucc = system.saveToImageFile(this, "test.png","PNG", "", true);
bSucc = system.saveToImageFile(this.Div00.form, "test.jpg","JPG", "", true);

반환

참고

- strFileName 에 설정할 수 있는 값은 OS 의 보안정책에 따라 달라집니다.

- 알파(alpha) 채널값을 유지하여 반투명값을 저장하기 위해서는 이미지 형식이 "PNG" 이어야 합니다.
   단, "PNG" 파일의 알파(alpha) 채널값 처리 특성상 배경색이 "black" 이 아닌 경우 이미지에 일부 변형이 있을 수 있습니다.

- 컴포넌트의 모습에 따라 차이가 있으나 대체적으로 각 이미지 형식별 특징은 다음과 같습니다.
   용량 : BMP > TIF > PNG > JPG(100) > GIF > JPG(0)
   품질 : (BMP = PNG) > TIF > JPG(100) > GIF > JPG(0)

- 이미지 압축방식이 "CCITT3"나 "CCITT4"인 경우 ColorDepth 는 무조건 1bit 모노크롬으로 저장됩니다.

- "BMP_MONO", "TIF_MONO" 이미지 형식은 1bit 흑백 모노크롬 이미지로 저장됩니다.

- "TIF_24" 이미지 형식은 24bit RGB 이미지로 저장됩니다.

- 파일 저장 시 애플리케이션 샌드박스 정책이 적용됩니다.
- 운영체제별 이미지 파일 저장 위치는 아래와 같습니다.
  - Windows NRE: 내문서
  - macOS NRE: 내문서

screenToClientX

스크린 기준의 x 좌표값을 컴포넌트의 클라이언트 기준 x 좌표값으로 반환하는 메소드입니다.

지원 환경

문법

system.screenToClientX(objComp, nPosX)

파라미터

var nX = system.screenToClientX(this.Button00, 10);

반환

참고

- 컴포넌트의 클라이언트 기준 좌표이므로 border 속성과 같이 클라이언트 영역이 아닌 부분은 계산에서 제외됩니다.
  예를 들어 클라이언트 기준 좌표계에서 좌표값(0,0)은 border 내부의 왼쪽상단 영역을 의미합니다.

활용 예제

• PopupDiv에서 선택한 값을 데이터로 입력하기

screenToClientY

스크린 기준의 y 좌표값을 컴포넌트의 클라이언트 기준 y 좌표값으로 반환하는 메소드입니다.

지원 환경

문법

system.screenToClientY(objComp, nPosY)

파라미터

var nY = system.screenToClientY(this.Button00, 10);

반환

참고

- 컴포넌트의 클라이언트 기준 좌표이므로 border 속성과 같이 클라이언트 영역이 아닌 부분은 계산에서 제외됩니다.
  예를 들어 클라이언트 기준 좌표계에서 좌표값(0,0)은 border 내부의 왼쪽상단 영역을 의미합니다.

◆ Mobile WRE 제약

- Mobile WRE 실행 시 웹브라우저의 주소창 영역에 대한 정보가 운영체제, 브라우저 버전에 따라 다르게 처리될 수 있습니다. 
  때문에 스크린 좌표값 처리 시 웹브라우저의 주소창 영역은 제외하고 실제 화면이 표시되는 영역을 기준으로 처리합니다.

활용 예제

• PopupDiv에서 선택한 값을 데이터로 입력하기

setClipboard

시스템의 클립보드에 지정된 형식으로 데이터를 저장하는 메소드입니다.

지원 환경

문법

system.setClipboard( strFormat, varData )

파라미터

system.setClipboard( "CF_TEXT", "copy data" );

참고

◆ NRE 제약 
- 모바일 NRE는 "CF_TEXT" 형식만 지원합니다.

◆ WRE 제약 
- web runtime environment 는 "CF_TEXT" 형식만 지원합니다.
- Edge, Chrome, FireFox, Opera 브라우저는 https 또는 localhost 통신 인 경우만 setClipboard() 메소드가 정상동작 합니다.

활용 예제

• Grid에서 엑셀로 복사/붙여넣기

showModalSync

동적으로 생성한 ChildFrame 을 Sync 로 동작하는 Modal 형태로 표시하는 메소드입니다.

지원 환경

문법

system.showModalSync( objChildframe [, strID ] , objParentFrame, [{objArguList} [, objOpener]] );

파라미터

var objFrame = new ChildFrame();
var objParentFrame = this.getOwnerFrame();

objFrame.init( "modalsync00", 0, 0, 500, 500 );
objFrame.formurl = "Base::Test00.xfdl";

var vRtn = system.showModalSync( objFrame, objParentFrame, {a:'aaa', b:'bbb'}, this );
var vRtn = system.showModalSync( objFrame, "modalsync00", objParentFrame, null, this );

반환

참고

* 동적 생성 처리 방식

- showModalSync() 메소드는 스크립트에서 동적으로 생성한 ChildFrame 만 사용할 수 있습니다.
   동적으로 생성한 ChildFrame 이 아닌 경우에는 오동작이 발생할 수 있습니다.

- 동적으로 생성한 ChildFrame 은 autosize 속성값에 따라 표시되는 Modal 의 크기가 결정됩니다.
   autosize 속성값을 설정하지 않으면 true 로 적용됩니다.


* 파라미터 설정 시 참고사항

- objArguList 파라미터로 설정한 변수값은 Modal 로 표시된 ChildFrame 에서 "this.parent.[변수명]" 형태로 접근할 수 있습니다.

- strID 파라미터는 getPopupFrames() 메소드에서 결과값으로 받은 Collection 에 인자로 사용할 수 있습니다.


* 기타 참고사항

- showModalSync() 는 메소드 호출 위치에서 스크립트가 중지되었다가 Modal 종료 후 다음 스크립트가 수행됩니다.
   Modal 의 표시와 관계없이 메소드 호출 이후의 스크립트를 계속해서 수행하려면 showModal() 메소드를 사용하여야 합니다.

- showModalSync() 메소드 실행 시 objParentFrame 파라미터에 설정한 Frame 이 속한 Window 의 팝업 리스트에 Modal 로 표시된 ChildFrame 이 추가됩니다.
   또한, Modal 로 표시된 ChildFrame 이 종료되면 자동으로 팝업 리스트에서 제거되고 내부적으로 destroy 까지 수행됩니다.

- Modal 로 표시될 ChildFrame 의 left, top 속성값이 음수일 경우 0 으로 적용됩니다.
   또한, Modal 창이 표시될 공간이 부족한 경우 TitleBar 가 표시되도록 left, top 위치가 보정됩니다.

- objParentFrame 파라미터에 설정한 Frame 이 속한 window 영역을 기준으로 Modal 이 표시됩니다.
   objParentFrame 파라미터에 설정한 Frame 이 Modeless 인 경우 해당 Frame 이 포함된 Window 를 기준으로 표시됩니다.
   objParentFrame 파라미터에 null 이 설정된 경우 MainFrame 을 기준으로 표시됩니다.

- Modal 로 표시될 ChildFrame 의 openstatus 속성값을 "minimize" 로 설정해도 "normal" 로 표시됩니다.

showModalWindow

동적으로 생성한 ChildFrame 을 별도의 Modal Window 로 표시하는 메소드입니다.

지원 환경

문법

system.showModalWindow( objChildFrame [, strID] , objParentFrame[, {objArguList} [, objOpener]] );

파라미터

var objCFrame = new ChildFrame();

objCFrame.init( "moda00", 0, 0, 500, 500 );
objCFrame.formurl = "Base::Test00.xfdl";
var ret = system.showModalWindow( objCFrame, "modal00", this.getOwnerFrame(), {a:'aaa', b:'bbb'}, this );

반환

참고

- showModalWindow() 메소드는 Sync 로 동작합니다.
   따라서 메소드 실행 시 스크립트 수행이 일시 중지되었다가 Modal Window 종료 시 다음 스크립트가 수행됩니다.

- showModalWindow() 메소드는 Modal Window 를 표시하므로 메소드 실행 이전에 열려있는 화면은 모두 사용불가 상태가 됩니다.

- showModalWindow() 메소드로 표시된 Modal Window 는 부모영역과 관계없이 스크린 내에서 이동이 가능합니다.
   showModal() 메소드로 표시된 Modal 은 부모 영역 내에서만 이동이 가능합니다.

- objArguList 파라미터로 설정한 변수값은 Modal Window 로 표시된 ChildFrame 에서 "this.parent.[변수명]" 형태로 접근할 수 있습니다.