개요

Grid 에 표시되는 내용을 엑셀 또는 한셀 파일로 Export 하는 오브젝트입니다.

지원 환경

속성

commandversion

Export 시 데이터 인코딩 방식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

ExcelExportObject.commandversion [=enumVersion]

문법 설정

enumVersion ::= "1.0" | "2.0" | "3.0"

this.ExcelExportObject00.commandversion = "2.0";

참고

- commandversion 속성을 설정하지 않으면 "1.0"으로 적용됩니다.

commcompress

Export 를 위해 서버와 통신 시 PostData 를 압축할 지 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

enumComp ::= 'none' | 'compress'

참고

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

commdataformat

Export를 위해 데이터를 서버에 전송 시 사용할 통신형식을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

enumFormat ::= 'xml' | 'ssv' | 'json' | 'binary'

참고

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

exportactivemode

Export 완료 후 생성된 파일을 자동으로 오픈할지 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

enumMode ::= 'noactive' | 'active'

this.ExcelExportObject00.exportactivemode = "active";

참고

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

exporteventtype

Export 진행중 정보가 표시되는 방식과 onprogress 이벤트 발생 방식을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

enumEventtype ::= 'none' | 'item' | 'totalrecord' | 'itemrecord'

참고

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

- exportuitype 속성값이 "statusbar" 이면 StatusBar 의 ProgressBar 를 사용합니다.
  exportuitype 속성값이 "exportprogress" 이면 화면 중앙에 표시되는 ProgressBar 를 사용합니다.

exportfilename

Export 완료 후 생성될 파일명을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

this.ExcelExportObject00.exportfilename = "ExportFile";

참고

- exportfilename 속성값을 설정하지 않으면 ExcelExportObject 에 추가된 Item 중 첫번째 Grid 의 id 값이 적용됩니다.

- Windows NRE 환경일 때 exportfilepath 속성값을 설정하면 경로선택 팝업창이 표시되지 않습니다.

활용 예제

• Grid를 엑셀 파일로 내보내기(익스포트)

exportfilepassword

Export 완료 후 생성될 파일에 적용될 암호를 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

this.ExcelExportObject00.exportfilepassword = "password";

exportfilepath

Export 완료 후 파일이 생성될 위치를 절대경로로 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

this.ExcelExportObject00.exportfilepath = "C:\\";
this.ExcelExportObject00.exportfilepath = "C:\\Users\\[UserID]\\Downloads";
this.ExcelExportObject00.exportfilepath = "%MYDOCUMENT%";

참고

- exportfilepath 속성값 설정 시 경로선택 팝업창 없이 exportfilename 속성값을 파일명으로 해당 위치에 Excel 파일을 Export 합니다.

- 샌드박스(SandBox) 옵션인 Environment 의 filesecurelevel 속성값이 "all" 인 경우는 모든 경로에 접근을 허용합니다.
   이 경우 사용자에게 접근 허용 여부를 확인 한 후 사용자가 승인한 경우에만 파일이 생성됩니다.

- strFilePath 에 사용할 수 있는 Alias 의 실제경로입니다.



  * %USERAPP% : 애플리케이션에서 할당받은 공간, 다른 애플리케이션 접근불가

exportmessagealert

Export 전 표시되는 경고 대화상자에 출력될 텍스트를 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

this.ExcelExportObject00.exportmessagealert = "Export Start";

참고

- exportmessagealert 속성값을 설정하지 않으면 경고 대화상자가 표시되지 않습니다.

exportmessagecomplete

exportuitype 속성값이 "exportprogress" 일 때 Export 가 완료되면 진행바에 표시될 텍스트를 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

this.ExcelExportObject00.exportmessagecomplete = "Export Completed";

참고

- 모든 Item 의 Export 가 완료되어 onsuccess 이벤트가 발생되기 전에 표시됩니다.

- exportuitype 속성값이 "exportprogress" 일 때만 진행바에 표시됩니다.

exportmessageprocess

exportuitype 속성값이 "exportprogress" 일 때 Export 진행중 진행바에 표시될 텍스트의 형식을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

