개요

모바일 기기의 사진앨범 또는 카메라 앱과 연동해 이미지 또는 이미지 경로를 얻습니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

- open 메소드 실행 시 모바일 기기의 사진앨범이나 카메라 앱 또는 연결된 다른 앱을 선택할 수 있습니다.
  운영체제, 설치 환경에 따라 선택할 수 있는 앱은 다를 수 있습니다.

속성

encodingtype

가져온 이미지의 타입 정보를 갖는 읽기전용 속성입니다.

지원 환경

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

문법 설정

"JPEG"	가져온 이미지가 "JPEG" 형식일 때 갖는 값입니다.
"PNG"	가져온 이미지가 "PNG" 형식일 때 갖는 값입니다.

참고

- ImagePicker 의 open 메소드에서 파라미터로 설정한 값을 갖습니다.

gettype

가져온 이미지가 전달된 방식을 갖는 읽기전용 속성입니다.

지원 환경

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

문법 설정

"url"	가져온 이미지가 "URL" 형태일 때 갖는 값입니다.
"imagedata"	가져온 이미지가 오브젝트 형태일 때 갖는 값입니다.

참고

- ImagePicker 의 open 메소드에서 파라미터로 설정한 값을 갖습니다.

id

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

지원 환경

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

문법

ImagePicker.id

문법 설정

id	ImagePicker를 구별할 수 있는 유일값을 갖습니다.

참고

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

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

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

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

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

imageheight

가져올 이미지의 높이를 설정하는 속성입니다.

지원 환경

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.ImagePicker00.imageheight = 1500;
nImgHeight	이미지를 가져올 때 적용될 높이를 픽셀 단위의 숫자로 설정합니다. 0 으로 설정 시 원본 이미지의 높이를 변경하지 않습니다.

this.ImagePicker00.imageheight = 1500;

nImgHeight

이미지를 가져올 때 적용될 높이를 픽셀 단위의 숫자로 설정합니다.

0 으로 설정 시 원본 이미지의 높이를 변경하지 않습니다.

참고

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

- open 메소드로 이미지를 가져올 때 이미지의 높이를 imageheight 속성값으로 변경합니다.

- 이미지의 높이를 변경할 때 원본이미지의 너비와 비율이 맞지 않는 경우는 이미지가 왜곡될 수 있습니다.

- 원본 이미지의 크기는 모바일 기기의 종류에 따라 다르며 변경된 이미지의 용량이 사용가능한 메모리보다 큰 경우 오류가 발생합니다.

imagequality

가져올 이미지의 품질을 설정하는 속성입니다.

지원 환경

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.ImagePicker00.imagequality = 90;
nImgQuality	이미지를 가져올 때 적용될 품질을 "0 ~ 100" 범위의 값으로 설정합니다.

참고

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

- open 메소드의 두번째 파라미터를 "JPEG" 으로 설정했을 때만 적용되는 속성입니다.

imagewidth

가져올 이미지의 너비를 설정하는 속성입니다.

지원 환경

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.ImagePicker00.imagewidth = 1500;
nImgWidth	이미지를 가져올 때 적용될 너비를 픽셀 단위의 숫자로 설정합니다. 0 으로 설정 시 원본 이미지의 너비를 변경하지 않습니다.

this.ImagePicker00.imagewidth = 1500;

nImgWidth

이미지를 가져올 때 적용될 너비를 픽셀 단위의 숫자로 설정합니다.

0 으로 설정 시 원본 이미지의 너비를 변경하지 않습니다.

참고

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

- open 메소드로 이미지를 가져올 때 이미지의 너비를 imagewidth 속성값으로 변경합니다.

- 이미지의 너비를 변경할 때 원본이미지의 높이와 비율이 맞지 않는 경우는 이미지가 왜곡될 수 있습니다.

- 원본 이미지의 크기는 모바일 기기의 종류에 따라 다르며 변경된 이미지의 용량이 사용가능한 메모리보다 큰 경우 오류가 발생합니다.

name

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

지원 환경

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

문법

