개요

로컬시스템의 파일을 읽거나 쓰기위해 사용되는 가상파일 오브젝트입니다.

지원 환경

- read, write 메소드 실행 시 메모리 제약으로 2GB 이상의 파일을 처리하지 못할 수 있습니다. 또한 운영체제와 사용하는 장비에 따라 처리할 수 있는 파일의 크기는 다를 수 있습니다.

◆ web runtime environment  제약

- web runtime environment 에서 VirtualFile 오브젝트를 단독으로 사용할 수 없습니다.
   FileUpload, FileUpTransfer 의 filelist 속성, FileDialogEventInfo 의 virtualfiles 속성과 
   DragEventInfo, GridDragEventInfo, ListViewDragEventInfo  등에서 filelist 속성으로 제공하는 VirtualFile 만 사용할 수 있습니다.

- 따라서, web runtime environment 에서 일부 웹브라우저를 지원한다고 표시된 open(), close(), getFileSize() 메소드와 filename 속성은
   VirtualFile 오브젝트가 위에 예시된 속성으로 제공될 때만 사용할 수 있습니다.

속성

async

VirtualFile 에 요청된 작업이 동작되는 방식을 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

bAsync ::= 'true' | 'false'

참고

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


◆ Mobile 제약

- 모바일 환경에서는 항상 비동기(Async) 로 동작합니다.

filename

VirtualFile 에 로드된 파일의 이름을 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법 설정

참고

◆ web runtime environment 제약

- web runtime environment 에서 VirtualFile 오브젝트를 단독으로 사용할 수 없습니다.
   FileUpload, FileUpTransfer, DragEventInfo 의 filelist 속성, FileDialogEventInfo 의 virtualfiles 속성 등으로 제공되는 VirtualFile 오브젝트만 사용할 수 있습니다.

fullpath

VirtualFile 에 오픈된 파일의 전체 경로정보를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법 설정

참고

- 웹브라우저 환경에서는 파일의 경로가 실제경로가 아닌 "FakePath" 형태의 가상경로로 지원됩니다.
   따라서, 웹브라우저 환경일 때는 지원되지 않는 속성입니다.

id

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

지원 환경

속성 타입

문법

VirtualFile.id

문법 설정

참고

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

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

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

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

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

name

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

지원 환경

속성 타입

문법

VirtualFile.name[= strName]

문법 설정

참고

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

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

parent

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

지원 환경

속성 타입

문법

VirtualFile.parent

문법 설정

var objParent = this.VirtualFile00.parent;

참고

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

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

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

path

VirtualFile 에 오픈된 파일의 경로정보를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법 설정

참고

- 웹브라우저 환경에서는 파일의 경로가 실제경로가 아닌 "FakePath" 형태의 가상경로로 지원됩니다.
   따라서, 웹브라우저 환경일 때는 지원되지 않는 속성입니다.

메서드

addEvent

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

지원 환경

문법

VirtualFile.addEvent( strEventID )

파라미터

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

반환

참고

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

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

addEventHandler

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

지원 환경

문법

VirtualFile.addEventHandler( strEventID, objFunc, objTarget )

파라미터