this.ExcelExportObject00.exportmessageprocess = "%d Item, %d Record / %d Total";

참고

- exportuitype 속성값이 "exportprogress" 일 때만 표시됩니다.

- exportmessageprocess 속성값을 설정하지 않으면 진행바에 텍스트가 표시되지 않습니다.

- onprogress 이벤트가 정의되지 않아도 exporteventtype 속성값 기준으로 onprogress 이벤트 발생시점에 텍스트가 업데이트 됩니다.

exportmessageready

exportuitype 속성값이 "exportprogress" 일 때 Export 진행 전 진행바에 표시될 텍스트를 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

this.ExcelExportObject00.exportmessageready = "Export Ready";

참고

- exportuitype 속성값이 "exportprogress" 일 때만 진행바에 표시됩니다.

exporttype

ExcelExportObject 을 Export 하여 생성할 파일의 형식을 상수값으로 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

this.ExcelExportObject00.exporttype = nexacro.ExportTypes.EXCEL2007;
this.ExcelExportObject00.exporttype = 1040;

참고

- exporttype 속성값을 설정하지 않거나 null 설정 시 256 (0x0100) 으로 적용됩니다.

- 설정된 파일형식에 맞게 ExportItem 객체의 range 속성값을 설정하여야 합니다.

exportuitype

Export 시 진행상태를 표시하는 방식을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

enumExportUI ::= 'none' | 'statusbar' | 'exportprogress'

참고

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

- Export 시 ProgressBar 에 표시되는 내용은 exporteventtype 속성값에 따라 달라집니다.

exporturl

ExcelExportObject 의 Export 를 수행할 서버의 URL을 설정하는 속성입니다.

지원 환경

속성 타입

문법

ExcelExportObject.exporturl[= strExporturl]

문법 설정

strExporturl ::= <absolute-url> | <relative-url>

this.ExcelExportObject00.exporturl = "http://localhost:8080/nexacro-xeni/XExportImport";

참고

- exporturl 속성값을 설정하지 않으면 Export 가 수행되지 않습니다.

활용 예제

• Grid를 엑셀 파일로 내보내기(익스포트)

exportwordwrap

Export 시 Cell 에 텍스트 줄바꿈 설정을 적용할지 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

bWordWrap ::= 'true' | 'false'

this.ExcelExportObject00.exportwordwrap = false;

참고

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

filefilter

Export 시 생성될 파일을 설정하는 파일선택창에 적용될 파일형식을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

this.ExcelExport00.filefilter = "All(*.*)|*.*|Text Files(*.txt)|*.txt|";
this.ExcelExport00.filefilter = "Excel Files(*.xlsx)|*.xls;*.xlsx|Word Files(*.docx)|*.doc;*.docx|ALL Files(*.*)|*.*|";

참고

- filefilter 속성값을 설정하지 않으면 exporttype 속성에 설정된 파일형식과 "All" 형식이 적용됩니다.

- exportfilepath 속성을 설정하지 않아야 파일선택창이 표시됩니다.
   exportfilepath 속성 설정 시 파일선택창이 표시되지 않고 속성값에 맞게 파일이 Export 됩니다.

- 파일형식이 여러개 일 경우 파일선택창에 기본으로 표시될 파일형식을 filefilterindex 속성에 인덱스값으로 설정합니다.
   인덱스는 0 부터 시작하며 첫번째 파일형식부터 차례로 설정됩니다.

filefilterindex

파일선택창에 기본으로 표시될 파일형식을 인덱스값으로 설정하는 속성입니다.

지원 환경

속성 타입

문법

ExcelExportObject.filefilterindex[= nIndex]

문법 설정

this.ExcelExportObject00.filefilterindex = 1;

참고

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

- 파일선택창에 표시되는 파일형식은 filefilter 속성에 설정합니다.
   파일형식의 인덱스는 0 부터 시작하며 첫번째 파일형식부터 차례로 인덱스가 설정됩니다.

name

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

지원 환경

속성 타입

문법

