개요

사용자가 파일을 열거나 저장할 경로를 선택하기 위한 파일 선택 대화상자 컴포넌트입니다.

지원 환경

- 속성에 따라 지원되는 환경과 범위가 다르므로 사용에 주의하여야 합니다.

속성

accept

FileDialog 에 적용될 파일형식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

FileDialog.accept[= strAccept]

문법 설정

this.FileDialog00.accept = ".png, .exe"; 
this.FileDialog00.accept = "image/png, application/*"; 
this.FileDialog00.accept = "audio/*, .png, .exe";

참고

◆ 데스크탑 NRE 제약

- FileDialog 에 파일형식을 적용하려면 filter 속성을 설정하여야 합니다.


◆ Mobile WRE 제약

- MIME 으로 "image", "video", "audio" 값만 설정할 수 있습니다.
   "image/png" 와 같은 형식의 확장자 제한방식은 적용되지 않습니다.

- MIME 으로 "image", "video", "audio" 설정 시 각각 메모리에 로드된 "이미지", "비디오", "오디오" 파일이 있는 폴더만 접근할 수 있습니다.

- 구글드라이브, NAS 와 같이 외부영역에 위치한 파일은 설정한 파일형식이 적용되지 않습니다.


◆ iOS/iPadOS Default Web Browser 제약

- 사진보관함은 설정한 파일형식이 적용되지 않습니다.

활용 예제

• FileDialog 실행하고 선택한 파일 표시하기

defaultextension

FileDialog 에 선택되어 있는 파일형식의 확장자를 파일명에 포함시킬지 설정하는 속성입니다.

지원 환경

속성 타입

문법

FileDialog.defaultextension[= bExtension]

문법 설정

bExtension ::= 'true' | 'false'

this.FileDialog00.defaultextension = false;

참고

- Nexacro Runtime Environment에서 FileDialog 를 "SAVE" 옵션으로 오픈했을 경우만 적용되는 속성입니다.

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

- FileDialog 에 적용될 파일형식은 filter, filterindex 속성으로 설정합니다.

filter

FileDialog 에 적용될 파일형식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

FileDialog.filter[= strFilter]

문법 설정

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

참고

- filter 속성값을 설정하지 않으면 빈문자열이 설정되고, "All(*.*)|*.*|" 로 동작합니다.

- FileDialog 가 표시될 때 선택될 필터는 filterindex 속성에 설정합니다.

- 웹브라우저 환경일 때 FileDialog 에 파일형식을 적용하려면 accept 속성을 설정하여야 합니다.

filterindex

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

지원 환경

속성 타입

문법

FileDialog.filterindex[= nFilterIndex]

문법 설정

this.FileDialog00.filterindex = 1;

참고

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

- FileDialog 에 표시될 파일형식은 filter 속성을 설정하여야 합니다.
   파일형식의 인덱스는 0 부터 시작하며 첫번째 파일형식부터 차례로 인덱스가 설정됩니다.

- 화면에 표시된 FileDialog 의 파일형식을 변경하면 filterindex 속성에 반영됩니다.

- 웹브라우저 환경일 때 FileDialog 에 파일형식을 적용하려면 accept 속성을 설정하여야 합니다.

id

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

지원 환경

속성 타입

문법

FileDialog.id

문법 설정

참고

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

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

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

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

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

name

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

지원 환경

속성 타입

문법

FileDialog.name[= strName]

문법 설정

참고

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

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

parent

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

지원 환경

속성 타입

문법

FileDialog.parent

문법 설정

var objParent = this.FileDialog00.parent;

참고

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

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

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

메서드

open

FileDialog 를 표시하는 메소드입니다.

지원 환경

문법

FileDialog.open( strTitle, constOpenMode [, strInitialPath [, strFileName [, nWidth [, nHeight ]]]] )

파라미터

var varRet;
varRet = this.FileDialog00.open( "FileOpen", FileDialog.LOAD );
varRet = this.FileDialog00.open( "FileSave", FileDialog.SAVE );
varRet = this.FileDialog00.open( "FileSave", FileDialog.SAVE, "%UserApp%" );
varRet = this.FileDialog00.open( "FileSave", FileDialog.SAVE, "%UserApp%", "abc.txt" );
varRet = this.FileDialog00.open( "FileSave", FileDialog.SAVE, "%UserApp%", "abc.txt", 800, 600 );

반환

참고

- open() 메소드 실행 후 다음 스크립트가 바로 실행되며, 파일 선택 후 FileDialog를 닫으면 onclose 이벤트가 발생합니다.

- FileDialog 에 적용될 파일형식은 환경에 따라 filter 또는 accept 속성으로 설정할 수 있습니다.

- nWidth, nHeight 를 설정한 경우 FileDialog 가 모니터의 중앙에 표시됩니다.

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



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

활용 예제

• FileDialog 실행하고 선택한 파일 표시하기

이벤트

onclose

FileDialog 를 닫았을 때 발생하는 이벤트입니다.

지원 환경

문법

onclose(obj:nexacro.FileDialog,e:nexacro.FileDialogEventInfo);

파라미터

참고

◆ web runtime environment 제약

- "FileDialog.LOAD" 또는 "FileDialog.MULTILOAD" 옵션으로 open() 메소드 실행 후 파일을 선택했을 때 onclose 이벤트가 발생합니다.
   FileDialog 를 "취소" 또는 "X" 버튼으로 닫았을 경우 onclose 이벤트가 발생하지 않습니다.