개요

넥사크로에서 기능을 확장하여 추가로 제공하는 메소드입니다.

지원 환경

- 넥사크로에 정의된 메소드는 정적 메소드이므로 생성이나 선언 없이 바로 사용할 수 있습니다.

메서드

addErrorMessage

어플리케이션에 사용자가 정의한 에러메시지를 추가하는 메소드입니다.

지원 환경

문법

nexacro.addErrorMessage( enumLang, strCode, strMsg )

파라미터

nexacro.addErrorMessage( "en", "test_code","Test Error Message" ) ;

참고

- 추가된 에러메시지에 대응하는 에러를 발생시키려면 Library 를 수정하여야 합니다.

base64Decode

Base64 형식으로 인코딩된 데이터를 디코딩 하는 메소드입니다.

지원 환경

문법

nexacro.base64Decode( strData )

파라미터

var strOutput = nexacro.base64Decode( strInput ) ;

반환

base64Encode

데이터를 Base64 형식으로 인코딩 하는 메소드입니다.

지원 환경

문법

nexacro.base64Encode( strData )

파라미터

var strOutput = nexacro.base64Encode( strInput ) ;

반환

ceil

지정된 자릿수 또는 소수점을 기준으로 올림한 값을 반환하는 메소드입니다.

지원 환경

문법

nexacro.ceil( nVal [,nFractionDigit] );

파라미터

var nNum
nNum = nexacro.ceil(3.0123);      // nNum = 4
nNum = nexacro.ceil(3.0123, 2);  // nNum = 3.02

반환

참고

- 자릿수 지정 시 오차가 발생할 수 있습니다.

deleteCacheDB

어플리케이션에서 사용한 Cache DB 파일 및 관련된 임시파일을 삭제하는 메소드입니다.

지원 환경

문법

nexacro.deleteCacheDB()

파라미터

nexacro.deleteCacheDB() ;

참고

- Cache 경로의 ".db" 파일을 삭제한 후 새로 작성합니다.
  추가로 Cache 경로에서 현재 어플리케이션의 키값에 해당하는 하위폴더의 모든 파일을 함께 삭제합니다.

flashWindow

작업표시줄에서 해당 어플리케이션 아이콘을 깜빡이게 하는 메소드입니다.

지원 환경

문법

nexacro.flashWindow( enumType, nCount, [,nInterval] )

파라미터

nexacro.flashWindow( "count", 10, 500 );

참고

- 사용자에게 알릴 작업이 있는 경우에 사용합니다.

floor

지정된 자릿수 또는 소수점을 기준으로 내림한 값을 반환하는 메소드입니다.

지원 환경

문법

nexacro.floor( nVal [,nFractionDigit] );

파라미터

var nNum;
nNum = nexacro.floor(9.9999);      // nNum = 9
nNum = nexacro.floor(9.9999, 2);  // nNum = 9.99

반환

참고

- 자릿수 지정 시 오차가 발생할 수 있습니다.

gc

메모리에서 사용하지 않는 데이터를 즉시 삭제하는 메소드입니다.

지원 환경

문법

nexacro.gc()

파라미터

nexacro.gc() ;

참고

- 팝업되었던 Form, ChildFrame, DataSet 등 현재 사용되지 않고 메모리에 남아 있는 데이터를 명시적으로 삭제하기 위한 메소드입니다.

- gc() 메소드는 방법에 따라 성능에 영향을 미칠 수 있으므로 주의하여 사용하여야 합니다.

getApplication

현재 실행된 어플리케이션의 Application 오브젝트를 반환하는 메소드입니다.

지원 환경

문법

nexacro.getApplication()

파라미터

var objApp = nexacro.getApplication() ;

반환

getCookieVariable

Environment 의 Cookies 영역에 정의된 쿠키의 값을 반환하는 메소드입니다.

지원 환경

문법

nexacro.getCookieVariable( strID [, bSecure] )

파라미터

var vCookie0 = nexacro.getCookieVariable("Cookie0") ;
var vCookie1 = nexacro.getCookieVariable("Cookie1", true) ;

반환

참고

◆ web runtime environment 제약

- Secure 속성이 설정된 상태로 서버에서 받은 Cookie 는 Cookies 영역에 추가되거나 변경되지 않습니다.

- Cross Domain 상황이면 Cookies 영역의 Cookie 가 서버로 전송되거나 서버에서 받은 값으로 변경되지 않습니다.

getEnableWheelZoom

지정된 Frame 이 속한 window 의 Zoom 기능 설정여부를 반환하는 메소드입니다.

지원 환경

문법

nexacro.getEnableWheelZoom( objFrame )

파라미터

var objFrame = this.getOwnerFrame();