ExcelExportObject.name[= strName]

문법 설정

참고

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

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

quotechar

Export 시 한정자로 사용할 값을 설정하는 속성입니다.

지원 환경

속성 타입

문법

ExcelExportObject.quotechar[= strQuotechar]

문법 설정

this.ExcelExportObject00.quotechar = "'";

참고

- default 값은 "default" 입니다.
  유효하지 않은 값을 입력할 경우에는 속성값은 "default" 값으로 처리합니다.
  "default" 값으로 설정한 경우에는 XENI 텍스트 한정자 설정값에 따라 동작합니다.

separator

Export 시 구분자로 사용할 값을 설정하는 속성입니다.

지원 환경

속성 타입

문법

ExcelExportObject.separator[= strSeparator]

문법 설정

this.ExcelExportObject00.separator = "0x1E";

참고

- default 값은 ","로 처리합니다.
  유효하지 않은 값을 입력할 경우에도 default 값으로 처리합니다.
- exporttype 속성값이 nexacro.ExportTypes.TXT 인 경우에만 유효합니다.

transferrowcount

Export 시 서버에 분할하여 전송할 Row 의 갯수를 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

this.ExcelExportObject00.transferrowcount = 1000;

참고

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

- 모든 데이터를 한번에 전송하면 일시적인 화면멈춤 현상이나 진행상태 ProgressBar 의 불규칙한 갱신 현상이 발생할 수 있습니다.

- transferrowcount 속성값은 동일해도 Grid 의 Column 갯수에 따라 한번에 전송하는 데이터의 크기가 달라집니다.
   따라서, 한번에 전송할 데이터의 크기를 고려하여 transferrowcount 속성을 설정하여야 합니다.

- 동일한 데이터일 때 transferrowcount 속성값에 따라 Export 시 성능차이가 발생할 수 있습니다.

- transferrowcount 속성을 설정하면 비동기 방식으로 분할 전송이 진행됩니다.
   분할 전송이 진행되는 동안 Grid 속성이나 Dataset 의 데이터 변경 시 Export 데이터에 반영될 수 있으므로 주의하여야 합니다.
   예를 들어 exportData(), exportDataEx() 메소드 다음에 Grid 의 formatid 속성 변경 시 분할된 데이터의 포맷이 변경될 수 있습니다.

메서드

addEvent

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

지원 환경

문법

ExcelExportObject.addEvent( strEventID )

파라미터

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

반환

참고

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

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

addEventHandler

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

지원 환경

문법

ExcelExportObject.addEventHandler( strEventID, objFunc, objTarget )

파라미터

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

반환

활용 예제

• Grid를 엑셀 파일로 내보내기(익스포트)

addEventHandlerLookup

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

지원 환경

문법

ExcelExportObject.addEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

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

반환

참고

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

addExportItem

Export 할 Item을 ExcelExportObject 에 추가하는 메소드입니다.

지원 환경

문법

ExcelExportObject.addExportItem( constExportItemType, objExportItem )
ExcelExportObject.addExportItem( constExportItemType, varExportSource, strRange [,strExportHead [,strExportSelect [,strExportMerge [,strExportValue [,strExportImage [,strExceptStyle [,strExportSize [,arrCellIndex, [strBandId]]]]]]]]])

파라미터

var nIndex;
nIndex = this.ExcelExportObject00.addExportItem( nexacro.ExportItemTypes.GRID, ExportItem00 );