ImagePicker.name[= strName]

문법 설정

strName	컴포넌트의 이름을 설정합니다.

참고

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

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

parent

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

지원 환경

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

문법

ImagePicker.parent

문법 설정

var objParent = this.ImagePicker00.parent;

참고

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

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

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

메서드

open

모바일 기기의 사진앨범이나 카메라 앱 또는 연결된 다른 앱을 구동시켜 이미지를 가져오는 메소드입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

ImagePicker.open( enumGettype, enumEncodingype )

파라미터

Parameters	Type	Description
enumGettype	String	이미지가 전달되는 방식을 설정합니다. "url" 설정 시 이미지의 위치정보가 "URL" 형태로 전달됩니다. "imagedata" 설정 시 이미지가 오브젝트 형태로 전달됩니다. 메소드 수행 후 gettype 속성에 파라미터값이 저장됩니다.
enumEncodingtype	String	이미지가 전달되는 파일 형식을 설정합니다. "JPEG" 설정 시 이미지가 "JPEG" 파일로 전달됩니다. "PNG" 설정 시 이미지가 "PNG" 파일로 전달됩니다. 메소드 수행 후 encodingtype 속성에 파라미터값이 저장됩니다.
this.ImagePicker00.open( "imagedata", "JPEG" ); this.ImagePicker00.open( "url", "PNG" );

Parameters

Type

Description

enumGettype

String

이미지가 전달되는 방식을 설정합니다.

"url" 설정 시 이미지의 위치정보가 "URL" 형태로 전달됩니다.

"imagedata" 설정 시 이미지가 오브젝트 형태로 전달됩니다.

메소드 수행 후 gettype 속성에 파라미터값이 저장됩니다.

enumEncodingtype

String

이미지가 전달되는 파일 형식을 설정합니다.

"JPEG" 설정 시 이미지가 "JPEG" 파일로 전달됩니다.

"PNG" 설정 시 이미지가 "PNG" 파일로 전달됩니다.

메소드 수행 후 encodingtype 속성에 파라미터값이 저장됩니다.

this.ImagePicker00.open( "imagedata", "JPEG" );
this.ImagePicker00.open( "url", "PNG" );

반환

Type	Description
Boolean	메소드 실행에 성공하면 true 를 반환합니다. 메소드 실행에 실패하거나 파라미터값을 잘 못 설정하면 false 를 반환합니다.

Type

Description

Boolean

메소드 실행에 성공하면 true 를 반환합니다.

메소드 실행에 실패하거나 파라미터값을 잘 못 설정하면 false 를 반환합니다.

참고

- 앱에서 이미지 선택에 성공하면 onsuccess 이벤트가 발생합니다.
  앱에서 이미지 선택에 실패하면 onerror 이벤트가 발생합니다.

- 선택된 이미지는 파라미터값과 속성값에 맞게 변형된 후 "%USERAPP%/_resource_/_devicepics_" 위치에 저장됩니다.
   "%USERAPP%/_resource_/_devicepics_" 에 저장된 이미지의 위치정보 또는 오브젝트가 최종적으로 전달됩니다.


◆ Android NRE 제약
- enumEncodingtype 파라미터에 "PNG" 만 설정할 수 있습니다.
- Android 일부 기종의 사진앨범 앱에서 이미지 선택 후 자동으로 앱이 닫히지 않습니다.
   이런 경우에는 사용자가 직접 닫기를 수행하여야 합니다.

이벤트

onerror

이미지 가져오기에 실패했을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

onerror(obj:nexacro.ImagePicker,e:nexacro.ImagePickerErrorEventInfo);

파라미터

Parameters	Type	Description
obj	ImagePicker	Event가 발생한 Object.
e	ImagePickerErrorEventInfo	Event Object.

onsuccess

이미지 가져오기에 성공했을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

onsuccess(obj:nexacro.ImagePicker,e:nexacro.ImagePickerEventInfo);

파라미터

Parameters	Type	Description
obj	ImagePicker	Event가 발생한 Object.
e	ImagePickerEventInfo	Event Object.