var bEnableZoom = nexacro.getEnableWheelZoom( objFrame )

반환

참고

- Zoom 기능의 설정을 변경하지 않았다면 true 로 적용됩니다.

- Zoom 기능은 window 단위로 설정 할 수 있습니다.
   따라서, open(), showModalWindow() 등의 메소드로 오픈된 별도의 window 를 갖는 팝업창은 Zoom 기능을 따로 설정하여야 합니다.

getEnvironment

현재 실행된 어플리케이션의 Environment 오브젝트를 반환하는 메소드입니다.

지원 환경

문법

nexacro.getEnvironment()

파라미터

var objEnv = nexacro.getEnvironment() ;

반환

getEnvironmentVariable

Environment 의 Variables 영역에 정의된 변수의 값을 반환하는 메소드입니다.

지원 환경

문법

nexacro.getEnvironmentVariable( strID )

파라미터

var vEnv0 = nexacro.getEnvironmentVariable("Env_Variable0") ;

반환

참고

- Application 의 AppVariables 영역에 정의된 변수값을 얻으려면 getApplication() 메소드를 사용하여 변수에 접근하여야 합니다.

getHTTPHeaderVariable

Environment 의 HTTP Header 영역에 정의된 변수의 값을 반환하는 메소드입니다.

지원 환경

문법

nexacro.getHTTPHeaderVariable( strID )

파라미터

var vHTTPVal0 = nexacro.getHTTPHeaderVariable("HeaderVal00") ;

getLogFilePath

앱에서 로그 파일을 저장하는 경로를 반환하는 메소드입니다.

지원 환경

문법

nexacro.getLogFilePath()

파라미터

var strLogFilePath = nexacro.getLogFilePath();

반환

참고

- 윈도우 운영체제에서 로그 파일을 읽기 위해서는 Environment filesecurelevel 속성값이 "all"로 설정되어 있어야 합니다. 최초 로그 파일 접근 시 샌드박스 창이 표시됩니다.

- VirtualFile 오브젝트를 사용해 저장한 로그 파일 정보를 확인할 수 있습니다. 아래 예제를 참고하세요.

getPopupFrames

파라미터로 설정한 Frame 이 속한 Window 를 기준으로 팝업된 ChildFrame 을 Collection 형태로 반환하는 메소드입니다.

지원 환경

문법

nexacro.getPopupFrames( [objFrame] )

파라미터

var arrPopFrame = nexacro.getPopupFrames() ;
var arrPopFrame = nexacro.getPopupFrames( this.getOwnerFrame() ) ;

반환

참고

- 팝업된 ChildFrame 의 리스트는 Window 를 기준으로 관리됩니다.
   따라서 objFrame 파라미터에 서로 다른 Frame 을 설정해도 같은 Window 에 있으면 동일한 결과값을 반환합니다.
   예를 들어 동일한 Window 에 속한 "A", "B" Frame 에서 각각 팝업을 했을 때 objFrame 에 어떤 Frame 을 설정해도 동일한 결과값을 반환합니다.
   그러나 Window 가 다른 "A", "B" Frame 에서 각각 팝업을 했을 때는 objFrame 에 설정한 Frame 에 따라 다른 결과값을 반환합니다.

- objFrame 파라미터를 생략했을 경우 getPopupFrames() 메소드가 실행되는 시점에 활성화 되어 있는 Window 를 기준으로 결과값을 반환하므로 특정 조건일 때 결과값이 달라질 수 있습니다.
   예를 들어 "A" Frame 에서 open() 메소드로 별도 Window 가 있는 "B" Frame 을 팝업한 상태에서 "A" Frame 에 정의된 스크립트롤 호출하여 "A" Frame" 에서 getPopupFrames() 메소드가 실행되어도 활성화 된 Window 가 기준이 되므로 "B" Frame 을 기준으로 결과값을 반환할 수 있습니다.
   그러므로 objFrame 파라미터를 생략하지 않을 것을 권장합니다.

- open(), showModalWindow() 메소드는 부모와 별도의 Window 를 갖고 팝업됩니다.
   showModal(), showModalSync() 메소드는 부모와 동일한 Window 로 팝업됩니다.

- open(), showModal(), showModalSync(), showModalWindow() 메소드로 팝업된 ChildFrame 은
   해당 메소드 실행 시 objParentFrame 파라미터에 설정한 Frame 이 속한 Window 의 팝업리스트에 추가됩니다.

- 결과값으로 반환된 오브젝트는 Collection 접근방식을 사용할 수 있습니다.
   ReturnObj[0], ReturnObj["Frame0"], ReturnObj.length 등의 방법을 사용합니다.

getPrivateProfile

어플리케이션에서 저장한 개인화 데이터를 반환하는 메소드입니다.