nIndex = this.ExcelExportObject00.addExportItem( nexacro.ExportItemTypes.GRID, this.Grid00, "Sheet1!A1" );
nIndex = this.ExcelExportObject00.addExportItem( nexacro.ExportItemTypes.GRID, this.Grid00, "Sheet1!A1", "nohead");
nIndex = this.ExcelExportObject00.addExportItem( nexacro.ExportItemTypes.GRID, this.Grid00, "Sheet1!A1", "allband", "selectrecord");
nIndex = this.ExcelExportObject00.addExportItem( nexacro.ExportItemTypes.GRID, this.Grid00, "Sheet1!A1", "allband", "allrecord", "nosuppress");
nIndex = this.ExcelExportObject00.addExportItem( nexacro.ExportItemTypes.GRID, this.Grid00, "Sheet1!A1", "allband", "allrecord", "suppress", "allstyle", "none", "color", "both");
nIndex = this.ExcelExportObject00.addExportItem( nexacro.ExportItemTypes.GRID, this.Grid00, "Sheet1!A1", "allband", "allrecord", "suppress", "allstyle", "none", "color", "both", [1, 5] );
nIndex = this.ExcelExportObject00.addExportItem( nexacro.ExportItemTypes.GRID, this.Grid00, "Sheet1!A1", "allband", "allrecord", "suppress", "allstyle", "none", "color", "both", [1, 5], "head" );

반환

참고

- Export 정보를 설정한 ExportItem 오브젝트 또는 Export 정보를 파라미터로 전달하여 Item 을 추가할 수 있습니다.
- arrCellIndex 파라미터 설정 시 Export 값의 일관성을 위하여 exportDataEx() 메서드를 사용하는 것을 권장합니다.

* 스타일 처리 시 주의 사항
생성할 파일 특성에 따라 일부 스타일 속성이 화면과 다르게 처리될 수 있습니다.

- -nexa-border 속성은 처리되지 않습니다.
- background 속성에 Gradation 이 지정된 경우 Gradation의 중간값(50% 위치값) 색상으로 처리됩니다.
- 색상값을 RGBA, HSLA 형태로 설정한 경우 Alpha 값은 무시하고 RGB, HSL 형태로 처리됩니다. 단, Alpha 값이 0인 경우에는 투명색(transparent)으로 처리됩니다.
- font-family 스타일 속성이 2개 이상이면 마지막에 정의된 font로 처리됩니다.
  font-family는 CSS 속성이며 HTML에서만 적용할 수 있습니다. 
  Excel의 경우 셀에 하나의 폰트만 적용할 수 있어 font-family 스타일을 그대로 적용할 수는 없습니다.
  (HTML은 웹브라우저에서 사용자 PC에 설치된 폰트 정보를 확인하고 font-family 속성을 적용합니다.
  하지만, ExcelExportObject 오브젝트는 서버에서 Excel 파일을 생성하는 형식이기 때문에 사용자 PC에 설치된 폰트 정보를 알 수는 없습니다).
  때문에 넥사크로 애플리케이션에 적용된 font-family 정보를 엑셀로 전환 시 마지막에 정의된 폰트 정보만 적용하고 있습니다.

활용 예제

• Grid를 엑셀 파일로 내보내기(익스포트)

• 여러 Grid 데이터를 엑셀 파일로 내보내기

clear

ExcelExportObject 에 추가된 모든 Item 을 삭제하는 메소드입니다.

지원 환경

문법

ExcelExportObject.clear()

파라미터

var nCnt = this.ExcelExportObject00.clear();

반환

clearEventHandler

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

지원 환경

문법

ExcelExportObject.clearEventHandler( strEventID )

파라미터

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

반환

참고

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

clearExportItems

ExcelExportObject 에서 지정한 타입의 Item 만 삭제하는 메소드입니다.

지원 환경

문법

ExcelExportObject.clearExportItems(constExportItemType)

파라미터

var nCnt = this.ExcelExportObject00.clearExportItems( nexacro.ExportItemTypes.GRID );

반환

활용 예제

• 여러 Grid 데이터를 엑셀 파일로 내보내기

count

ExcelExportObject 에 등록된 Item 의 갯수를 반환하는 메소드입니다.

지원 환경

문법

ExcelExportObject.count()

파라미터

var nCnt = this.ExcelExportObject00.count();

반환

countExportItems

ExcelExportObject 에서 지정한 타입의 Item 갯수를 반환하는 메소드입니다.

지원 환경

문법

ExcelExportObject.countExportItems(constExportItemType)

파라미터

var nCnt = this.ExcelExportObject00.countExportItems( nexacro.ExportItemTypes.GRID );

반환

