개요
엑셀 또는 한셀 파일의 내용을 DataSet 에 Import 하는 오브젝트입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
속성
commandversion
Import 시 데이터 인코딩 방식을 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☐ macOS | ☐ Edge | ☐ Chrome | ☐ Safari | ☐ Firefox | ☐ Opera |
Mobile NRE | Mobile WRE | |||||
☐ Android | ☐ iOS/iPadOS | ☐ Android | ☐ iOS/iPadOS | |||
속성 타입
☑ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법
ExcelImportObject.commandversion [=enumVersion]
문법 설정
enumVersion ::= "1.0" | "2.0" | "3.0" | ||
this.ExcelImportObject00.commandversion = "2.0"; | ||
"1.0" | 인코딩 처리를 하지 않습니다. | |
|---|---|---|
"2.0" | Base32로 인코딩합니다. | |
"3.0" | Base64로 인코딩합니다. | |
참고
- commandversion 속성을 설정하지 않으면 "1.0"으로 적용됩니다.
commdataformat
Import를 위해 데이터를 서버에 전송 시 사용할 통신형식을 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☑ Enum | ☐ Expr | ☐ Control | ☑ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
enumFormat ::= 'xml' | 'ssv' | 'json' | ||
"xml" | XML 형식으로 데이터를 전송합니다. | |
|---|---|---|
"ssv" | SSV 형식으로 데이터를 전송합니다. | |
"json" | JSON 형식으로 데이터를 전송합니다. | |
참고
- commdataformat 속성값을 설정하지 않으면 "xml" 로 적용됩니다.
filefilter
Import 할 파일을 선택하는 파일선택창에 적용될 파일형식을 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☐ macOS | ☐ Edge | ☐ Chrome | ☐ Safari | ☐ Firefox | ☐ Opera |
Mobile NRE | Mobile WRE | |||||
☐ Android | ☐ iOS/iPadOS | ☐ Android | ☐ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
this.ExcelImport00.filefilter = "All(*.*)|*.*|Text Files(*.txt)|*.txt|"; this.ExcelImport00.filefilter = "Excel Files(*.xlsx)|*.xls;*.xlsx|Word Files(*.docx)|*.doc;*.docx|ALL Files(*.*)|*.*|"; | ||
strFileFilter | 파일선택창에 적용될 파일형식을 "설명|확장자" 형식으로 설정합니다. "|" 문자를 구분자로 하여 설명과 실제 확장자를 쌍으로 여러개의 파일형식을 설정할 수 있습니다. 한 개의 파일형식내에서 복수개의 확장자를 지정할 때는 "*.xlsx;*.xls" 와 같이 ";" 문자로 구분하여 설정합니다. | |
|---|---|---|
참고
- filefilter 속성값을 설정하지 않으면 빈문자열이 설정되고, "All(*.*)|*.*|" 로 동작합니다. - importfilemode 속성값이 "local" 이거나 importData(), importDataEx() 메소드의 strSource 파라미터값을 설정하지 않았을 경우 파일선택창이 표시됩니다. - 파일형식이 여러개 일 경우 파일선택창에 기본으로 표시될 파일형식을 filefilterindex 속성에 인덱스값으로 설정합니다. 인덱스는 0 부터 시작하며 첫번째 파일형식부터 차례로 설정됩니다.
filefilterindex
파일선택창에 기본으로 표시될 파일형식을 인덱스값으로 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☐ macOS | ☐ Edge | ☐ Chrome | ☐ Safari | ☐ Firefox | ☐ Opera |
Mobile NRE | Mobile WRE | |||||
☐ Android | ☐ iOS/iPadOS | ☐ Android | ☐ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법
ExcelImportObject.filefilterindex[= nIndex]
문법 설정
this.ExcelImportObject00.filefilterindex = 1; | ||
nIndex | 파일선택창에 설정된 파일형식 중 기본으로 표시될 파일형식의 인덱스를 숫자로 설정합니다. | |
|---|---|---|
참고
- filefilterindex 속성값을 설정하지 않으면 0 으로 적용됩니다. - 파일선택창에 표시되는 파일형식은 filefilter 속성에 설정합니다. 파일형식의 인덱스는 0 부터 시작하며 첫번째 파일형식부터 차례로 인덱스가 설정됩니다.
importfilemode
Import 할 파일의 위치와 처리방식을 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
속성 타입
☑ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
enumMode ::= 'server' | 'local' | ||
"server" | 서버에 위치한 파일을 Import 하며 Import 후에도 해당 파일을 삭제하지 않습니다. 서버에 해당 파일이 없는 경우나 Local이나 Network File을 지정하는 경우, Import 가 처리되지 않고 결과를 수신받습니다. | |
|---|---|---|
"local" | 파일 대화 상자(File Dialog)를 표시해 로컬에 위치한 파일을 선택합니다. 로컬에 위치한 파일을 서버로 전송해 Import 처리하며 Import 처리 후에 서버에 생성된 파일은 삭제됩니다. | |
참고
- importfilemode 속성값을 설정하지 않으면 "local" 로 적용됩니다.
importtype
ExcelImportObject 가 Import 할 파일의 형식을 상수값으로 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
this.ExcelImportObject00.importtype = nexacro.ImportTypes.EXCEL2007; this.ExcelImportObject00.importtype = 1040; | ||
constImportTypes | Import 할 파일의 형식을 상수값으로 설정합니다. 256 (0x0100) 또는 nexacro.ImportTypes.EXCEL 설정 시 엑셀 97 형식으로 Import 합니다. 272 (0x0110) 또는 nexacro.ImportTypes.EXCEL97 설정 시 엑셀 97~2003 형식으로 Import 합니다. 288 (0x0120) 또는 nexacro.ImportTypes.EXCEL2007 설정 시 엑셀 2007 XML 형식으로 Import 합니다. 1040 (0x0410) 또는 nexacro.ImportTypes.HANCELL2014 설정 시 한셀 2014 형식으로 Import 합니다. 1280 (0x0500) 또는 nexacro.ImportTypes.CSV 설정 시 CSV 형식으로 Import 합니다. 1296 (0x0510) 또는 nexacro.ImportTypes.TXT 설정 시 TXT 형식으로 Import 합니다. | |
|---|---|---|
참고
- importtype 속성값을 설정하지 않거나 null 설정 시 256 (0x0100) 으로 적용됩니다. - 한셀 2010 형식은 현재 지원되지 않습니다. Excel 2007 파일로 저장해서 사용하시기 바랍니다.
활용 예제
importurl
ExcelImportObject 가 Import 를 수행할 서버의 URL 을 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법
ExcelImportObject.importurl[= strImporturl]
문법 설정
strImporturl ::= <absolute-url> | <relative-url> | ||
this.ExcelImportObject00.importurl = "https://localhost:8080/nexacro-xeni/XImport"; | ||
<absolute-url> | Import 를 수행할 서버의 URL 을 문자열로 설정합니다. 웹에 접근 가능한 환경이어야 하고, Cross Domain 상황이면 사용에 제한이 있습니다. | |
|---|---|---|
<relative-url> | 현재 Form 위치를 기준으로 한 상대경로를 사용하여 설정합니다. | |
참고
- importurl 속성값을 설정하지 않으면 Import 가 수행되지 않습니다.
활용 예제
name
ExcelImportObject 의 이름을 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☑ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법
ExcelImportObject.name[= strName]
문법 설정
strName | 컴포넌트의 이름을 설정합니다. | |
|---|---|---|
참고
- name 속성은 사용자가 지정한 컴포넌트의 이름으로 논리적으로 중복이 가능합니다. - 넥사크로 스튜디오에서 컴포넌트를 생성하거나 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.
quotechar
Import 시 한정자로 사용할 값을 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☑ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법
ExcelImportObject.quotechar[= strQuotechar]
문법 설정
this.ExcelImportObject00.quotechar = "'"; | ||
strQuotechar | 구분자로 분리되는 항목 중 분리하지 않을 부분을 처리하기 위한 텍스트 한정자를 설정합니다. " (quotation mark), ' (apostrophe), "none", "default" 값을 설정할 수 있습니다. | |
|---|---|---|
참고
- default 값은 "default" 입니다. 유효하지 않은 값을 입력할 경우에는 속성값은 "default" 값으로 처리합니다. "default" 값으로 설정한 경우에는 XENI 텍스트 한정자 설정값에 따라 동작합니다.
separator
Import 시 구분자로 사용할 값을 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☑ iOS/iPadOS | ☑ Android | ☑ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법
ExcelImportObject.separator[= strSeparator]
문법 설정
this.ExcelImportObject00.separator = "0x1E"; | ||
strSeparator | 컬럼을 구분을 문자를 설정합니다. 10진수 또는 16진수로 설정할 수 있습니다. (16진수인 경우에는 0xXX, 0XXX의 형태로 입력해야 합니다). 0x00(0) ~ 0x7F(127) 범위의 ASCII 문자를 하나만 설정할 수 있습니다. 단, 아래 문자는 설정할 수 없습니다. 0x0A(10) - LF(Line Feed) 0x0D(13) - CR(Carriage Return) 0x22(34) - " (quotation mark) 0x27(39) - ' (apostrophe) 0x00(00) - NUL (Null char.) 0x03(03) - ETX (End of Text) 0x1D(29) - GS (Group Separator) 0x28(40) - ( (left opening parenthesis) 0x29(41) - ) (right closing parenthesis) 0x3A(58) - : (colon) 0x3D(61) - = (equal sign) | |
|---|---|---|
참고
- default 값은 ","로 처리합니다. 유효하지 않은 값을 입력할 경우에도 default 값으로 처리합니다. - importtype 속성값이 nexacro.ImportTypes.TXT 인 경우에만 유효합니다.
userawdatevalue
엑셀의 셀값이 날짜 또는 시간 계열일 때 원본값 그대로 Import 할지 여부를 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
bRawDate ::= 'true' | 'false' | ||
this.ExcelImportObject00.userawdatevalue = true; | ||
true | 엑셀의 셀에 설정된 원본 데이터값만 Import 합니다. 셀의 표시형식에 따른 서식은 Import 하지 않습니다. | |
|---|---|---|
false | 엑셀의 셀에 표시된 값을 Import 합니다. 셀의 표시형식에 따른 서식을 반영하여 Import 합니다. | |
참고
- userawdatevalue 속성을 설정하지 않으면 false 로 적용됩니다. - userawdatevalue 속성은 엑셀의 셀 표시형식이 "날짜", "시간" 형식인 경우에 적용되는 속성입니다.
userawnumbervalue
엑셀의 셀값이 숫자계열일 때 원본값 그대로 Import 할지 여부를 설정하는 속성입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
속성 타입
☐ Enum | ☐ Expr | ☐ Control | ☐ Hidden | ☐ ReadOnly | ☐ Bind | ☐ Collection | ☐ StringResource |
문법 설정
bRawNum ::= 'true' | 'false' | ||
this.ExcelImportObject00.userawnumbervalue = false; | ||
true | 엑셀의 셀에 설정된 원본 데이터값만 Import 합니다. 셀의 표시형식에 따른 서식은 Import 하지 않습니다. | |
|---|---|---|
false | 엑셀의 셀에 표시된 값을 Import 합니다. 셀의 표시형식에 따른 서식을 반영하여 Import 합니다. 셀의 표시형식이 "통화", "회계" 이면 통화기호, 회계기호를 포함하여 Import 합니다. 셀의 표시형식이 "백분율" 이면 "%" 기호를 포함하지 않고 Import 합니다. | |
참고
- userawnumbervalue 속성을 설정하지 않으면 true 로 적용됩니다. - userawnumbervalue 속성은 엑셀의 셀 표시형식이 "숫자", "통화", "회계", "백분율" 등 숫자형식인 경우에 적용되는 속성입니다.
메서드
addEvent
ExcelImportObject 에 특정 이벤트를 선언하여 추가하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
문법
ExcelImportObject.addEvent( strEventID )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | ExcelImportObject 에 추가할 이벤트의 ID 를 문자열로 설정합니다. | |
var bResult = this.ExcelImportObject00.addEvent( "onmove" ); | |||
반환
Type | Description |
|---|---|
Boolean | 이벤트 추가에 성공하면 true 를 반환합니다. 이벤트 추가에 실패하거나 선언되어 있는 이벤트 ID 설정 시 false 를 반환합니다. |
참고
- Composite Component 와 같은 사용자 컴포넌트에 특정 이벤트를 추가할 때 사용하는 메소드입니다. - ExcelImportObject 에서 특정 이벤트를 제거하려면 removeEvent() 메소드를 사용하여야 합니다.
addEventHandler
ExcelImportObject 의 특정 이벤트에 핸들러 함수를 추가하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
문법
ExcelImportObject.addEventHandler( strEventID, objFunc, objTarget )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 핸들러 함수가 추가될 이벤트의 ID를 설정합니다. | |
objFunc | Object | 이벤트 발생 시 수행될 핸들러 함수를 설정합니다. | |
objTarget | Object | 핸들러 함수가 정의된 영역을 설정합니다. | |
this.ExcelImportObject00_onmove = function( obj:nexacro.ExcelImportObject, e:nexacro.MoveEventInfo) { // 수행할 스크립트 }; var nIndex = this.ExcelImportObject00.addEventHandler( "onmove", this.ExcelImportObject00_onmove, this); | |||
반환
Type | Description |
|---|---|
Number | 이벤트에 추가된 핸들러 함수의 인덱스를 반환합니다. 동일한 핸들러 함수가 이미 있다면 해당 핸들러 함수의 인덱스를 반환합니다. 정상적으로 추가되지 않은 경우에는 -1 을 반환합니다. |
활용 예제
addEventHandlerLookup
함수를 검색하여 ExcelImportObject 의 특정 이벤트에 핸들러 함수로 추가하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
문법
ExcelImportObject.addEventHandlerLookup( strEventID, strFunc, objTarget )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 핸들러 함수가 추가될 이벤트의 ID를 설정합니다. | |
strFunc | String | 이벤트 발생 시 수행될 핸들러 함수의 이름을 문자열로 설정합니다. | |
objTarget | Object | 핸들러 함수를 검색할 영역을 설정합니다. 해당 영역에 함수가 정의되지 않았다면 상위 영역으로 올라가며 검색을 합니다. | |
this.ExcelImportObject00_onmove = function( obj:nexacro.ExcelImportObject, e:nexacro.MoveEventInfo) { // 수행할 스크립트 }; var nIndex = this.ExcelImportObject00.addEventHandlerLookup( "onmove", "ExcelImportObject00_onmove", this); | |||
반환
Type | Description |
|---|---|
Number | 이벤트에 추가된 핸들러 함수의 인덱스를 반환합니다. 동일한 핸들러 함수가 이미 있다면 해당 핸들러 함수의 인덱스를 반환합니다. 정상적으로 추가되지 않은 경우에는 "-1"을 반환합니다. |
참고
- strFunc 이름의 함수를 objTarget 영역부터 상위로 올라가며 검색합니다. 검색된 함수가 있다면 이벤트에 핸들러 함수로 추가합니다.
clearEventHandler
특정 이벤트에 등록된 핸들러 함수를 모두 제거하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
문법
ExcelImportObject.clearEventHandler( strEventID )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 모든 핸들러 함수를 제거할 이벤트의 ID를 설정합니다. | |
var nCnt = this.ExcelImportObject00.clearEventHandler( "onmove" ); | |||
반환
Type | Description |
|---|---|
Number | 특정 이벤트에서 제거된 핸들러 함수의 갯수를 반환합니다. |
참고
- 특정 핸들러 함수만 제거하려면 removeEventHandler() 메소드를 사용하여야 합니다.
destroy
스크립트에서 동적으로 생성한 ExcelImportObject 을(를) 삭제하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
문법
ExcelImportObject.destroy()
반환
Type | Description |
|---|---|
Boolean | ExcelImportObject 이(가) 정상적으로 삭제되면 true 를 반환합니다. ExcelImportObject 이(가) 정상적으로 삭제되지 않으면 false 를 반환합니다. |
참고
- 동적으로 생성한 ExcelImportObject 을(를) 완전히 삭제하기 위해서는 destroy() 메소드를 호출해야 합니다.
findEventHandler
ExcelImportObject 의 특정 이벤트에서 핸들러 함수를 찾아 인덱스를 반환하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
문법
ExcelImportObject.findEventHandler( strEventID, objFunc, objTarget )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 핸들러 함수를 찾을 이벤트의 ID를 설정합니다. | |
objFunc | Object | 찾으려고 하는 핸들러 함수를 설정합니다. | |
objTarget | Object | 찾으려고 하는 핸들러 함수가 정의된 영역을 설정합니다. | |
this.ExcelImportObject00_onmove = function( obj:nexacro.ExcelImportObject, e:nexacro.MoveEventInfo ) { //수행할 스크립트 }; var nIndex = this.ExcelImportObject00.findEventHandler( "onmove", this.ExcelImportObject00_onmove, this ); | |||
반환
Type | Description |
|---|---|
Number | 특정 이벤트에서 찾은 핸들러 함수의 인덱스를 반환합니다. 특정 이벤트에 찾으려는 핸들러 함수가 존재하지 않으면 -1 을 반환합니다. |
참고
- 핸들러 함수의 인덱스는 0 부터 시작합니다.
getEventHandler
ExcelImportObject 의 특정 이벤트에서 지정된 인덱스에 해당하는 핸들러 함수를 반환하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
문법
ExcelImportObject.getEventHandler( strEventID, nIdx )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 핸들러 함수를 얻을 이벤트의 ID를 설정합니다. | |
nIdx | Number | 얻으려고 하는 핸들러 함수의 인덱스를 설정합니다. 핸들러 함수의 인덱스는 0 부터 시작합니다. | |
var objFunc = ExcelImportObject00.getEventHandler( "onmove", 0 ); | |||
반환
Type | Description |
|---|---|
Object | 지정된 인덱스의 핸들러 함수 오브젝트를 반환합니다. 지정된 인덱스에 핸들러 함수가 존재하지 않는다면 null 을 반환합니다. |
importData
파일을 DataSet으로 Import 하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
문법
ExcelImportObject.importData( strSource,strRange,strOutDatasets [,strArgument] )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strSource | String | Import 할 파일의 위치를 URL 형식의 문자열로 설정합니다. importfilemode 속성값이 "server" 일 경우 "http://", "https://" 형식으로 파일의 위치를 설정합니다. importfilemode 속성값이 "server" 일 때 상대경로를 설정 시 importurl 속성에 설정된 경로를 기준으로 처리됩니다. importfilemode 속성값이 "local" 이거나 strSource 값을 설정하지 않았을 경우 FileDialog 가 표시되고 파일을 선택합니다. | |
strRange | String | strSource 에 설정한 파일에서 DataSet 으로 Import 할 영역을 "시트명!셀영역:셀영역" 또는 Import 할 파일의 형식이 CSV, TXT 인 경우에 "시작영역:끝영역" 형식으로 설정합니다. 여러 영역을 지정해야 할 경우 아래 형식으로 반복 설정합니다. strRange ::= '[Command=<strCommand>; Output=<dsName>; Head=<strArea>; Body=<strArea>]' <strCommand> ::= 'getsheetlist' | 'getsheetdata' "getsheetlist" 설정 시 strSource 에 설정한 파일에서 시트목록을 Import 합니다. "getsheetdata" 설정 시 strSource 에 설정한 파일에서 <strArea> 의 데이터를 Import 합니다. 값을 생략 할 경우 "getsheetdata"로 적용됩니다. <dsName> Import 한 데이터를 갖는 변수명입니다. strOutDatasets 에서 오른쪽 대입변수로 사용됩니다. 값을 생략 할 경우 "output1", "output2" ... 로 자동설정됩니다. <strArea> ::= '시트명!셀영역:셀영역' Import 할 데이터 영역을 설정합니다. "Head" 항목에 정의된 영역은 Import 시 DataSet 의 Column 명으로 사용됩니다. "Head" 항목 생략 시 "Column0", "Column1" ... 으로 자동설정됩니다. "Body" 항목에 정의된 영역은 DataSet 의 Row 데이터로 Import 됩니다. "Body" 항목 생략 시 모든 레코드가 Import 됩니다. * 시트명을 생략하면 첫 번째 시트가 작업 대상이 됩니다. * 첫 번째 시트가 아닌 다른 시트를 지정하는 경우에는 "Head", "Body" 모두 설정해주어야 합니다. 아래와 같이 설정한 경우에는 Head는 첫 번째 시트에서 처리되고 Body만 지정한 시트에서 처리됩니다. Body에서 설정한 셀영역이 Head에 없는 경우에는 에러가 발생할 수 있습니다. [Command=getData;Output=output2;Body=Sheet2!A1;]
<strCommand> 지원하지 않습니다. <strArea> ::= StartCol[,StartRow[:EndCol[,EndRow]]] "Head" 항목에서 StartRow, EndCol, EndRow를 생략하면 아래와 같이 처리합니다. - StartRow=0, EndCol=ColumnCount-1, EndRow=0 "Head" 항목에서 EndRow 설정값은 무시하고 StartRow 설정값 기준으로 동작합니다. "Body" 항목에서 StartRow, EndCol, EndRow를 생략하면 아래와 같이 처리합니다. - StartRow=0, EndCol=ColumnCount-1, EndRow=RowCount-1 | |
strOutDatasets | String | Import 한 데이터를 저장할 DataSet 의 ID 를 "DataSet명=변수명" 의 형식으로 설정합니다. DataSet 을 1개 이상 설정할 수 있으며 공백으로 구분합니다. 우측의 "변수명" 은 strRange 에 설정한 변수명을 설정하거나 "output1" ... 으로 자동생성된 변수명을 설정합니다. | |
strArgument | String | Import 시 필요한 정보를 "변수명=변수값" 형태로 설정합니다. 파라미터쌍을 1개 이상 설정할 수 있으며 공백으로 구분합니다. 비밀번호가 설정된 엑셀파일을 Import 할 경우 "filepassword=엑셀파일비밀번호" 를 입력해야 정상동작합니다. | |
this.ExcelImportObject00.importData("http://localhost:8080/xeni/XImport/my.xlsx","Sheet00!D15:E28","Dataset03=output1"); this.ExcelImportObject00.importData("","Sheet00!D15:E28","Dataset03=output1","filepassword=strpassword"); this.ExcelImportObject00.importData("", "[Command=getsheetlist;Output=sheetlist][Command=getsheetdata;Output=output1;Head=!A1:K1;Body=!A2:K15][Output=output2; Body=Sheet1!B7:Z207]", "ds_list=sheetlist, ds_Data1=output1, ds_Data2=output2"); | |||
참고
- Import 중 ESC 키를 입력하면 Import 를 중지시킬 수 있습니다. - Local 에 위치한 파일을 importurl 속성에 설정된 서버로 보낸 후 트랜잭션처럼 DataSet 으로 수신받습니다. - importDataEx() 메소드와의 차이는 Import 를 구분할 수 있는 ID 파라미터의 유무입니다. - Import 할 파일에 포함된 개체(이미지, 차트, 수식 등)는 Import 대상에 포함하지 않으며 개체가 포함된 경우 개체는 무시하고 처리합니다.
활용 예제
importDataEx
ID 로 구분하여 파일을 DataSet 으로 Import 하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
문법
ExcelImportObject.importDataEx( strImportID, strSource,strRange,strOutDatasets [,strArgument] )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strImportID | String | Import 를 구분하기 위한 ID 를 문자열로 설정합니다. 설정값은 onsuccess 이벤트에서 ExcelImportEventInfo 오브젝트의 importid 속성으로 전달됩니다. | |
strSource | String | Import 할 파일의 위치를 URL 형식의 문자열로 설정합니다. importfilemode 속성값이 "server" 일 경우 "http://", "https://" 형식으로 파일의 위치를 설정합니다. importfilemode 속성값이 "server" 일 때 상대경로를 설정 시 importurl 속성에 설정된 경로를 기준으로 처리됩니다. importfilemode 속성값이 "local" 이거나 strSource 값을 설정하지 않았을 경우 FileDialog 가 표시되고 파일을 선택합니다. | |
strRange | String | strSource 에 설정한 파일에서 DataSet 으로 Import 할 영역을 "시트명!셀영역:셀영역" 또는 Import 할 파일의 형식이 CSV, TXT 인 경우에 "시작영역:끝영역" 형식으로 설정합니다. 여러 영역을 지정해야 할 경우 아래 형식으로 반복 설정합니다. strRange ::= '[Command=<strCommand>; Output=<dsName>; Head=<strArea>; Body=<strArea>]' <strCommand> ::= 'getsheetlist' | 'getsheetdata' "getsheetlist" 설정 시 strSource 에 설정한 파일에서 시트목록을 Import 합니다. "getsheetdata" 설정 시 strSource 에 설정한 파일에서 <strArea> 의 데이터를 Import 합니다. 값을 생략 할 경우 "getsheetdata"로 적용됩니다. <dsName> Import 한 데이터를 갖는 변수명입니다. strOutDatasets 에서 오른쪽 대입변수로 사용됩니다. 값을 생략 할 경우 "output1", "output2" ... 로 자동설정됩니다. <strArea> ::= '시트명!셀영역:셀영역' Import 할 데이터 영역을 설정합니다. "Head" 항목에 정의된 영역은 Import 시 DataSet 의 Column 명으로 사용됩니다. "Head" 항목 생략 시 "Column0", "Column1" ... 으로 자동설정됩니다. "Body" 항목에 정의된 영역은 DataSet 의 Row 데이터로 Import 됩니다. "Body" 항목 생략 시 모든 레코드가 Import 됩니다. * 시트명을 생략하면 첫 번째 시트가 작업 대상이 됩니다. * 첫 번째 시트가 아닌 다른 시트를 지정하는 경우에는 "Head", "Body" 모두 설정해주어야 합니다. 아래와 같이 설정한 경우에는 Head는 첫 번째 시트에서 처리되고 Body만 지정한 시트에서 처리됩니다. Body에서 설정한 셀영역이 Head에 없는 경우에는 에러가 발생할 수 있습니다. [Command=getData;Output=output2;Body=Sheet2!A1;]
<strCommand> 지원하지 않습니다. <strArea> ::= StartCol[,StartRow[:EndCol[,EndRow]]] "Head" 항목에서 StartRow, EndCol, EndRow를 생략하면 아래와 같이 처리합니다. - StartRow=0, EndCol=ColumnCount-1, EndRow=0 "Head" 항목에서 EndRow 설정값은 무시하고 StartRow 설정값 기준으로 동작합니다. "Body" 항목에서 StartRow, EndCol, EndRow를 생략하면 아래와 같이 처리합니다. - StartRow=0, EndCol=ColumnCount-1, EndRow=RowCount-1 | |
strOutDatasets | String | Import 한 데이터를 저장할 DataSet 의 ID 를 "DataSet명=변수명" 의 형식으로 설정합니다. DataSet 을 1개 이상 설정할 수 있으며 공백으로 구분합니다. 우측의 "변수명" 은 strRange 에 설정한 변수명을 설정하거나 "output1" ... 으로 자동생성된 변수명을 설정합니다. | |
strArgument | String | Import 시 필요한 정보를 "변수명=변수값" 형태로 설정합니다. 파라미터쌍을 1개 이상 설정할 수 있으며 공백으로 구분합니다. 비밀번호가 설정된 엑셀파일을 Import 할 경우 "filepassword=엑셀파일비밀번호" 를 입력해야 정상동작합니다. | |
this.ExcelImportObject00.importDataEx("Import00", "http://localhost:8080/xeni/XImport/my.xlsx","Sheet00!D15:E28","Dataset03=output1"); this.ExcelImportObject00.importDataEx("Import01", "","Sheet00!D15:E28","Dataset03=output1","filepassword=strpassword"); this.ExcelImportObject00.importDataEx("Import02", "", "[Command=getsheetlist;Output=sheetlist][Command=getsheetdata;Output=output1;Head=!A1:K1;Body=!A2:K15][Output=output2; Body=Sheet1!B7:Z207]", "ds_list=sheetlist, ds_Data1=output1, ds_Data2=output2"); | |||
참고
- Import 중 ESC 키를 입력하면 Import 를 중지시킬 수 있습니다. - Local 에 위치한 파일을 importurl 속성에 설정된 서버로 보낸 후 트랜잭션처럼 DataSet 으로 수신받습니다. - importData() 메소드와의 차이는 Import 를 구분할 수 있는 ID 파라미터의 유무입니다. - Import 할 파일에 포함된 개체(이미지, 차트, 수식 등)는 Import 대상에 포함하지 않으며 개체가 포함된 경우 개체는 무시하고 처리합니다.
insertEventHandler
ExcelImportObject 의 특정 이벤트에 핸들러 함수를 지정한 위치에 삽입하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
문법
ExcelImportObject.insertEventHandler( strEventID, nIndex, objFunc, objTarget )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 핸들러 함수가 삽입될 이벤트의 ID 를 설정합니다. | |
nIndex | Number | 핸들러 함수가 삽입될 위치를 인덱스로 설정합니다. -1 값 설정 시 마지막에 추가됩니다. 이벤트에 설정된 핸들러 함수의 갯수보다 큰 값을 설정한 경우 마지막에 추가됩니다. NaN 값을 입력하면 ECMA 의 정수 변환 규칙에 따라 0 이 설정됩니다. | |
objFunc | Object | 이벤트 발생 시 수행될 핸들러 함수를 설정합니다. | |
objTarget | Object | 핸들러 함수가 정의된 영역을 설정합니다. | |
this.ExcelImportObject00_onmove = function( obj:nexacro.ExcelImportObject, e:nexacro.MoveEventInfo) { // 수행할 스크립트 }; var nIndex = this.ExcelImportObject00.insertEventHandler( "onmove", 0, this.ExcelImportObject00_onmove, this); | |||
반환
Type | Description |
|---|---|
Number | 이벤트에 삽입된 핸들러 함수의 인덱스를 반환합니다. 동일한 핸들러 함수가 이미 있다면 해당 핸들러 함수의 인덱스를 반환합니다. 핸들러 함수가 정상적으로 삽입되지 않은 경우에는 -1 을 반환합니다. |
참고
- 첫번째 핸들러 함수의 인덱스는 0 입니다.
removeEvent
ExcelImportObject 에 선언된 특정 이벤트를 삭제하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
문법
ExcelImportObject.removeEvent( strEventID )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | ExcelImportObject 에서 삭제할 이벤트의 ID 를 문자열로 설정합니다. | |
var bResult = this.ExcelImportObject00.removeEvent( "onmove" ); | |||
반환
Type | Description |
|---|---|
Boolean | 이벤트 삭제에 성공하면 true 를 반환합니다. 이벤트 삭제에 실패하거나 선언되지 않은 이벤트 ID 설정 시 false 를 반환합니다. |
참고
- Composite Component 와 같은 사용자 컴포넌트에서 특정 이벤트를 삭제할 때 사용하는 메소드입니다. - 이벤트에 핸들러 함수가 정의되어 있을 경우 이벤트를 삭제할 수 없습니다. - ExcelImportObject 에 특정 이벤트를 추가하려면 addEvent() 메소드를 사용하여야 합니다. - ExcelImportObject 에 기본으로 선언되어 있는 이벤트 삭제 시 오동작 할 수 있으므로 주의하여야 합니다.
removeEventHandler
ExcelImportObject 의 특정 이벤트에서 핸들러 함수를 제거하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
문법
ExcelImportObject.removeEventHandler( strEventID, objFunc, objTarget )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 핸들러 함수를 제거할 이벤트의 ID를 설정합니다. | |
objFunc | Object | 제거할 핸들러 함수를 설정합니다. | |
objTarget | Object | 제거할 핸들러 함수가 정의된 영역을 설정합니다. | |
this.ExcelImportObject00_onmove = function( obj:nexacro.ExcelImportObject, e:nexacro.MoveEventInfo) { // 수행할 스크립트 }; var nIndex = this.ExcelImportObject00.removeEventHandler( "onmove", this.ExcelImportObject00_onmove, this); | |||
반환
Type | Description |
|---|---|
Number | 핸들러 함수 제거에 성공하면 1 을 반환합니다. 핸들러 함수 제거에 실패하면 0 을 반환합니다. |
참고
- 핸들러 함수가 제거되면 핸들러 함수의 인덱스가 0 번부터 재조정됩니다. - 이벤트에 등록된 핸들러 함수를 모두 제거하려면 clearEventHandler() 메소드를 사용하여야 합니다.
removeEventHandlerLookup
ExcelImportObject 의 특정 이벤트에서 검색된 함수와 동일한 핸들러 함수를 제거하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
문법
ExcelImportObject.removeEventHandlerLookup( strEventID, strFunc, objTarget )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 핸들러 함수를 제거할 이벤트의 ID를 설정합니다. | |
strFunc | String | 제거할 핸들러 함수의 이름을 문자열로 설정합니다. | |
objTarget | Object | 제거할 핸들러 함수가 정의된 영역을 설정합니다. 해당 영역에 함수가 정의되지 않았다면 상위 영역으로 올라가며 검색을 합니다. | |
this.ExcelImportObject00_onmove = function( obj:nexacro.ExcelImportObject, e:nexacro.MoveEventInfo) { // 수행할 스크립트 }; var nIndex = this.ExcelImportObject00.removeEventHandlerLookup( "onmove", "ExcelImportObject00_onmove", this); | |||
반환
Type | Description |
|---|---|
Number | 핸들러 함수 제거에 성공하면 1 을 반환합니다. 핸들러 함수 제거에 실패하면 0 을 반환합니다. |
참고
- 핸들러 함수가 제거되면 핸들러 함수의 인덱스가 0 번부터 재조정됩니다. - 이벤트에 등록된 핸들러 함수를 모두 제거하려면 clearEventHandler() 메소드를 사용하여야 합니다.
setEventHandler
ExcelImportObject 의 특정 이벤트에서 첫번째 핸들러 함수를 변경하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
문법
ExcelImportObject.setEventHandler( strEventID, objFunc, objTarget )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 핸들러 함수를 변경할 이벤트의 ID를 설정합니다. | |
objFunc | Object | 기존 핸들러 함수를 대체할 함수를 설정합니다. | |
objTarget | Object | 대체할 핸들러 함수가 정의된 영역을 설정합니다. | |
this.ExcelImportObject00_onmove = function( obj:nexacro.ExcelImportObject, e:nexacro.MoveEventInfo ) { //수행할 스크립트 }; var nIndex = this.ExcelImportObject00.setEventHandler( "onmove", this.ExcelImportObject00_onmove, this ); | |||
반환
Type | Description |
|---|---|
Number | 첫번째 핸들러 함수 변경에 성공하면 0 을 반환합니다. 첫번째 핸들러 함수 변경에 실패하면 -1 을 반환합니다. |
참고
- 인덱스가 0 번인 핸들러 함수를 새로운 함수로 대체합니다. - 인덱스가 0 번인 핸들러 함수가 없다면 0 번 인덱스에 새로운 함수를 핸들러 함수로 추가합니다.
setEventHandlerLookup
ExcelImportObject 의 특정 이벤트에서 첫번째 핸들러 함수를 검색된 함수로 변경하는 메소드입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
문법
ExcelImportObject.setEventHandlerLookup( strEventID, strFunc, objTarget )
파라미터
Parameters | Type | Description | |
|---|---|---|---|
strEventID | String | 핸들러 함수를 변경할 이벤트의 ID를 설정합니다. | |
strFunc | Object | 기존 핸들러 함수를 대체할 함수의 이름을 문자열로 설정합니다. | |
objTarget | Object | 대체할 핸들러 함수를 검색할 영역을 설정합니다. 해당 영역에 함수가 정의되지 않았다면 상위 영역으로 올라가며 검색을 합니다. | |
this.ExcelImportObject00_onmove = function( obj:nexacro.ExcelImportObject, e:nexacro.MoveEventInfo) { // 수행할 스크립트 }; var nIndex = this.ExcelImportObject00.setEventHandlerLookup( "onmove", "ExcelImportObject00_onmove", this); | |||
반환
Type | Description |
|---|---|
Number | 첫번째 핸들러 함수 변경에 성공하면 0 을 반환합니다. 첫번째 핸들러 함수 변경에 실패하면 -1 을 반환합니다. |
참고
- 인덱스가 0 번인 핸들러 함수를 검색된 함수로 대체합니다. - 인덱스가 0 번인 핸들러 함수가 없다면 0 번 인덱스에 검색된 함수를 핸들러 함수로 추가합니다.
이벤트
onerror
Import 도중 오류가 생겼을때 발생하는 이벤트입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
문법
onerror(obj:nexacro.ExcelImportObject,e:nexacro.ExcelImportErrorEventInfo);
파라미터
Parameters | Type | Description | |
|---|---|---|---|
obj | ExcelImportObject | Event가 발생한 Object. | |
e | Event Object. | ||
참고
- onerror 이벤트가 발생하면 Import 기능이 종료됩니다.
onsuccess
Import 가 완료되었을때 발생하는 이벤트입니다.
지원 환경
Desktop NRE | Desktop WRE | |||||
|---|---|---|---|---|---|---|
☑ Windows | ☑ macOS | ☑ Edge | ☑ Chrome | ☑ Safari | ☑ Firefox | ☑ Opera |
Mobile NRE | Mobile WRE | |||||
☑ Android | ☐ iOS/iPadOS | ☑ Android | ☐ iOS/iPadOS | |||
문법
onsuccess(obj:nexacro.ExcelImportObject,e:nexacro.ExcelImportEventInfo);
파라미터
Parameters | Type | Description | |
|---|---|---|---|
obj | ExcelImportObject | Event가 발생한 Object. | |
e | Event Object. | ||