지원 환경

문법

nexacro.getPrivateProfile( strKey )

파라미터

var vPrivate0 = nexacro.getPrivateProfile( "aa" ) ;

반환

참고

- 개인화 데이터는 어플리케이션이 구동될 때 설정한 Key 값 별로 따로 관리되며 "nexacro.xml" 파일에 저장됩니다.

- "nexacro.xml" 파일은 사용자별로 정보를 관리하기 위해 사용하는 XML 형식의 파일입니다.
  Windows 운영체제의 경우 C:\Users\[UserName]\AppData\LocalLow\TOBESOFT\Nexacro N\24 위치에 파일이 생성됩니다.

- 웹브라우저 환경일 경우 브라우저의 Local Storage 영역에 개인화 데이터를 저장합니다.

getProjectPath

애플리케이션의 실행 경로를 반환하는 메소드입니다.

지원 환경

문법

nexacro.getProjectPath()

파라미터

var strPrjPath = nexacro.getProjectPath();

반환

getStringResourceValue

StringResource에서 지정한 Key 값에 해당하는 문자열을 반환하는 메서드입니다.

지원 환경

문법

nexacro.getStringResourceValue(strKey);

파라미터

var strResource = nexacro.getStringResourceValue("A0001");

반환

getTextSize

인수로 전달된 값을 기준으로 텍스트가 표시되는 영역의 크기를 계산하여 반환하는 메소드입니다.

지원 환경

문법

nexacro.getTextSize( strText, strFont [, nLimitWidth, strWordWrap [, refObj]] );
nexacro.getTextSize( strText, strFont [, refObj] );

파라미터

this.Static00.font = "italic bold 10pt Arial";

var strText = "Sample Text";

var objSize = nexacro.getTextSize( strText, this.Static00.font );
var objSize2 = nexacro.getTextSize( strText, "italic bold 10pt Arial", 100, "char" );
var objSize3 = nexacro.getTextSize( strText, "italic bold 2em Arial", this );

trace( objSize.nx + "," + objSize.ny );
trace( objSize2.nx + "," + objSize2.ny );
trace( objSize3.nx + "," + objSize3.ny );

반환

참고

- Theme 나 XCSS 로 설정된 속성값은 스크립트로 접근할 수 없습니다.
   따라서 strFont 에 컴포넌트의 font 속성을 사용하려면 넥사크로 스튜디오나 스크립트로 font 속성을 설정하여야 합니다.

- nLimitWidth, strWordWrap 값을 설정하면 줄바꿈이 적용되어 텍스트가 표시되는 영역의 크기가 계산됩니다.

활용 예제

• 컬럼 너비보다 큰 텍스트만 툴팁으로 보여주기

getWheelZoom

지정된 Frame 이 속한 window 의 Zoom 배율을 반환하는 메소드입니다.

지원 환경

문법

nexacro.getWheelZoom( objFrame )

파라미터

var objFrame = this.getOwnerFrame();

var nZoomScale = nexacro.getWheelZoom( objFrame );

반환

참고

- Zoom 배율을 변경하지 않았다면 100 으로 적용됩니다.

- Zoom 기능은 window 단위로 설정 할 수 있습니다.
   따라서, open(), showModalWindow() 등의 메소드로 오픈된 별도의 window 를 갖는 팝업창은 Zoom 배율을 따로 설정하여야 합니다.

isAlpha

인수로 전달된 문자코드 또는 문자열이 알파벳인지 여부를 반환하는 메소드입니다.

지원 환경

문법

nexacro.isAlpha( nChar )
nexacro.isAlpha( strChar )

파라미터

var bRet;
bRet = nexacro.isAlpha(97);       // true, 97 = 'a'
bRet = nexacro.isAlpha("aaa");  // true

반환

isAlphaNumeric

인수로 전달된 문자코드 또는 문자열이 알파벳 또는 숫자인지 여부를 반환하는 메소드입니다.

지원 환경

문법

nexacro.isAlphaNumeric( nChar )
nexacro.isAlphaNumeric( strChar )

파라미터

var bRet;
bRet = nexacro.isAlphaNumeric(97);            // true , 97 = 'a'
bRet = nexacro.isAlphaNumeric("123abc");   // true

반환

isExistCookieVariable

Environment 의 Cookies 영역에서 특정 쿠키변수의 존재여부를 반환하는 메소드입니다.

지원 환경

문법

nexacro.isExistCookieVariable( strID [, bSecure] )

파라미터

nexacro.isExistCookieVariable( "Cookie0" ) ;
nexacro.isExistCookieVariable( "Cookie1", true ) ;

반환

isLower