delExportItem

ExcelExportObject 에서 지정한 타입의 특정 Item 을 삭제하는 메소드입니다.

지원 환경

문법

ExcelExportObject.delExportItem(constExportItemType,nItemIndex)

파라미터

var bSucc = this.ExcelExportObject00.delExportItem( nexacro.ExportItemTypes.GRID, 0 );

반환

참고

- Item 의 인덱스값은 addExportItem() 메소드의 반환값을 이용합니다.

destroy

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

지원 환경

문법

ExcelExportObject.destroy()

반환

참고

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

exportData

ExcelExportObject 에 설정된 Item 을 모두 Export 하는 메소드입니다.

지원 환경

문법

ExcelExportObject.exportData( [strParam, strParamDS, nOrgValue, bFileDown] ) ;

파라미터

var nCount = this.ExcelExportObject00.exportData();

반환

참고

- exportmessagealert 속성이 설정되어 있으면 경고창이 닫힌 후 Export 가 시작됩니다. 

- Export 중에는 exporteventtype 속성에 설정된 값에 맞게 이벤트가 발생합니다.

- bFileDown 파라미터를 true 로 설정 시 환경에 따라 다운로드를 위한 팝업창이 표시될 수 있습니다.

- Export 중 에러가 발생한 경우 onerror 이벤트가 발생됩니다.

- Cell 의 displaytype 속성값이 "decoratetext" 일 때 설정된 Tag 는 HTML 형식이므로 Export 시 Decorate 효과가 적용되지 않습니다.
   > valuetypecellindex 속성에 설정된 Cell 은 Tag 가 텍스트로 Export 됩니다.
   > valuetypecellindex 속성에 설정되지 않은 Cell 은 nOrgValue 값에 따라 Tag 가 텍스트로 Export 되거나 Tag 가 제거된 텍스트가 Export 됩니다.

- GridCellControl 에 설정한 CSS 관련 속성값만 Export 시 적용됩니다.

- transferrowcount 속성에 의한 분할 전송은 비동기로 진행됩니다.
   분할 전송이 진행되는 동안 Grid 속성이나 Dataset 의 데이터 변경 시 Export 데이터에 반영될 수 있으므로 주의하여야 합니다.
   예를 들어 exportData() 메소드 다음에 Grid 의 formatid 속성 변경 시 분할된 데이터의 포맷이 변경될 수 있습니다.


◆ web runtime environment 제약

- 웹브라우저에 팝업차단이 설정되어 있을 경우 메소드가 정상적으로 수행되지 않습니다.

활용 예제

• Grid를 엑셀 파일로 내보내기(익스포트)

exportDataEx

Cell 에 표시된 값을 기준으로 ExcelExportObject 에 설정된 Item 을 모두 Export 하는 메소드입니다.

지원 환경

문법

ExcelExportObject.exportDataEx( [strParam, strParamDS, bFileDown] ) ;

파라미터

var nCount = this.ExcelExportObject00.exportDataEx();
var nCount = this.ExcelExportObject00.exportDataEx( "", "", false );

반환

참고

- exportDataEx() 메소드는 Cell 에 표시된 텍스트값을 Export 합니다.
   Cell 에 바인드된 Column 값을 Export 하려면 valuetypecellindex 속성에 해당 Cell 의 인덱스를 설정하여야 합니다.

- valuetypecellindex 속성에 설정된 Cell 은 바인드된 Column 값이 Export 됩니다.
   valuetypecellindex 속성에 설정되지 않은 Cell 은 표시된 텍스트값이 Export 됩니다.

- Cell 의 displaytype 속성값이 "decoratetext" 일 때 설정된 Tag 는 HTML 형식이므로 Export 시 Decorate 효과가 적용되지 않습니다.
   > valuetypecellindex 속성에 설정된 Cell 은 Tag 가 텍스트로 Export 됩니다.
   > valuetypecellindex 속성에 설정되지 않은 Cell 은 Tag 가 제거된 텍스트가 Export 됩니다.