this.VirtualFile00_onsuccess = function( obj:nexacro.VirtualFile,  e:nexacro.VirtualFileEventInfo) { // 수행할 스크립트 };
var nIndex = this.VirtualFile00.addEventHandler( "onsuccess", this.VirtualFile00_onsuccess, this);

반환

clearEventHandler

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

지원 환경

문법

VirtualFile.clearEventHandler( strEventID )

파라미터

var nCnt = this.VirtualFile00.clearEventHandler( "onsuccess" );

반환

참고

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

close

VirtualFile 로 오픈한 파일을 닫는 메소드입니다.

지원 환경

문법

VirtualFile.close()

파라미터

this.VirtualFile00.close();

참고

- 파일 닫기에 성공하면 onsuccess 이벤트가 발생합니다.
   파일 닫기에 실패하면 onerror 이벤트가 발생합니다.


◆ web runtime environment 제약

- web runtime environment 에서 VirtualFile 오브젝트를 단독으로 사용할 수 없습니다.
   FileUpload, FileUpTransfer, DragEventInfo 의 filelist 속성, FileDialogEventInfo 의 virtualfiles 속성 등으로 제공되는 VirtualFile 오브젝트만 사용할 수 있습니다.

- Safari 브라우저에서는 지원되지 않는 메소드입니다.

copy

VirtualFile 에서 특정 파일을 복사하는 메소드입니다.

지원 환경

문법

VirtualFile.copy( strSrc, strDest );

파라미터

var bSucc = this.VirtualFile00.copy("%USERAPP%source.txt", "%USERAPP%dest.txt") ;

반환

참고

- 파일 복사에 성공하면 onsuccess 이벤트가 발생합니다.
  파일 복사에 실패하면 onerror 이벤트가 발생합니다.

◆ Windows NRE 제약
- Environment.filesecurelevel 속성값을 "all"로 설정한 경우에는 모든 경로에 접근을 허용합니다. 
  단, strDest 파라미터로 설정한 경로 중 %MYDOCUMENT% 경로를 제외한 모든 경로에 대해 사용자에게 접근 허용 여부를 확인한 후 사용자가 승인한 경우에만 메소드를 실행합니다.

◆ Alias
- strSrc 와 strDest 에 사용할 수 있는 Alias 실제경로입니다.


  * %USERAPP% : 애플리케이션에서 할당받은 공간, 다른 애플리케이션 접근불가
  * %SD_CARD% : 모바일 기기의 외부 저장소 공간, 다른 애플리케이션 접근가능

createDirectory

VirtualFile 에서 폴더를 생성하는 메소드입니다.

지원 환경

문법

VirtualFile.createDirectory( strPath, [bAllCreate] )

파라미터

var bSucc;
bSucc = this.VirtualFile00.createDirectory( "C:\\TobeSoft\\TestFolder", true );
bSucc = this.VirtualFile00.createDirectory( "TestFolder" ) ;

반환

참고

- 폴더 생성에 성공하면 onsuccess 이벤트가 발생합니다.
   폴더 생성에 실패하면 onerror 이벤트가 발생합니다.

deleteDirectory

VirtualFile 에서 폴더를 삭제하는 메소드입니다.

지원 환경

문법

VirtualFile.deleteDirectory( strPath [, bAllChild] )

파라미터

var bSucc;
bSucc = this.VirtualFile00.deleteDirectory( "TestFolder" );
bSucc = this.VirtualFile00.deleteDirectory( "C:\\TobeSoft\\TestFolder", true );

반환

참고

- 폴더 삭제에 성공하면 onsuccess 이벤트가 발생합니다.
   폴더 삭제에 실패하면 onerror 이벤트가 발생합니다.

findEventHandler

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

지원 환경

문법

VirtualFile.findEventHandler( strEventID, objFunc, objTarget )

파라미터

this.VirtualFile00_onsuccess = function( obj:nexacro.VirtualFile,  e:nexacro.VirtualFileEventInfo) { //수행할 스크립트 };
var nIndex = this.VirtualFile00.findEventHandler( "onsuccess", this.VirtualFile00_onsuccess, this );

반환

참고

- 인덱스는 "0"부터 시작합니다.

getEventHandler

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

지원 환경

문법

VirtualFile.getEventHandler( strEventID, nIdx )

파라미터

var objFunc = VirtualFile00.getEventHandler( "onsuccess", 0 );

반환

getFileList

특정 위치의 파일 또는 하위폴더를 목록으로 반환하는 메소드입니다.

지원 환경

문법

VirtualFile.getFileList( strPath, strSearchExpr [, constOption] )

파라미터

this.VirtualFile00.getFileList( "%MYDOCUMENT%", "\\.txt$", VirtualFile.findFileOnly );
this.VirtualFile00.getFileList( "%MYDOCUMENT%", "\\.jpg$", VirtualFile.findFileOnly | VirtualFile.findRecursive );
this.VirtualFile00.getFileList( "%MYDOCUMENT%\\TestFolder", "^Folder.*\\d", VirtualFile.findDirectoryOnly | VirtualFile.findRecursive | VirtualFile.findCaseless );

반환

참고

- 파일 또는 폴더 목록 반환에 성공하면 onsuccess 이벤트가 발생합니다.
   파일 또는 폴더 목록 반환에 실패하면 onerror 이벤트가 발생합니다.

- onsuccess 이벤트에서 e 오브젝트(VirtualFileEventInfo)의 fileattributelist 속성으로 파일 또는 폴더 목록이 전달됩니다.

- strPath 파라미터에 사용할 수 있는 Alias 의 실제경로는 아래와 같습니다.



  * %USERAPP% : 애플리케이션에서 할당받은 공간, 다른 애플리케이션 접근불가
  * %SD_CARD% : 모바일 기기의 외부 저장소 공간, 다른 애플리케이션 접근가능

getFileSize

VirtualFile 에 오픈된 파일의 크기를 반환하는 메소드입니다.

지원 환경

문법

VirtualFile.getFileSize()

파라미터

this.VirtualFile00.getFileSize();

반환

참고

- VirtualFile 의 open() 메소드를 사용하여 크기를 구할 파일을 먼저 오픈한 후 getFileSize() 메소드를 수행하여야 합니다.

- 파일크기 조회에 성공하면 onsuccess 이벤트가 발생합니다.
   파일크기 조회에 실패하면 onerror 이벤트가 발생합니다.

- 파일의 크기는 onsuccess 이벤트에서 "e" 오브젝트(VirtualFileEventInfo)의 filesize 속성값으로 전달됩니다.


◆ web runtime environment 제약

- web runtime environment 에서 VirtualFile 오브젝트를 단독으로 사용할 수 없습니다.
   FileUpload, FileUpTransfer, DragEventInfo 의 filelist 속성, FileDialogEventInfo 의 virtualfiles 속성 등으로 제공되는 VirtualFile 오브젝트만 사용할 수 있습니다.

- Safari 브라우저에서는 지원되지 않는 메소드입니다.

insertEventHandler

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

지원 환경

문법

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

파라미터

this.VirtualFile00_onsuccess = function( obj:nexacro.VirtualFile,  e:nexacro.VirtualFileEventInfo) { // 수행할 스크립트 };

var nIndex = this.VirtualFile00.insertEventHandler( "onsuccess", 0, this.VirtualFile00_onsuccess, this);

반환

참고

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

isExist

지정된 파일 또는 폴더의 존재여부를 반환하는 메소드입니다.

지원 환경

문법

VirtualFile.isExist(strPath)

파라미터

this.VirtualFile00.isExist("%USERAPP%");

반환

참고

- 존재여부 반환에 성공하면 onsuccess 이벤트가 발생합니다.
   존재여부 반환에 실패하면 onerror 이벤트가 발생합니다.

- 검색된 파일목록은 onsuccess 이벤트에서 "e" 오브젝트(VirtualFileEventInfo)의 fileisexist 속성값으로 전달됩니다.

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



  * %USERAPP% : 애플리케이션에서 할당받은 공간, 다른 애플리케이션 접근불가
  * %SD_CARD% : 모바일 기기의 외부 저장소 공간, 다른 애플리케이션 접근가능

open

VirtualFile 에 로드된 파일을 조건에 맞게 오픈하는 메소드입니다.

지원 환경

문법

VirtualFile.open( strFileName ,constOptions )

파라미터

this.VirtualFile00.open( "%USERAPP%test.txt", VirtualFile.openRead );
this.VirtualFile00.open( "%USERAPP%test.txt", VirtualFile.openWrite | VirtualFile.openAppend );

반환

참고

- 파일 오픈에 성공하면 onsuccess 이벤트가 발생합니다.
   파일 오픈에 실패하면 onerror 이벤트가 발생합니다.

- VirtualFile 오브젝트에서 한 번에 할당받을 수 있는 메모리 크기 제약으로 2GB 이상 크기의 파일을 처리할 수 없습니다.

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



  * %USERAPP% : 애플리케이션에서 할당받은 공간, 다른 애플리케이션 접근불가
  * %SD_CARD% : 모바일 기기의 외부 저장소 공간, 다른 애플리케이션 접근가능


◆ web runtime environment  제약

- web runtime environment 에서 VirtualFile 오브젝트를 단독으로 사용할 수 없습니다.
   FileUpload, FileUpTransfer, DragEventInfo 의 filelist 속성, FileDialogEventInfo 의 virtualfiles 속성 등으로 제공되는 VirtualFile 오브젝트만 사용할 수 있습니다.

- Safari 브라우저에서는 지원되지 않는 메소드입니다.

read

VirtualFile 에 오픈된 파일의 내용을 읽는 메소드입니다.

지원 환경

문법

VirtualFile.read([nLength [, strCharset]])

파라미터

var varValue;
varValue = this.VirtualFile00.read(1000);
varValue = this.VirtualFile00.read(1000, "utf-8");

반환

참고

- 파일 읽기에 성공하면 onsuccess 이벤트가 발생합니다.
   파일 읽기에 실패하면 onerror 이벤트가 발생합니다.

- 읽어온 파일 내용은 onsuccess 이벤트에서 "e" 오브젝트(VirtualFileEventInfo)의 binarydata 또는 textdata 속성값으로 전달됩니다.

- Text 파일의 경우 첫부분에 문자셋정보(BOM:Byte Order Mark)가 포함되어 있다면  해당 부분을 제외하고 nLength 길이만큼 파일을 읽어들입니다.

- 파일의 내용을 읽은 후에는 파일포인터의 위치가 이동됩니다.


◆ Windows NRE 제약

- 파일 크기가 200MB 이상인 경우 nLength 파라미터 값을 지정하지 않거나 nLength 파라미터 값을 209,715,200Byte 이상으로 설정한 경우 onerror 이벤트가 발생합니다.
  (V8 엔진에서는 268,435,440Byte까지 지원하지만 내부적으로 인코딩 처리를 하면서 늘어나는 크기를 고려해 약 200MB 정도 크기까지 권장합니다).

readLine

VirtualFile 에 오픈된 파일의 내용을 특정 위치까지 읽는 메소드입니다.

지원 환경

문법

VirtualFile.readLine([strDelimeter[, strCharset]])

파라미터

var varValue ;
varValue = this.VirtualFile00.readLine();
varValue = thie.VirtualFile00.readLine("\p");

반환

참고

- 파일 읽기에 성공하면 onsuccess 이벤트가 발생합니다.
   파일 읽기에 실패하면 onerror 이벤트가 발생합니다.

- 읽어온 파일 내용에서 strDelimeter 문자는 제외됩니다.

- 파일의 내용을 읽은 후에는 파일포인터의 위치가 이동됩니다.

- Binary 모드로 오픈된 파일인 경우 readLine() 메소드를 사용할 수 없습니다.
   읽어온 파일 내용은 onsuccess 이벤트에서 "e" 오브젝트(VirtualFileEventInfo)의 textdata 속성값으로 전달됩니다.

remove

VirtualFile 에 지정된 파일을 삭제하는 메소드입니다.

지원 환경

문법

VirtualFile.remove( strFilePath )
VirtualFile.remove( objVirtualFile )

파라미터

this.VirtualFile00.remove("%USERAPP%filename");

var objFileD = new FileDialog();
objFileD.open("", FileDialog.LOAD, "%USERAPP%", "");
VirtualFile.remove(obj.e.virtualfiles);

반환

참고

- 파일 삭제에 성공하면 onsuccess 이벤트가 발생합니다.
  파일이 존재하지 않거나 파일 삭제에 실패하면 onerror 이벤트가 발생합니다.

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



  * %USERAPP% : 애플리케이션에서 할당받은 공간, 다른 애플리케이션 접근불가
  * %SD_CARD% : 모바일 기기의 외부 저장소 공간, 다른 애플리케이션 접근가능

removeEvent

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

지원 환경

문법

VirtualFile.removeEvent( strEventID )

파라미터

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

반환

참고

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

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

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

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

removeEventHandler

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

지원 환경

문법

VirtualFile.removeEventHandler( strEventID, objFunc, objTarget )

파라미터

this.VirtualFile00_onsuccess = function( obj:nexacro.VirtualFile,  e:nexacro.VirtualFileEventInfo) { // 수행할 스크립트 };
var nIndex = this.VirtualFile00.removeEventHandler( "onsuccess", this.VirtualFile00_onsuccess, this);

반환

참고

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

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

rename

VirtualFile 에서 특정 파일의 위치를 이동하거나 파일명을 변경하는 메소드입니다.

지원 환경

문법

VirtualFile.rename( strOldname, strNewname );

파라미터

var bSucc;

bSucc = this.VirtualFile00.rename("%USERAPP%oldname.txt", "%USERAPP%newname.txt") ;
bSucc = this.VirtualFile00.rename("%USERAPP%file00.txt", "%SD_CARD%file00.txt") ;

반환

참고

- 파일 이동에 성공하면 onsuccess 이벤트가 발생합니다.
  파일 이동에 실패하면 onerror 이벤트가 발생합니다.

◆ Windows NRE 제약
- Environment.filesecurelevel 속성값을 "all"로 설정한 경우에는 모든 경로에 접근을 허용합니다. 
  단, strNewname 파라미터로 설정한 경로 중 %MYDOCUMENT% 경로를 제외한 모든 경로에 대해 사용자에게 접근 허용 여부를 확인한 후 사용자가 승인한 경우에만 메소드를 실행합니다.

◆ Alias
- strOldname 과 strNewname 에 사용할 수 있는 Alias 실제경로입니다.


  * %USERAPP% : 애플리케이션에서 할당받은 공간, 다른 애플리케이션 접근불가
  * %SD_CARD% : 모바일 기기의 외부 저장소 공간, 다른 애플리케이션 접근가능

renameDirectory

VirtualFile 에서 폴더명을 변경하는 메소드입니다.

지원 환경

문법

VirtualFile.renameDirectory( strOldName, strNewName )

파라미터

var bChange;
bChange = this.VirtualFile00.renameDirectory( "TestFolder","TestFolder_New" );
bChange = this.VirtualFile00.renameDirectory( "C:\\TobeSoft\\TestFolder", "TestFolder_New" );

반환

참고

- 폴더명 변경에 성공하면 onsuccess 이벤트가 발생합니다.
   폴더명 변경에 실패하면 onerror 이벤트가 발생합니다.

seek

VirtualFile 에 오픈한 파일에서 파일포인터의 위치를 이동하는 메소드입니다.

지원 환경

문법

VirtualFile.seek(nOffset[, constOption])

파라미터

this.VirtualFile00.seek(1000);
this.VirtualFile00.seek(1000, VirtualFile.seekBegin);

반환

참고

- 파일포인터 이동에 성공하면 onsuccess 이벤트가 발생합니다.
   파일포인터 이동에 실패하면 onerror 이벤트가 발생합니다.

setEventHandler

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

지원 환경

문법

VirtualFile.setEventHandler( strEventID, objFunc, objTarget )

파라미터

this.VirtualFile00_onsuccess = function( obj:nexacro.VirtualFile,  e:nexacro.VirtualFileEventInfo ) { //수행할 스크립트 };
var nIndex = this.VirtualFile00.setEventHandler( "onsuccess", this.VirtualFile00_onsuccess, this );

반환

참고

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

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

write

VirtualFile 에 오픈된 파일에 데이터를 저장하는 메소드입니다.

지원 환경

문법

VirtualFile.write( varData [, strCharset] )

파라미터

this.VirtualFile00.write( "test" );
this.VirtualFile00.write( new Object() );
this.VirtualFile00.write( "Hello!!", "utf-8" );

반환

참고

- 파일 저장에 성공하면 onsuccess 이벤트가 발생합니다.
   파일 저장에 실패하면 onerror 이벤트가 발생합니다.

- 오픈된 파일의 형태에 따라 Text 또는 Binary 데이터로 변환되어 저장하며 저장된 후 파일포인터가 이동합니다.

- write() 메소드가 수행되려면 파일을 오픈할 때 "VirtualFile.openWrite"  모드가 포함되어 있어야 합니다.

- 파일을 오픈할때 "VirtualFile.openAppend" 가 포함된 경우에는 무조건 파일의 마지막 위치에 데이터를 추가합니다.

- strCharset 에 "euc-kr", "Shift-JIS" 등 ANSI CodePage 로도 인코딩이 가능합니다.


◆ Windows NRE 제약

- varData 파라미터 값으로 지정한 문자열 또는 오브젝트 크기가 200MB 이상인 경우 onerror 이벤트가 발생합니다.
  (V8 엔진에서는 268,435,440Byte까지 지원하지만 내부적으로 인코딩 처리를 하면서 늘어나는 크기를 고려해 약 200MB 정도 크기까지 권장합니다).

이벤트

onerror

VirtualFile 에 요청된 작업이 실패했을 때 발생되는 이벤트입니다.

지원 환경

문법

onerror(obj:nexacro.VirtualFile,e:nexacro.VirtualFileErrorEventInfo);

파라미터

참고

◆ web runtime environment 제약

- web runtime environment 는 VirtualFile 오브젝트를 단독으로 사용할 수 없습니다.
   FileUpload, FileUpTransfer, DragEventInfo 의 filelist 속성, FileDialogEventInfo 의 virtualfiles 속성 등으로 제공되는 VirtualFile 오브젝트만 사용할 수 있습니다.

- Safari 브라우저에서는 지원되지 않는 이벤트입니다.

onsuccess

VirtualFile 에 요청된 작업이 성공했을 때 발생하는 이벤트입니다.

지원 환경

문법

onsuccess(obj:nexacro.VirtualFile,e:nexacro.VirtualFileEventInfo);

파라미터

참고

◆ web runtime environment 제약

- web runtime environment 는 VirtualFile 오브젝트를 단독으로 사용할 수 없습니다.
   FileUpload, FileUpTransfer, DragEventInfo 의 filelist 속성, FileDialogEventInfo 의 virtualfiles 속성 등으로 제공되는 VirtualFile 오브젝트만 사용할 수 있습니다.

- Safari 브라우저에서는 지원되지 않는 이벤트입니다.