인수로 전달된 문자코드 또는 문자열이 알파벳 소문자인지 여부를 반환하는 메소드입니다.

지원 환경

문법

nexacro.isLower( nChar )
nexacro.isLower( strChar )

파라미터

var bRet;
bRet = nexacro.isLower(97);       // true , 97 = 'a'
bRet = nexacro.isLower("abC");  // false

반환

isNumeric

인수로 전달된 문자코드 또는 문자열이 숫자인지 여부를 반환하는 메소드입니다.

지원 환경

문법

nexacro.isNumeric( nChar )
nexacro.isNumeric( strChar )

파라미터

var bRet;
bRet = nexacro.isNumeric(97);      // false , 97 = 'a'
bRet = nexacro.isNumeric("123");  // true

반환

isSpace

인수로 전달된 문자코드 또는 문자열이 공백문자인지 여부를 반환하는 메소드입니다.

지원 환경

문법

nexacro.isSpace( nChar )
nexacro.isSpace( strChar )

파라미터

var bRet;
bRet = nexacro.isSpace(0);        // false , 0 = Null
bRet = nexacro.isSpace(32);      // true , 32 = Space
bRet = nexacro.isSpace(97);      // false , 97 = 'a'
bRet = nexacro.isSpace("");       // true
bRet = nexacro.isSpace(" ");      // true

반환

isUpper

인수로 전달된 문자코드 또는 문자열이 알파벳 대문자인지 여부를 반환하는 메소드입니다.

지원 환경

문법

nexacro.isUpper( nChar );
nexacro.isUpper( strChar );

파라미터

var bRet;
bRet = nexacro.isUpper(65);        // true , 65 = 'A'
bRet = nexacro.isUpper("abC");   // false

반환

loadStringResource

지정한 언어에 해당하는 StringResource를 로드하는 메서드입니다.

지원 환경

문법

nexacro.loadStringResource(strLang[, strUrl]);
nexacro.loadStringResource(strUrl);

파라미터

nexacro.loadStringResource("ja");
nexacro.loadStringResource("ja", "https://dummy.com/i18n");
nexacro.loadStringResource("https://dummy.com/i18n");

참고

- 첫 번째 파라미터 값이 URL 문자열 형태인지 구분해서 strLang 또는 strUrl 파라미터로 처리합니다.

- strUrl 파라미터 값 설정 시 반환되는 JSON 파일에는 지정한 언어 데이터가 포함되어야 합니다.
  지정된 언어 데이터를 찾지 못하면 Environment.onerror 이벤트에서 에러로 처리합니다.
  예를 들어 지정한 언어가 en인 경우 JSON 파일은 아래와 같은 형태여야 합니다.

  {
      "en": {
              "btn_0001" : "Example",
              "btn_0002" : "Source",
              "btn_0003" : "Script",
              "msg_0001" : "The example application was tested on the Nexaro N",
              "msg_0002" : "version."
      }
  }

loadStyle

어플리케이션에 XCSS 파일을 로드하여 적용하는 메소드입니다.

지원 환경

문법

nexacro.loadStyle( strURL )

파라미터

nexacro.loadStyle( "xcssrc::theme1.xcss" );

참고

- Form을 로드하기 전에 loadStyle 메소드를 실행해 새로운 스타일을 적용하는 용도로 사용할 수 있습니다.

- 열려있는 Form에 새로운 스타일을 적용하기 위해 loadStyle 메소드를 사용한다면 아래와 같은 제약이 있을 수 있습니다.
  > 크기나 위치에 영향을 줄 수 있는 스타일 속성 중 일부는 loadStyle 메소드를 실행해도 열려있는 Form에 적용되지 않습니다.
  > 스타일 속성을 모두 적용하려면 reload 메소드를 실행해야 합니다. 단, reload 메소드 실행 시에는 화면이 초기화되며 동적으로 추가된 컴포넌트는 유지되지 않습니다.
  > loadStyle 메소드 실행 후 reload 메소드를 실행하지 않고 동적으로 컴포넌트를 추가하는 경우에는 추가한 컴포넌트에 한정해 새로운 스타일이 정상적으로 적용됩니다.

- 메소드 실행 시 기존에 적용된 XCSS 에 새로운 XCSS 설정값을 중첩하여 적용합니다.

- "xcssrc" 는 User Prefix 로 사용하실 수 없습니다.

open

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

지원 환경

문법

nexacro.open( strID, strFormURL, objParentFrame, {objArguList}, strOpenStyle, nLeft, nTop [, nWidth, nHeight [, objOpener [, strExtOpenStyle [, strReturnType ]]]])

파라미터