- exportmessagealert 속성이 설정되어 있으면 경고창이 닫힌 후 Export 가 시작됩니다. 

- Export 중에는 exporteventtype 속성에 설정된 값에 맞게 이벤트가 발생합니다.

- Export 중 에러가 발생한 경우 onerror 이벤트가 발생됩니다.

- GridCellControl 에 설정한 CSS 관련 속성값만 Export 시 적용됩니다.

- transferrowcount 속성에 의한 분할 전송은 비동기로 진행됩니다.
   분할 전송이 진행되는 동안 Grid 속성이나 Dataset 의 데이터 변경 시 Export 데이터에 반영될 수 있으므로 주의하여야 합니다.
   예를 들어 exportDataEx() 메소드 다음에 Grid 의 formatid 속성 변경 시 분할된 데이터의 포맷이 변경될 수 있습니다.


◆ web runtime environment 제약

- 웹브라우저에 팝업차단이 설정되어 있을 경우 메소드가 정상적으로 수행되지 않습니다.

exportItems

ExcelExportObject 에서 지정한 타입의 Item 만 Export 하는 메소드입니다.

지원 환경

문법

ExcelExportObject.exportItems(constExportItemType)

파라미터

var nCount = this.ExcelExportObject00.exportItems( nexacro.ExportItemTypes.GRID );

반환

참고

- exportmessagealert 속성이 설정되어 있으면 경고창이 닫힌 후 Export가 시작됩니다. 

- Export 중에는 exporteventtype 속성에 설정된 값에 맞게 이벤트가 발생합니다.

- Export 중 에러가 발생한 경우 onerror 이벤트가 발생됩니다.

- 웹브라우저에 팝업차단이 설정되어 있을 경우 메소드가 정상적으로 수행되지 않습니다.

findEventHandler

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

지원 환경

문법

ExcelExportObject.findEventHandler( strEventID, objFunc, objTarget )

파라미터

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

var nIndex = this.ExcelExportObject00.findEventHandler( "onmove", this.ExcelExportObject00_onmove, this );

반환

참고

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

getEventHandler

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

지원 환경

문법

ExcelExportObject.getEventHandler( strEventID, nIdx )

파라미터

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

반환

getExportItem

ExcelExportObject 에서 지정한 타입의 특정 Item 을 반환하는 메소드입니다.

지원 환경

문법

ExcelExportObject.getExportItem(constExportItemType,nItemIndex)

파라미터

var objExportItem = this.ExcelExportObject00.getExportItem( nexacro.ExportItemTypes.GRID, 0 );

반환

참고

- Item 의 인덱스값은 addExportItem() 메소드의 반환값을 이용합니다.

활용 예제

• Grid의 이미지를 엑셀 파일로 내보내기

insertEventHandler

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

지원 환경

문법

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

파라미터

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

var nIndex = this.ExcelExportObject00.insertEventHandler( "onmove", 0, this.ExcelExportObject00_onmove, this);

반환

참고

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

removeEvent

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

지원 환경

문법

ExcelExportObject.removeEvent( strEventID )

파라미터

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

반환

참고

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

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

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

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

removeEventHandler

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

지원 환경

문법

ExcelExportObject.removeEventHandler( strEventID, objFunc, objTarget )

파라미터

this.ExcelExportObject00_onmove = function( obj:nexacro.ExcelExportObject,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.ExcelExportObject00.removeEventHandler( "onmove", this.ExcelExportObject00_onmove, this);

반환

참고

- 핸들러 함수가 제거되면 핸들러 함수의 인덱스가 0 번부터 재조정됩니다.

- 이벤트에 등록된 핸들러 함수를 모두 제거하려면 clearEventHandler() 메소드를 사용하여야 합니다.

removeEventHandlerLookup

ExcelExportObject 의 특정 이벤트에서 검색된 함수와 동일한 핸들러 함수를 제거하는 메소드입니다.

지원 환경

문법

ExcelExportObject.removeEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

this.ExcelExportObject00_onmove = function( obj:nexacro.ExcelExportObject,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.ExcelExportObject00.removeEventHandlerLookup( "onmove", "ExcelExportObject00_onmove", this);

반환

참고

- 핸들러 함수가 제거되면 핸들러 함수의 인덱스가 0 번부터 재조정됩니다.

- 이벤트에 등록된 핸들러 함수를 모두 제거하려면 clearEventHandler() 메소드를 사용하여야 합니다.

setEventHandler

ExcelExportObject 의 특정 이벤트에서 첫번째 핸들러 함수를 변경하는 메소드입니다.

지원 환경

문법

ExcelExportObject.setEventHandler( strEventID, objFunc, objTarget )

파라미터

this.ExcelExportObject00_onmove = function( obj:nexacro.ExcelExportObject,  e:nexacro.MoveEventInfo ) { //수행할 스크립트 };
var nIndex = this.ExcelExportObject00.setEventHandler( "onmove", this.ExcelExportObject00_onmove, this );

반환

참고

- 인덱스가 0 번인 핸들러 함수를 새로운 함수로 대체합니다.

- 인덱스가 0 번인 핸들러 함수가 없다면 0 번 인덱스에 새로운 함수를 핸들러 함수로 추가합니다.

setEventHandlerLookup

ExcelExportObject 의 특정 이벤트에서 첫번째 핸들러 함수를 검색된 함수로 변경하는 메소드입니다.

지원 환경

문법

ExcelExportObject.setEventHandlerLookup( strEventID, strFunc, objTarget )

파라미터

this.ExcelExportObject00_onmove = function( obj:nexacro.ExcelExportObject,  e:nexacro.MoveEventInfo) { // 수행할 스크립트 };
var nIndex = this.ExcelExportObject00.setEventHandlerLookup( "onmove", "ExcelExportObject00_onmove", this);

반환

참고

- 인덱스가 0 번인 핸들러 함수를 검색된 함수로 대체합니다.

- 인덱스가 0 번인 핸들러 함수가 없다면 0 번 인덱스에 검색된 함수를 핸들러 함수로 추가합니다.

setExportItem

Export 할 Item을 ExcelExportObject 의 특정 위치에 추가하는 메소드입니다.

지원 환경

문법

ExcelExportObject.setExportItem( constExportItemType,nItemIndex,objExportItem )

파라미터

var bSucc = this.ExcelExportObject00.setExportItem( nexacro.ExportItemTypes.GRID, 0, this.ExportItem00 );

반환

활용 예제

• Grid의 이미지를 엑셀 파일로 내보내기

이벤트

onerror

Export 도중 오류가 생겼을때 발생하는 이벤트입니다.

지원 환경

문법

onerror(obj:nexacro.ExcelExportObject,e:nexacro.ExcelExportErrorEventInfo);

파라미터

참고

- onerror 이벤트가 발생하면 Export 기능이 종료됩니다.

onprogress

Export 도중 진행상태에 따라 발생하는 이벤트입니다.

지원 환경

문법

onprogress(obj:nexacro.ExcelExportObject,e:nexacro.ExcelExportProgressEventInfo);

파라미터

참고

- exporteventtype 속성값이 "none" 이면 onprogress 이벤트는 발생하지 않습니다.
  exporteventtype 속성값이 "item" 이면 Item 의 Export 가 완료되었을 때 onprogress 이벤트가 발생합니다.
  exporteventtype 속성값이 "totalrecord" 이면 각 Record 마다 Export 될 때 onprogress 이벤트가 발생합니다.
  exporteventtype 속성값이 "itemrecord" 이면 Item 의 Export 가 완료되었을 때와 Item 의 각 Record 마다 Export 될 때 onprogress 이벤트가 발생합니다.

onsuccess

모든 Export 가 완료되었을때 발생하는 이벤트입니다.

지원 환경

문법

onsuccess(obj:nexacro.ExcelExportObject,e:nexacro.ExcelExportEventInfo);

파라미터

참고

- 모든 Export 가 성공적으로 완료되었을때 발생합니다.

- exporteventtype 속성값과 관계없이 이벤트가 발생합니다.