var bSucc;
bSucc = nexacro.open("modeless", "Base::Form01.xfdl",  this.getOwnerFrame(), {a:'aaa', b:'bbb'}, "showtitlebar=true showstatusbar=false", 0, 0);
bSucc = nexacro.open("modeless", "Base::Form01.xfdl",  this.getOwnerFrame(), {a:'aaa', b:'bbb'}, "showtitlebar=true showstatusbar=false", 0, 0, 640, 480);
bSucc = nexacro.open("modeless", "Base::Form01.xfdl",  this.getOwnerFrame(), {a:'aaa', b:'bbb'}, "showtitlebar=true showstatusbar=false", 0, 0, 640, 480, this);
bSucc = nexacro.open("modeless", "Base::Form01.xfdl",  this.getOwnerFrame(), {a:'aaa', b:'bbb'}, "showtitlebar=true showstatusbar=false", 0, 0, 640, 480, this, "location=true menubar=true toolbar=true");
bSucc = nexacro.open("modeless", "Base::Form01.xfdl",  this.getOwnerFrame(), {a:'aaa', b:'bbb'}, "showtitlebar=true showstatusbar=false", 0, 0, 640, 480, this, "noactivate=true");

nexacro.open("modeless", "Base::Form01.xfdl",  this.getOwnerFrame(), {a:'aaa', b:'bbb'}, "showtitlebar=true showstatusbar=false", 0, 0, 640, 480, this, "noactivate=true", "promise").then((result) => {
   trace("Closed popup"); 
 }).catch((err) => {
   trace("Failed to open popup: " + err.message);
 });

반환

참고

- objParentFrame 파라미터에 null 설정 시 팝업창으로 표시된 ChildFrame에 부모는 설정되지 않지만, MainFrame 오브젝트의 Window에는 팝업된 ChildFrame이 팝업리스트에 추가됩니다.

- ChildFrame 의 autosize 속성값이 true 인 경우 nWidth, nHeight 파라미터값을 생략해도 자동으로 Form 의 크기에 맞춰집니다.
   그렇지 않은 경우 nWidth, nHeight 의 기본값이 0 이므로 화면에 표시되지 않을 수 있습니다. (autosize 속성은 Default 값이 true 입니다)

- strOpenStyle 파라미터에서 환경에 따른 제약을 받는 속성은 open() 메소드로 생성할 때만 적용되는 제약입니다.
   각 속성의 실제 지원환경은 각 속성의 Chm 페이지를 확인하시기 바랍니다.


◆ Desktop WRE 제약

- strOpenStyle 파라미터에 resizable 속성값을 false로 지정하여도 항상 true로 동작합니다.

활용 예제

• open 메소드로 속성값 전달하기

parseDate

날짜형식의 문자열을 분석해 1970년 1월 1일 자정부터 해당 날짜 사이의 시간을 밀리초로 반환하는 메소드입니다.

지원 환경

문법

nexacro.parseDate( strDate )

파라미터

var ret = nexacro.parseDate("1999-10-10");     // 939481200000

반환

참고

- 메소드에 사용하는 문자열은 ISO 8601 날짜 형식 또는 RFC2822 / IETF 날짜 형식을 따릅니다.

  * ECMA 표준 
    [http://www.ecma-international.org/ecma-262/5.1/#sec-15.9.1.15]
  * ISO 8601 날짜형식 : YYYY-MM-DD'T'hh:mm:ss.sss'Z' 
    [http://www.iso.org/iso/home/standards/iso8601.htm]
  * RFC2822 / IETF 날짜형식 : 'May 21, 2012', 'Mon, 21 May 2012 03:20:00 +0900'
    [https://datatracker.ietf.org/doc/html/rfc2822#page-14]
  * Mozilla 웹브라우저 지원 형식
    [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/parse]


◆ WRE 제약

- ECMA5 표준에서는 ISO 8601 날짜 형식을 따르도록 명시되어 있습니다. 
  하지만 이전 ECMA 표준에서는 Date 표준 내장 객체의 toString 메소드 실행 결과를 해석하는 것으로 명시되어 있어 브라우저에 따라 동작이 다를 수 있으며 오류가 발생할 수 있습니다.

- 브라우저에 상관없이 같은 결과를 얻기 위해서는 아래 날짜 형식 문자열을 사용해야 합니다.
  YYYY-MM-DD (ISO 8601 날짜 형식, 예: 2021-06-29)
  YYYY-MM-DD'T'hh:mm:ss.sss'Z' (ISO 8601 조합된 UTC 날짜 및 시간, 예: 2021-06-29T11:00:00.000Z)
  MMM DD, YYYY (예: May 21, 2012)
  EEE, DD MMM YYYY hh:mm:ss Z (예: Mon, 21 May 2012 03:20:00 +0900)
  EEE, DD MMM YYYY hh:mm:ss z (예: Wed, 09 Aug 1995 00:00:00 GMT)
  EEE, DD MMM YYYY hh:mm:ss (예: Wed, 09 Aug 1995 00:00:00)

removeCookieVariable

Environment 의 Cookies 영역에서 쿠키변수를 제거하는 메소드입니다.

지원 환경

문법

nexacro.removeCookieVariable( strID [, bSecure] )

파라미터

nexacro.removeCookieVariable( "Cookie0" ) ;
nexacro.removeCookieVariable( "Cookie1", true ) ;

참고

- Application 영역에 있는 변수를 제거하기 위해서는 removeVariable() 메소드를 사용하여야 합니다.

- Environment 영역에 있는 변수를 제거하기 위해서는 removeEnvironmentVariable() 메소드를 사용하여야 합니다.

removeEnvironmentVariable

Environment 의 Variables 영역에 정의된 변수를 제거하는 메소드입니다.

지원 환경

문법

nexacro.removeEnvironmentVariable( strID )

파라미터

nexacro.removeEnvironmentVariable( "Env_Variable0" ) ;

참고

- Application 의 AppVariables 영역에 있는 변수를 제거하기 위해서는 removeVariable() 메소드를 사용하여야 합니다.

- 통신 시 사용되는 Cookie 를 제거하기 위해서는 removeCookieVariable() 메소드를 사용하여야 합니다.

removeHTTPHeaderVariable

Environment 의 HTTP Header 영역에서 변수를 제거하는 메소드입니다.

지원 환경

문법

nexacro.removeHTTPHeaderVariable( strID )

파라미터

nexacro.removeHTTPHeaderVariable( "HeaderVal00" );

removePrivateProfile

애플리케이션에서 저장한 개인화 데이터를 삭제하는 메소드입니다.

지원 환경

문법

nexacro.removePrivateProfile( strKey )

파라미터

nexacro.removePrivateProfile("aa");

replaceAll

인수로 전달된 문자열에서 특정 문자열을 새 문자열로 모두 변환하여 반환하는 메소드입니다.

지원 환경

문법

nexacro.replaceAll( strText, strOrgText, strRepText );

파라미터

반환

round

지정된 자릿수 또는 소수점을 기준으로 반올림한 값을 반환하는 메소드입니다.

지원 환경

문법

nexacro.round( nVal [,nFractionDigit] );

파라미터

var nNum;
nNum = nexacro.round(1.4915);         // 1 
nNum = nexacro.round(1.4915, 2);     // 1.49  
nNum = nexacro.round(1.5163);         // 2
nNum = nexacro.round(1.5163, 2);     // 1.52
nNum = nexacro.round(1024.256, -1); // 1020
nNum = nexacro.round(1024.256, -2); // 1000
nNum = nexacro.round(1024.256, -4); // 0

반환

참고

- 자릿수 지정 시 오차가 발생할 수 있습니다.

setCookieVariable

Environment 의 Cookies 영역에 쿠키를 추가하는 메소드입니다.

지원 환경

문법

nexacro.setCookieVariable( strID, varVal [, bSecure] )

파라미터

nexacro.setCookieVariable( "Cookie0", "test" ) ;
nexacro.setCookieVariable( "Cookie1", "test", true ) ;

참고

- Application 영역에 변수를 추가하기 위해서는 addVariable() 또는 setVariable() 메소드를 사용하여야 합니다.

- Environment 영역에 변수를 추가하기 위해서는 setEnvironmentVariable() 메소드를 사용하여야 합니다.

- strID 에 설정한 쿠키변수가 존재할 경우에는 쿠키변수의 값을 변경합니다.


◆ web runtime environment 제약

- Secure 속성이 설정된 상태로 서버에서 받은 Cookie 는 Cookies 영역에 추가되거나 변경되지 않습니다.

- Cross Domain 상황이면 Cookies 영역의 Cookie 가 서버로 전송되거나 서버에서 받은 값으로 변경되지 않습니다.

setEnableWheelZoom

지정된 Frame 이 속한 window 의 Zoom 기능을 설정하는 메소드입니다.

지원 환경

문법

nexacro.setEnableWheelZoom( objFrame, bZoom)

파라미터

var objFrame = this.getOwnerFrame();

nexacro.setEnableWheelZoom( objFrame, false );

참고

- Zoom 기능의 설정을 변경하지 않았다면 true 로 적용됩니다.

- Zoom 기능은 window 단위로 설정 할 수 있습니다.
   따라서, open(), showModalWindow() 등의 메소드로 오픈된 별도의 window 를 갖는 팝업창은 Zoom 기능을 따로 설정하여야 합니다.

- Zoom 기능이 활성화 되어 있을 때 Control 키를 누른 상태에서 휠버튼을 회전시키면 window 화면단위로 Zoom 이 발생합니다.
   Zoom 발생 시 50%~200% 범위 내에서 10% 단위로 Zoom 배율이 변경됩니다.

- Zoom 배율이 100% 가 아닌 경우 성능이 저하될 수 있으므로 주의하여야 합니다.

- Zoom 배율이 적용된 상태에서 Zoom 기능을 비활성화 하여도 적용된 Zoom 배율은 유지됩니다.

- 특정 Zoom 배율로 확대/축소하려면 setWheelZoom() 메소드를 사용하여야 합니다.


◆ web runtime environment 제약

- web runtime environment 는 지원하지 않는 메소드입니다.
   web runtime environment 는 웹브라우저에서 제공하는 Zoom 기능을 사용하므로 
   Control 키를 누른 상태에서 휠버튼을 회전시키면 전체화면에서 50/75/100/125/150/175/200 배율로 Zoom 이 발생합니다.

setEnvironmentVariable

Environment 의 Variables 영역에 변수를 추가하는 메소드입니다.

지원 환경

문법

nexacro.setEnvironmentVariable( strID, varVal )

파라미터

var vEnv0 = nexacro.setEnvironmentVariable("Env_Variable0", "test") ;

참고

- Application 영역에 변수를 추가하기 위해서는 addVariable() 또는 setVariable() 메소드를 사용하여야 합니다.

- 통신 시 사용되는 Cookie 를 추가하기 위해서는 setCookieVariable() 메소드를 사용하여야 합니다.

setHTTPHeaderVariable

Environment 의 HTTP Header 영역에 변수를 추가하는 메소드입니다.

지원 환경

문법

nexacro.setHTTPHeaderVariable( strID, varVal )

파라미터

nexacro.setHTTPHeaderVariable("HeaderVal00", "test") ;

참고

- HTTP Header 영역에 정의된 변수는 HTTP 통신 시 Header 영역에 추가됩니다.
   Cross Domain 상황인 경우는 Header 영역에 변수가 추가되지 않습니다.

- Nexacro Runtime Environment 환경에서 실행 시에는 아래 오브젝트 통신 처리 시 Header 영역에 변수를 추가할 수 있습니다.
(Web Runtime Environment 환경에서 실행 시에는 아래 오브젝트 통신 처리 시 Header 영역에 변수를 추가할 수 없습니다).
FileUpload, FileDownload, ExcelExportObject, ExcelImportObject, FileUpTransfer, FileDownTransfer

setInitialVariable

웹브라우저 환경에서 어플리케이션이 로드되기 전 Global 영역 변수에 값을 설정하는 메소드입니다.

지원 환경

문법

nexacro.setInitialVariable( strType, strID, varVal )

파라미터

nexacro.setInitialVariable( "cookie", "ValA", "Text" );

참고

- 어플리케이션이 로드 된 후에는 사용할 수 없는 메소드입니다.

- 외부 HTML 의 oninitframework 함수에서 어플리케이션 로딩 전에 넥사크로의 Global 영역 변수값을 설정할 때 사용하는 메소드입니다.

- 어플리케이션 내부에서는 setCookieVariable(), setEnvironmentVariable(), setHTTPHeaderVariable(), setVariable() 메소드를 사용하여야 합니다.

setPrivateProfile

어플리케이션에서 개인화 데이터를 저장하는 메소드입니다.

지원 환경

문법

nexacro.setPrivateProfile( strKey, varVal )

파라미터

var bSucc = nexacro.setPrivateProfile( "aa", "A" );

반환

참고

- 개인화 데이터는 어플리케이션이 구동될 때 설정한 Key 값 별로 따로 관리되며 "nexacro.xml" 파일에 저장됩니다.

- "nexacro.xml" 파일은 사용자별로 정보를 관리하기 위해 사용하는 XML 형식의 파일입니다.
  Windows 운영체제의 경우 C:\Users\[UserName]\AppData\LocalLow\TOBESOFT\Nexacro N\24 위치에 파일이 생성됩니다.

- 웹브라우저 환경일 경우 브라우저의 Local Storage 영역에 개인화 데이터를 저장합니다.

setProtocolVar

통신에 사용되는 Protocol 어답터에 설정값을 전달하는 메소드입니다.

지원 환경

문법

nexacro.setProtocolVar(strName, strKey, strValue) ;

파라미터

setRenderingType

Windows NRE에서 렌더링 방식을 설정하는 메소드입니다.

지원 환경

문법

nexacro.setRenderingType( nType )

파라미터

nexacro.setRenderingType( 1 );

참고

- Windows NRE 만 사용할 수 있는 메소드입니다.

- 화면의 복잡도가 높아 표시되어야 할 내용이 많은 경우 성능을 위하여 렌더링을 제한할 필요가 있을 때 사용하는 메소드입니다.

- 렌더링을 Event 방식으로 설정 시 다른 작업보다 렌더링 순위가 낮아질 수 있습니다.

setTimeout

일정 시간 이후 콜백 함수를 한 번만 실행하는 타이머 메서드입니다.

지원 환경

문법

nexacro.setTimeout(objContext, objCallbackFunc, nDelay);

파라미터

this.Button00_onclick = function(obj:nexacro.Button,e:nexacro.ClickEventInfo)
{
    nexacro.setTimeout(obj, this.onceCallback, 1000);
};

this.onceCallback = function()
{
    trace(this.id); // Button00
}

활용 예제

• 간단한 틱택토(Tic-Tac-Toe) 게임 만들기

setWheelZoom

지정된 Frame 이 속한 window 의 Zoom 배율을 설정하는 메소드입니다.

지원 환경

문법

nexacro.setWheelZoom( objFrame, nZoomScale)

파라미터

var objFrame = this.getOwnerFrame();

nexacro.setWheelZoom( objFrame, 150 );

참고

- Zoom 배율을 변경하지 않았다면 100 으로 적용됩니다.

- Zoom 기능은 window 단위로 설정 할 수 있습니다.
   따라서, open(), showModalWindow() 등의 메소드로 오픈된 별도의 window 를 갖는 팝업창은 Zoom 배율을 따로 설정하여야 합니다.

- Zoom 배율이 100% 가 아닌 경우 성능이 저하될 수 있으므로 주의하여야 합니다.

- Zoom 기능이 비활성화된 상태에서도 setWheelZoom() 메소드를 사용하여 Zoom 배율을 변경할 수 있습니다.

- Zoom 배율이 적용된 상태에서 Zoom 기능을 비활성화 하여도 적용된 Zoom 배율은 유지됩니다.

stripQuote

인수로 전달된 문자열의 양쪽 끝에서 따옴표를 제거한 후 반환하는 메소드입니다.

지원 환경

문법

nexacro.stripQuote( strText )

파라미터

var strVal = nexacro.stripQuote("\"hello\""); // hello

반환

참고

- 큰따옴표(Double Quotes), 작은따옴표(Single Quotes) 모두 제거하는 메소드입니다.

- 양쪽 끝에 있는 따옴표는 같은 형식이어야 합니다.
  앞쪽에는 큰따옴표가 있고 뒷쪽에는 작은따옴표가 있거나 그 반대라면 메소드는 수행되지 않습니다.

toNumber

인수로 전달된 문자열을 숫자로 변환하여 반환하는 메소드입니다.

지원 환경

문법

nexacro.toNumber( varValue [, varNanVal [, varPinfVal [, varNinfVal]]] )

파라미터

var varNum;
varNum = nexacro.toNumber("123.4");                                          // 123.4
varNum = nexacro.toNumber(Number.NaN, 0);                               // 0
varNum = nexacro.toNumber(Number.POSITIVE_INFINITY, 0, 1);       // 1
varNum = nexacro.toNumber(Number.NEGATIVE_INFINITY, 0, 1, 2);  // 2

반환

trim

인수로 전달된 문자열의 양쪽 끝에서 공백문자 또는 지정된 문자를 제거한 후 반환하는 메소드입니다.

지원 환경

문법

nexacro.trim( strText [,strChar] )

파라미터

var strText = "  abcd  ";
var strText2 = "abcdaa";
var strTrim = nexacro.trim( strText );             // strTrim = abcd
var strTrim = nexacro.trim( strText2 ,"a" );     // strTrim =  bcd

반환

trimLeft

인수로 전달된 문자열의 왼쪽 끝에서 공백문자 또는 지정된 문자를 제거한 후 반환하는 메소드입니다.

지원 환경

문법

nexacro.trimLeft( strText [,strChar] )

파라미터

var ret = nexacro.trimLeft( " nexacro" );     // ret = "nexacro"

반환

trimRight

인수로 전달된 문자열의 오른쪽 끝에서 공백문자 또는 지정된 문자를 제거한 후 반환하는 메소드입니다.

지원 환경

문법

nexacro.trimRight( strText [,strChar] )

파라미터

var ret = nexacro.trimLeft( "nexacro  " );     // ret = "nexacro"

반환

wrapQuote

인수로 전달된 문자열의 양쪽 끝에 큰따옴표를 붙여 반환하는 메소드입니다.

지원 환경

문법

nexacro.wrapQuote( strText )

파라미터

var strVal = nexacro.wrapQuote("hello"); // "hello"

반환