패키지 | flash.desktop |
클래스 | public final class NativeApplication |
상속 | NativeApplication EventDispatcher Object |
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
NativeApplication 클래스는 응용 프로그램 정보와 응용 프로그램 전반의 함수를 제공하고 응용 프로그램 수준의 이벤트를 전달합니다.
NativeApplication 객체는 시작 시 자동으로 생성된 단일 객체입니다. 정적 속성 NativeApplication.nativeApplication
을 사용하여 응용 프로그램의 NativeApplication 인스턴스를 가져옵니다.
속성 | 정의 주체 | ||
---|---|---|---|
activeWindow : NativeWindow [읽기 전용]
활성 응용 프로그램 윈도우입니다. | NativeApplication | ||
applicationDescriptor : XML [읽기 전용]
이 AIR 응용 프로그램에 대한 응용 프로그램 설명자 파일의 내용입니다. | NativeApplication | ||
applicationID : String [읽기 전용]
이 응용 프로그램의 응용 프로그램 ID입니다. | NativeApplication | ||
autoExit : Boolean
모든 윈도우가 닫히면 응용 프로그램을 자동으로 종료할지 여부를 지정합니다. | NativeApplication | ||
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | ||
executeInBackground : Boolean
응용 프로그램이 백그라운드에서 실행되는지 여부를 지정합니다. | NativeApplication | ||
icon : InteractiveIcon [읽기 전용]
응용 프로그램 아이콘입니다. | NativeApplication | ||
idleThreshold : int
userIdle 이벤트가 전달되기까지 아무런 사용자 입력 없이 경과되어야 하는 시간(초)입니다. | NativeApplication | ||
isCompiledAOT : Boolean [읽기 전용]
응용 프로그램이 원하는 플랫폼에 대해 컴파일되는지, 아니면 해석되는지를 지정합니다. | NativeApplication | ||
menu : NativeMenu
응용 프로그램 메뉴입니다. | NativeApplication | ||
nativeApplication : NativeApplication [정적] [읽기 전용]
NativeApplication 객체의 단일 인스턴스입니다. | NativeApplication | ||
openedWindows : Array [읽기 전용]
이 응용 프로그램의 열려 있는 기본 윈도우를 모두 포함하는 배열입니다. | NativeApplication | ||
publisherID : String [읽기 전용]
이 응용 프로그램의 제작자 ID입니다. | NativeApplication | ||
runtimePatchLevel : uint [읽기 전용]
이 응용 프로그램을 호스팅하는 런타임의 패치 수준입니다. | NativeApplication | ||
runtimeVersion : String [읽기 전용]
이 응용 프로그램을 호스팅하는 런타임의 버전 번호입니다. | NativeApplication | ||
startAtLogin : Boolean
현재 사용자가 로그인할 때마다 이 응용 프로그램을 자동으로 실행할지 여부를 지정합니다. | NativeApplication | ||
supportsDefaultApplication : Boolean [정적] [읽기 전용]
현재 플랫폼에서 setAsDefaultApplication(), removeAsDefaultApplication() 및 isSetAsDefaultApplication()이 지원되는지 여부를 나타냅니다. | NativeApplication | ||
supportsDockIcon : Boolean [정적] [읽기 전용]
AIR가 현재 운영 체제에서 도크 스타일 응용 프로그램 아이콘을 지원하는지 여부를 나타냅니다. | NativeApplication | ||
supportsMenu : Boolean [정적] [읽기 전용]
현재 운영 체제가 전역 응용 프로그램 메뉴 모음을 지원하는지 여부를 지정합니다. | NativeApplication | ||
supportsStartAtLogin : Boolean [정적] [읽기 전용]
startAtLogin이 현재 플랫폼에서 지원되는지 여부를 나타냅니다. | NativeApplication | ||
supportsSystemTrayIcon : Boolean [정적] [읽기 전용]
AIR가 현재 운영 체제에 대한 시스템 트레이 아이콘을 지원하는지 여부를 지정합니다. | NativeApplication | ||
systemIdleMode : String
응용 프로그램에서 사용자 인터페이스가 "유휴" 모드로 전환되지 않도록 방지하는 방법을 제공합니다. | NativeApplication | ||
timeSinceLastUserInput : int [읽기 전용]
마지막 사용자 입력 이후의 시간(초)입니다. | NativeApplication |
메서드 | 정의 주체 | ||
---|---|---|---|
이 응용 프로그램을 활성화합니다. | NativeApplication | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [재정의]
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | NativeApplication | ||
포커스가 있는 표시 객체에서 내부 삭제 명령을 호출합니다. | NativeApplication | ||
포커스가 있는 표시 객체에서 내부 복사 명령을 호출합니다. | NativeApplication | ||
포커스가 있는 표시 객체에서 내부 잘라내기 명령을 호출합니다. | NativeApplication | ||
[재정의]
이벤트를 이벤트 흐름으로 전달합니다. | NativeApplication | ||
이 응용 프로그램을 종료합니다. | NativeApplication | ||
지정된 확장명을 사용하는 파일을 열 기본 응용 프로그램을 가져옵니다. | NativeApplication | ||
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | ||
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
이 응용 프로그램이 현재 지정된 확장명을 사용하는 파일을 열 기본 응용 프로그램인지 여부를 지정합니다. | NativeApplication | ||
포커스가 있는 표시 객체에서 내부 붙여넣기 명령을 호출합니다. | NativeApplication | ||
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | ||
지정된 확장명을 사용하는 파일을 열 기본값으로 이 응용 프로그램을 제거합니다. | NativeApplication | ||
[재정의]
EventDispatcher 객체에서 리스너를 제거합니다. | NativeApplication | ||
포커스가 있는 표시 객체에서 내부 모두 선택 명령을 호출합니다. | NativeApplication | ||
지정된 확장명을 사용하는 파일을 열 기본 응용 프로그램으로 이 응용 프로그램을 설정합니다. | NativeApplication | ||
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | ||
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 프리미티브 값을 반환합니다. | Object | ||
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher |
이벤트 | 요약 | 정의 주체 | ||
---|---|---|---|---|
이 응용 프로그램이 활성 데스크톱 응용 프로그램이 될 때 전달됩니다. | NativeApplication | |||
사용자 브라우저에서 실행되는 SWF 파일로 인해 응용 프로그램이 호출될 때 전달됩니다. | NativeApplication | |||
데스크톱 포커스가 다른 응용 프로그램으로 전환될 때 전달됩니다. | NativeApplication | |||
응용 프로그램의 종료 시퀀스가 시작될 때 전달됩니다. | NativeApplication | |||
응용 프로그램이 호출될 때 전달됩니다. | NativeApplication | |||
사용자가 키를 누를 때 전달됩니다. | NativeApplication | |||
사용자가 키를 놓을 때 전달됩니다. | NativeApplication | |||
새 네트워크 연결을 사용할 수 있게 되거나 기존 네트워크 연결이 끊어질 때 전달됩니다. | NativeApplication | |||
응용 프로그램이 운영 체제에서 일시 중단될 경우 전달됩니다. | NativeApplication | |||
사용자가 유휴 상태일 때 전달됩니다. | NativeApplication | |||
운영 체제가 유휴 기간 후에 마우스 또는 키보드 동작을 감지할 때 전달됩니다. | NativeApplication |
activeWindow | 속성 |
activeWindow:NativeWindow
[읽기 전용] 언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
활성 응용 프로그램 윈도우입니다.
활성 데스크톱 윈도우가 이 응용 프로그램에 속하지 않거나 활성 윈도우가 없으면 activeWindow
가 null
입니다.
이 속성은 NativeWindow 클래스를 지원하지 않는 플랫폼에서는 지원되지 않습니다.
구현
public function get activeWindow():NativeWindow
applicationDescriptor | 속성 |
applicationDescriptor:XML
[읽기 전용] 언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
이 AIR 응용 프로그램에 대한 응용 프로그램 설명자 파일의 내용입니다.
구현
public function get applicationDescriptor():XML
예제 ( 예제 사용 방법 )
copyright
및 version
요소를 읽습니다. 응용 프로그램 설명자 XML에 정의되어 있는 기본 네임스페이스를 사용해야 합니다.
var appDescriptor:XML = NativeApplication.nativeApplication.applicationDescriptor; var ns:Namespace = appDescriptor.namespace(); var appCopyright:String = appDescriptor.ns::copyright; var appVersion:String = appDescriptor.ns::version; trace("appId:", appCopyright); trace("version:", appVersion);
applicationID | 속성 |
autoExit | 속성 |
autoExit:Boolean
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
모든 윈도우가 닫히면 응용 프로그램을 자동으로 종료할지 여부를 지정합니다.
autoExit
가 기본값인 true
이면 모든 윈도우가 닫힐 때 응용 프로그램이 종료됩니다. exiting
및 exit
이벤트가 모두 전달됩니다. autoExit
가 false
이면 NativeApplication.nativeApplication.exit()
를 호출하여 응용 프로그램을 종료해야 합니다.
이 속성은 NativeWindow 클래스를 지원하지 않는 플랫폼에서는 지원되지 않습니다.
구현
public function get autoExit():Boolean
public function set autoExit(value:Boolean):void
executeInBackground | 속성 |
executeInBackground:Boolean
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3.3 |
응용 프로그램이 백그라운드에서 실행되는지 여부를 지정합니다.
executeInBackground
가 기본값인 false
이면 응용 프로그램이 배경으로 이동해도 일시 중단된 상태로 유지됩니다. executeInBackground
가 true
이면 응용 프로그램을 백그라운드에서 실행할 수 있습니다.
참고: swf 버전 21 이하에서는 renderMode가 direct로 설정된 경우 AIR가 iOS 및 Android에서 백그라운드 실행을 지원하지 않습니다. 이러한 제한으로 인해 Stage3D 기반 응용 프로그램이 오디오 재생, 위치 업데이트, 네트워크 업로드/다운로드 등의 백그라운드 작업을 실행할 수 없습니다. iOS는 백그라운드에서 OpenGLES 또는 호출의 렌더링을 허용하지 않습니다. 백그라운드에서 OpenGL 호출을 수행하려는 응용 프로그램은 iOS에 의해 종료됩니다. Android는 응용 프로그램이 백그라운드에서 OpenGLES 호출을 수행하거나 오디오 재생과 같은 다른 백그라운드 작업을 수행하는 것을 제한하지 않습니다. swf 버전 22 이상에서는 renderMode가 direct로 설정된 경우 AIR 모바일 응용 프로그램이 백그라운드에서 실행될 수 있습니다. 백그라운드에서 OpenGLES 호출을 수행하는 경우 AIR iOS 런타임에서 ActionScript 오류(3768 - 백그라운드 실행 중 Stage3D API를 사용할 수 없음)가 발생합니다. 그러나 Android에서는 기본 응용 프로그램이 백그라운드에서 OpenGLES 호출을 수행할 수 있으므로 오류가 발생하지 않습니다. 모바일 리소스의 최적 활용을 위해 백그라운드에서 응용 프로그램이 실행되는 동안에는 렌더링 호출을 수행하지 마십시오.
이 속성은 AIR iOS 및 Android에서 지원됩니다.
구현
public function get executeInBackground():Boolean
public function set executeInBackground(value:Boolean):void
icon | 속성 |
icon:InteractiveIcon
[읽기 전용] 언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
응용 프로그램 아이콘입니다.
NativeApplication.supportsDockIcon
및 NativeApplication.supportsSystemTrayIcon
을 사용하여 icon 클래스를 확인합니다. 유형은 InteractiveIcon의 하위 클래스 중 하나가 됩니다. Mac® OS X에서는 NativeApplication.icon
이 DockIcon
유형의 객체입니다. Windows®에서는 NativeApplication.icon
이 SystemTrayIcon
유형의 객체입니다. 응용 프로그램 아이콘이 지원되지 않을 경우 NativeApplication.supportsDockIcon
과 NativeApplication.supportsSystemTrayIcon
이 모두 false
이고 icon
속성은 null
입니다.
icon
객체는 자동으로 생성성되지만 이미지 데이터를 사용하여 초기화되지 않습니다. Mac OS X와 같은 일부 운영 체제에서는 기본 이미지가 제공됩니다. Windows와 같은 다른 운영 체제에서는 이미지 데이터가 할당되지 않은 아이콘은 표시되지 않습니다. 아이콘 이미지를 할당하려면 적어도 하나의 BitmapData 객체를 포함하고 있는 배열로 icon.bitmaps
속성을 설정하십시오. 배열에 BitmapData 객체가 여러 개 포함되어 있는 경우에는 운영 체제가 아이콘의 표시 크기와 가장 비슷한 크기의 이미지를 선택하고, 필요할 경우 이미지의 크기를 조절합니다.
구현
public function get icon():InteractiveIcon
관련 API 요소
idleThreshold | 속성 |
idleThreshold:int
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
userIdle 이벤트가 전달되기까지 아무런 사용자 입력 없이 경과되어야 하는 시간(초)입니다.
기본적으로 유휴 임계값은 300초(5분)입니다. 허용되는 값 범위는 5(5초)부터 86,400(1일)까지입니다.
구현
public function get idleThreshold():int
public function set idleThreshold(value:int):void
오류
ArgumentError — 속성을 잘못된 값으로 설정하려고 하는 경우입니다. 허용되는 값 범위는 5(5초)부터 86,400(1일)까지입니다.
|
관련 API 요소
isCompiledAOT | 속성 |
menu | 속성 |
menu:NativeMenu
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
응용 프로그램 메뉴입니다.
응용 프로그램 메뉴는 NativeApplication.supportsMenu
가 true
일 때 지원됩니다. 모든 운영 체제가 응용 프로그램 메뉴를 지원하는 것은 아닙니다. 예를 들어 응용 프로그램 메뉴는 Mac OS X에서는 지원되지만 Windows 또는 Linux에서는 지원되지 않습니다. NativeApplication.supportsMenu
가 false
일 때 이 속성에 NativeMenu 객체를 할당하는 것은 허용되지만 아무런 효과가 없습니다. NativeApplication.supportsMenu
속성을 사용하여 운영 체제가 응용 프로그램 메뉴를 지원하는지 여부를 확인해야 합니다. Capabilities.os
등의 다른 방법을 사용하여 지원 여부를 확인할 경우 프로그래밍 오류가 발생할 수 있습니다(일부 가능한 대상 운영 체제가 고려되지 않는 경우).
AIR 프로파일 지원: 이 기능은 휴대 장치 또는 AIR for TV 장치에서 지원되지 않습니다. 여러 프로파일 간 API 지원에 대한 자세한 내용은 AIR 프로파일 지원을 참조하십시오.
참고: Mac OS X에서는 menu
속성이 운영 체제에서 제공하는 기본 응용 프로그램 메뉴를 참조합니다. 항목 및 하위 메뉴를 추가 및 제거하고 이벤트 리스너를 추가하여 기존 메뉴 구조를 수정할 수 있습니다. 또한 새 NativeMenu 객체를 이 menu
속성에 지정하여 기본 메뉴를 완전히 교체할 수 있습니다.
구현
public function get menu():NativeMenu
public function set menu(value:NativeMenu):void
관련 API 요소
nativeApplication | 속성 |
nativeApplication:NativeApplication
[읽기 전용] 언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
NativeApplication 객체의 단일 인스턴스입니다.
구현
public static function get nativeApplication():NativeApplication
오류
Error — 응용 프로그램 보안 샌드박스 외부의 내용이 액세스한 경우입니다.
|
openedWindows | 속성 |
publisherID | 속성 |
runtimePatchLevel | 속성 |
runtimeVersion | 속성 |
startAtLogin | 속성 |
startAtLogin:Boolean
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
현재 사용자가 로그인할 때마다 이 응용 프로그램을 자동으로 실행할지 여부를 지정합니다.
AIR 프로파일 지원: 이 기능은 모든 데스크톱 운영 체제에서 지원되지만 휴대 장치나 AIR for TV 장치에서는 지원되지 않습니다. NativeApplication.supportsStartAtLogin
속성을 사용하여 런타임에 지원을 테스트할 수 있습니다. 여러 프로파일 간 API 지원에 대한 자세한 내용은 AIR 프로파일 지원을 참조하십시오.
startAtLogin
속성은 사용자가 로그인할 때 응용 프로그램이 자동으로 시작되어야 한다는 것을 지정하는 운영 체제 정의 메커니즘의 상태를 반영합니다. 사용자는 운영 체제 사용자 인터페이스를 사용하여 상태를 수동으로 변경할 수 있습니다. 이 속성은 AIR 응용 프로그램 또는 운영 체제에 의해 상태가 마지막으로 변경되었는지 여부에 관계없이 현재 상태를 반영합니다.
구현
public function get startAtLogin():Boolean
public function set startAtLogin(value:Boolean):void
오류
IllegalOperationError — Windows에서 이 사용자가 로그인할 때 같은 이름의 다른 응용 프로그램(실행 파일 경로가 다름)이 실행되도록 이미 설정된 경우입니다.
| |
IllegalOperationError — 이 응용 프로그램이 설치되지 않은 경우입니다. ADL(AIR Debug Launcher)에 의해 실행될 때 이러한 경우가 발생할 수 있습니다.
|
관련 API 요소
supportsDefaultApplication | 속성 |
supportsDefaultApplication:Boolean
[읽기 전용] 언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 2 |
현재 플랫폼에서 setAsDefaultApplication()
, removeAsDefaultApplication()
및 isSetAsDefaultApplication()
이 지원되는지 여부를 나타냅니다.
true
이면 위의 메서드가 설명된 대로 작동합니다. false
이면 setAsDefaultApplication()
및 removeDefaultApplication()
이 아무 효과가 없고 isSetAsDefaultApplication()
이 false
를 반환합니다.
구현
public static function get supportsDefaultApplication():Boolean
관련 API 요소
supportsDockIcon | 속성 |
supportsDockIcon:Boolean
[읽기 전용] 언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
AIR가 현재 운영 체제에서 도크 스타일 응용 프로그램 아이콘을 지원하는지 여부를 나타냅니다.
true
인 경우 NativeApplication.icon
속성의 유형은 DockIcon
입니다.
Mac OS X 사용자 인터페이스는 실행 중이거나 자주 사용되는 응용 프로그램의 아이콘을 포함하는 응용 프로그램 "도크"를 제공합니다.
NativeApplication.supportsDockIcon
속성을 사용하여 운영 체제가 응용 프로그램 도크 아이콘을 지원하는지 확인해야 합니다. Capabilities.os
등의 다른 방법을 사용하여 지원 여부를 확인할 경우 프로그래밍 오류가 발생할 수 있습니다(일부 가능한 대상 운영 체제가 고려되지 않는 경우).
구현
public static function get supportsDockIcon():Boolean
관련 API 요소
supportsMenu | 속성 |
supportsMenu:Boolean
[읽기 전용] 언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
현재 운영 체제가 전역 응용 프로그램 메뉴 모음을 지원하는지 여부를 지정합니다.
true
인 경우 NativeApplication.menu
속성은 기본 응용 프로그램 메뉴를 정의(또는 액세스)하는 데 사용될 수 있습니다.
NativeApplication.supportsMenu
속성을 사용하여 운영 체제가 응용 프로그램 메뉴 모음을 지원하는지 확인해야 합니다. Capabilities.os
등의 다른 방법을 사용하여 지원 여부를 확인할 경우 프로그래밍 오류가 발생할 수 있습니다(일부 가능한 대상 운영 체제가 고려되지 않는 경우).
구현
public static function get supportsMenu():Boolean
관련 API 요소
supportsStartAtLogin | 속성 |
supportsSystemTrayIcon | 속성 |
supportsSystemTrayIcon:Boolean
[읽기 전용] 언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
AIR가 현재 운영 체제에 대한 시스템 트레이 아이콘을 지원하는지 여부를 지정합니다.
true
인 경우 NativeApplication.icon
속성의 유형은 SystemTrayIcon
입니다.
Windows 사용자 인터페이스는 작업 표시줄에서 응용 프로그램 아이콘을 표시할 수 있는 "시스템 트레이" 영역(공식 이름은 알림 영역)을 제공합니다. 기본 아이콘은 표시되지 않습니다. 아이콘 객체의 bitmaps
배열을 설정해야 아이콘이 표시됩니다.
NativeApplication.supportsSystemTrayIcon
속성을 사용하여 운영 체제가 시스템 트레이 아이콘을 지원하는지 확인해야 합니다. Capabilities.os
등의 다른 방법을 사용하여 지원 여부를 확인할 경우 프로그래밍 오류가 발생할 수 있습니다(일부 가능한 대상 운영 체제가 고려되지 않는 경우).
구현
public static function get supportsSystemTrayIcon():Boolean
관련 API 요소
systemIdleMode | 속성 |
systemIdleMode:String
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 2 |
응용 프로그램에서 사용자 인터페이스가 "유휴" 모드로 전환되지 않도록 방지하는 방법을 제공합니다.
호스트 시스템의 유휴 모드 비헤이비어에 영향을 주는 SystemIdleMode 클래스의 값입니다. 이 속성은 입력 포커스가 있는 응용 프로그램에만 효과적이며 응용 프로그램 샌드박스에서 실행 중인 내용에서만 액세스할 수 있습니다.
AIR 프로파일 지원: 이 기능은 휴대 장치에서는 지원되지만 데스크톱 운영 체제 또는 AIR for TV 장치에서는 지원되지 않습니다. 여러 프로파일 간 API 지원에 대한 자세한 내용은 AIR 프로파일 지원을 참조하십시오.
구현
public function get systemIdleMode():String
public function set systemIdleMode(value:String):void
관련 API 요소
timeSinceLastUserInput | 속성 |
activate | () | 메서드 |
public function activate(window:NativeWindow = null):void
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
이 응용 프로그램을 활성화합니다.
이 메서드는 NativeWindow 클래스를 지원하지 않는 플랫폼에서는 지원되지 않습니다.
운영 체제가 정한 특정 상황에서 이 메서드는 응용 프로그램을 활성화하지 않습니다. 대부분의 운영 체제는 한 응용 프로그램이 사용자가 다른 응용 프로그램을 사용하는 것을 의도치 않게 또는 악의적으로 불가능하게 만드는 것을 방지하기 위해 자체적으로 활성화되는 것을 제한합니다.
운영 체제가 활성화를 허용하는 경우 지정된 윈도우가 활성화되고 데스크톱 포그라운드, 즉 다른 응용 프로그램의 윈도우 앞으로 가져와집니다. window
매개 변수가 null
인 경우 이 응용 프로그램의 표시 가능한 모든 윈도우가 활성화됩니다.
응용 프로그램에 표시된 윈도우가 없는 경우에는 activate()
메서드가 아무런 효과가 없습니다.
활성화 작업이 동기적입니다.
매개 변수
window:NativeWindow (default = null ) — 응용 프로그램과 함께 활성화할 윈도우의 NativeWindow 객체입니다.
|
이벤트
activate: — 활성화 상태가 변경될 때 전달됩니다.
|
addEventListener | () | 메서드 |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
런타임 버전: | AIR 1.0 |
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. 표시 목록의 모든 노드에서 특정 유형의 이벤트, 단계, 우선 순위에 대한 이벤트 리스너를 등록할 수 있습니다.
이벤트 리스너의 등록을 마친 뒤에는 addEventListener()
를 추가로 호출하여 그 우선 순위를 변경할 수 없습니다. 리스너의 우선 순위를 변경하려면 먼저 removeListener()
를 호출해야 합니다. 그런 다음 해당 리스너를 새로운 우선 순위 레벨로 다시 등록할 수 있습니다.
일단 리스너가 등록된 뒤에 type
또는 useCapture
값을 달리하여 addEventListener()
를 이어서 호출하면 별도의 리스너 등록이 생성된다는 것에 유의합니다. 예를 들어 useCapture
가 true
로 설정된 리스너를 등록하면 이 리스너는 캡처 단계 동안에만 수신합니다. 그러나 useCapture
를 false
로 설정하고 동일한 리스너 객체를 사용하여 addEventListener()
를 다시 호출하면 별도로 두 개의 리스너가 등록되어, 한 리스너는 캡처 단계 동안 수신하고 다른 하나는 대상 및 버블링 단계 동안 수신합니다.
대상 단계 또는 버블링 단계 전용의 이벤트 리스너를 등록할 수는 없습니다. 버블링은 대상 노드의 조상에만 적용되기 때문에 이들 단계는 등록 과정에서 하나로 통합됩니다.
사용하지 않는 이벤트 리스너는 removeEventListener()
를 호출하여 제거하도록 합니다. 이렇게 하지 않으면 메모리 문제가 발생할 수 있습니다. useWeakReference
매개 변수가 true
로 설정되지 않은 경우 전달하는 객체가 있는 한, 가비지 수집기는 이벤트 리스너를 제거하지 않으므로 리스너는 메모리에서 자동으로 제거되지 않습니다.
EventDispatcher 인스턴스를 복사해도 연결된 이벤트 리스너는 복사되지 않습니다. 새로 만든 노드에 이벤트 리스너가 필요한 경우, 노드를 만든 후 리스너를 연결해야 합니다. 그러나 EventDispatcher 인스턴스를 이동할 때에는 연결된 이벤트 리스너도 함께 이동됩니다.
이벤트를 처리 중인 노드에서 이벤트 리스너를 등록하는 경우, 그 이벤트 리스너는 현재 단계 동안에는 트리거되지 않지만 이벤트 흐름에서 이후 단계(예: 버블링 단계) 동안에는 트리거될 수 있습니다.
이벤트를 처리 중인 노드에서 이벤트 리스너를 제거하는 경우, 그 리스너는 현재 액션에 의해 트리거됩니다. 일단 제거된 이벤트 리스너는 이후의 처리를 위해 재등록하지 않는 한 다시는 호출되지 않습니다.
매개 변수
type:String — 이벤트 유형입니다.
| |
listener:Function — 이벤트를 처리하는 리스너 함수입니다. 아래 예제에서 보듯이, 이 함수는 Event 객체를 유일한 매개 변수로 사용하며 아무 것도 반환하지 않아야 합니다.
function(evt:Event):void 함수의 이름은 임의로 지정할 수 있습니다. | |
useCapture:Boolean (default = false ) —
리스너가 캡처 단계에서 작동하는지 아니면 대상 및 버블링 단계에서 작동하는지를 결정합니다. useCapture 가 true 로 설정된 경우, 리스너는 캡처 단계에서만 이벤트를 처리하고 대상 또는 버블링 단계에서는 작동하지 않습니다. useCapture 가 false 인 경우, 리스너는 대상 또는 버블링 단계 동안에만 이벤트를 처리합니다. 세 단계 모두에서 이벤트를 수신하려면 addEventListener 를 두 번 호출해야 합니다. 먼저 useCapture 를 true 로 설정하여 호출한 다음 useCapture 를 false 로 설정하여 다시 호출합니다.
| |
priority:int (default = 0 ) — 이벤트 리스너의 우선 순위 레벨입니다. 우선 순위는 부호 있는 32비트 정수로 지정됩니다. 숫자가 클수록 우선 순위가 높습니다. 우선 순위가 n인 리스너를 모두 처리한 뒤에 우선 순위가 n -1인 리스너가 처리됩니다. 둘 이상의 리스너가 우선 순위가 같을 경우, 추가된 순서에 따라 처리됩니다. 기본 우선 순위는 0입니다.
| |
useWeakReference:Boolean (default = false ) — 리스너에 대한 참조가 강한지 아니면 약한지를 결정합니다. 강한 참조(기본값)는 해당 리스너의 가비지 수집을 막습니다. 약한 참조는 이를 막지 못합니다. 클래스 레벨 멤버 함수는 가비지 수집의 영향을 받지 않으므로 가비지 수집과 상관없이 클래스 레벨 멤버 함수의 |
clear | () | 메서드 |
copy | () | 메서드 |
cut | () | 메서드 |
dispatchEvent | () | 메서드 |
override public function dispatchEvent(event:Event):Boolean
런타임 버전: | AIR 1.0 |
이벤트를 이벤트 흐름으로 전달합니다. 이벤트 대상은 dispatchEvent()
메서드가 호출된 EventDispatcher 객체입니다.
매개 변수
event:Event — 이벤트 흐름으로 전달된 Event 객체입니다. 이벤트를 다시 전달하는 경우, 해당 이벤트의 복제본이 자동으로 만들어집니다. 이벤트가 전달된 뒤에는 이벤트의 target 속성을 변경할 수 없으므로, 재전달에 성공하려면 이벤트의 복사본을 새로 만들어야 합니다.
|
Boolean — 이벤트가 성공적으로 전달된 경우 값은 true 입니다. false 값은 실패를 나타내거나 해당 이벤트에서 preventDefault() 가 호출되었음을 나타냅니다.
|
exit | () | 메서드 |
public function exit(errorCode:int = 0):void
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
이 응용 프로그램을 종료합니다.
exit()
메서드에 대한 호출이 반환됩니다. 현재 실행 중인 코드(예: 현재 이벤트 핸들러)가 완료되기 전까지는 종료 시퀀스가 시작되지 않습니다. 대기 중인 비동기 작업은 취소되며, 완료될 수도 있고 완료되지 않을 수도 있습니다.
exiting
이벤트는 전달되지 않습니다. 응용 프로그램 논리에 exiting
이벤트가 필요한 경우에는 NativeApplication.nativeApplication.dispatchEvent()
를 호출하고 exiting
유형의 Event 객체를 전달합니다. 모든 열린 윈도우에 대해 NativeWindow 객체가 closing
및 close
이벤트를 전달합니다. closing
이벤트 객체의 preventDefault()
메서드를 호출하면 응용 프로그램이 종료되지 않습니다.
참고: 이 메서드는 iOS 운영 체제에서 지원되지 않습니다.
매개 변수
errorCode:int (default = 0 ) — 이 응용 프로그램이 종료될 때 운영 체제에 보고되는 종료 코드입니다.
|
getDefaultApplication | () | 메서드 |
public function getDefaultApplication(extension:String):String
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
지정된 확장명을 사용하는 파일을 열 기본 응용 프로그램을 가져옵니다.
참고: 이 메서드는 응용 프로그램 설명자의 fileTypes
문에서 선언된 파일 유형에만 사용할 수 있습니다.
이 메서드는 AIR for TV 장치에 적용되지 않습니다. 응용 프로그램 설명자에서 선언된 파일 유형을 사용하여 호출하면 null
이 반환됩니다.
매개 변수
extension:String — 특정 파일 유형의 확장명("." 제외)을 포함하고 있는 String입니다.
|
String — 기본 응용 프로그램의 경로입니다.
|
오류
Error — extension 매개 변수가 응용 프로그램 설명자에서 선언된 파일 확장명 중 하나를 포함하고 있지 않은 경우입니다.
|
관련 API 요소
isSetAsDefaultApplication | () | 메서드 |
public function isSetAsDefaultApplication(extension:String):Boolean
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
이 응용 프로그램이 현재 지정된 확장명을 사용하는 파일을 열 기본 응용 프로그램인지 여부를 지정합니다.
AIR 프로파일 지원: 이 기능은 모든 데스크톱 운영 체제에서 지원되지만 휴대 장치나 AIR for TV 장치에서는 지원되지 않습니다. NativeApplication.supportsDefaultApplication
속성을 사용하여 런타임에 지원을 테스트할 수 있습니다. 여러 프로파일 간 API 지원에 대한 자세한 내용은 AIR 프로파일 지원을 참조하십시오.
매개 변수
extension:String — 특정 파일 유형의 확장명("." 제외)을 포함하고 있는 String입니다.
|
Boolean — 이 응용 프로그램이 기본값인 경우 true 입니다.
|
오류
Error — extension 매개 변수가 응용 프로그램 설명자에서 선언된 파일 확장명 중 하나를 포함하고 있지 않은 경우입니다.
|
관련 API 요소
paste | () | 메서드 |
removeAsDefaultApplication | () | 메서드 |
public function removeAsDefaultApplication(extension:String):void
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
지정된 확장명을 사용하는 파일을 열 기본값으로 이 응용 프로그램을 제거합니다.
참고: 이 메서드는 응용 프로그램 설명자에서 fileTypes
문에 나열된 파일 유형에만 사용할 수 있습니다.
매개 변수
extension:String — 특정 파일 유형의 확장명("." 제외)을 포함하고 있는 String입니다.
|
오류
Error — extension 매개 변수가 응용 프로그램 설명자에서 선언된 파일 확장명 중 하나를 포함하고 있지 않은 경우입니다.
|
관련 API 요소
removeEventListener | () | 메서드 |
override public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
런타임 버전: | AIR 1.0 |
EventDispatcher 객체에서 리스너를 제거합니다. EventDispatcher 객체와 함께 등록된 리스너 중 일치하는 것이 없다면 이 메서드를 호출해도 아무 영향이 없습니다.
매개 변수
type:String — 이벤트 유형입니다.
| |
listener:Function — 제거할 리스너 객체입니다.
| |
useCapture:Boolean (default = false ) —
리스너가 캡처 단계용으로 등록되었는지 아니면 대상 및 버블링 단계용으로 등록되었는지를 지정합니다. 리스너가 캡처 단계 및 대상/버블링 단계에 대해 모두 등록된 경우 두 리스너를 제거하려면 removeEventListener() 를 두 번 호출해야 합니다. 한 번은 useCapture() 를 true 로 설정하여 호출하고 한 번은 useCapture() 를 false 로 설정하여 호출합니다.
|
selectAll | () | 메서드 |
setAsDefaultApplication | () | 메서드 |
public function setAsDefaultApplication(extension:String):void
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
지정된 확장명을 사용하는 파일을 열 기본 응용 프로그램으로 이 응용 프로그램을 설정합니다.
참고: 이 메서드는 응용 프로그램 설명자의 fileTypes
문에서 선언된 파일 유형에만 사용할 수 있습니다.
매개 변수
extension:String — 특정 파일 유형의 확장명("." 제외)을 포함하고 있는 String입니다.
|
오류
Error — extension 매개 변수가 응용 프로그램 설명자에서 선언된 파일 확장명 중 하나를 포함하고 있지 않은 경우입니다.
|
관련 API 요소
activate | 이벤트 |
flash.events.Event
속성 Event.type =
flash.events.Event.ACTIVATE
런타임 버전: | AIR 1.0 |
이 응용 프로그램이 활성 데스크톱 응용 프로그램이 될 때 전달됩니다.
ACTIVATE
상수는 activate
이벤트 객체의 type
속성 값을 정의합니다.
참고: 이 이벤트에는 "캡처 단계" 또는 "버블링 단계"가 없으므로 대상이 표시 목록에 있는지 여부에 관계없이 잠재적인 모든 대상에 이벤트 리스너를 직접 추가해야 합니다.
AIR for TV 장치는 이 이벤트를 자동으로 전달하지 않습니다. 하지만 수동으로 전달할 수는 있습니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | activate 이벤트에 대한 리스너가 등록되어 있는 모든 DisplayObject 인스턴스입니다. |
browserInvoke | 이벤트 |
flash.events.BrowserInvokeEvent
속성 BrowserInvokeEvent.type =
flash.events.BrowserInvokeEvent.Browser_INVOKE
런타임 버전: | AIR 1.0 |
사용자 브라우저에서 실행되는 SWF 파일로 인해 응용 프로그램이 호출될 때 전달됩니다.
응용 프로그램이 응용 프로그램 설명자 파일에 다음을 지정하는 경우에만 브라우저를 호출할 수 있습니다.
<allowBrowserInvocation>true</allowBrowserInvocation>
deactivate | 이벤트 |
flash.events.Event
속성 Event.type =
flash.events.Event.DEACTIVATE
런타임 버전: | AIR 1.0 |
데스크톱 포커스가 다른 응용 프로그램으로 전환될 때 전달됩니다.
Event.DEACTIVATE
상수는 deactivate
이벤트 객체의 type
속성 값을 정의합니다.
참고: 이 이벤트에는 "캡처 단계" 또는 "버블링 단계"가 없으므로 대상이 표시 목록에 있는지 여부에 관계없이 잠재적인 모든 대상에 이벤트 리스너를 직접 추가해야 합니다.
AIR for TV 장치는 이 이벤트를 자동으로 전달하지 않습니다. 하지만 수동으로 전달할 수는 있습니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | deactivate 이벤트에 대한 리스너가 등록되어 있는 모든 DisplayObject 인스턴스입니다. |
exiting | 이벤트 |
flash.events.Event
속성 Event.type =
flash.events.Event.EXITING
런타임 버전: | AIR 1.0 |
응용 프로그램의 종료 시퀀스가 시작될 때 전달됩니다.
운영 체제에서 응용 프로그램 종료가 시작될 때 exiting
이벤트가 전달됩니다. 사용자가 Mac OS X에서 Cmd-Q
키 시퀀스를 실행하거나, NativeApplication 객체의 autoExit
속성이 true
이고 마지막 응용 프로그램 윈도우가 닫히는 경우 등이 이에 해당합니다. 이 이벤트를 취소하면 응용 프로그램이 종료되지 않습니다.
AIR for TV 장치는 exiting
이벤트를 전달하지 않습니다.
참고: NativeApplication exit()
메서드를 호출한다고 해서 exiting
이벤트가 전달되는 것은 아닙니다. 곧 종료됨을 구성 요소에 경고하려면 exit()
를 호출하기 전에 exiting
이벤트를 전달합니다.
Event.EXITING
상수는 exiting
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | true . 이 이벤트 객체를 취소하면 끝내기 작업이 중지됩니다. |
currentTarget | NativeApplication 객체입니다. |
target | NativeApplication 객체입니다. |
invoke | 이벤트 |
flash.events.InvokeEvent
속성 InvokeEvent.type =
flash.events.InvokeEvent.INVOKE
런타임 버전: | AIR 1.0 |
응용 프로그램이 호출될 때 전달됩니다.
응용 프로그램이 두 번째로 호출될 때 응용 프로그램의 또 다른 인스턴스가 시작되지 않습니다. 대신 첫 번째 인스턴스가 추가적인 invoke 이벤트를 수신합니다. 후속 invoke
이벤트를 적절히 처리하는 것은 응용 프로그램이 담당합니다.
참고: 모든 invoke
이벤트가 대기열에 보관됩니다. 이 이벤트의 리스너가 등록되어 있으면 해당 리스너는 대기열에 있는 모든 이벤트는 물론 새 이벤트도 수신합니다. 대기열에 있는 이벤트는 새 invoke
이벤트 이전 또는 이후에 전송될 수 있습니다.
InvokeEvent.INVOKE
상수는 InvokeEvent 객체의 type
속성 값을 정의합니다.
InvokeEvent 객체에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
arguments | 이 호출 중에 전달된 문자열 인수의 배열입니다. |
currentDirectory | 인수 배열에서 상대 경로를 확인하는 데 사용해야 하는 디렉토리를 나타내는 File 객체입니다. |
reason | invoke 이벤트가 전달된 이유가 응용 프로그램이 로그인에 의해 자동으로 시작되었기 때문인지(InvokeEventReason.LOGIN ) 또는 원격 알림에 따른 응답으로 시작되었기 때문인지(InvokeEventReason.NOTIFICATION - iOS만 해당됨), 아니면 다른 응용 프로그램에서 해당 응용 프로그램을 호출했기 때문인지(InvokeEventReason.OPEN_URL ) 또는 기타 이유 때문인지(InvokeEventReason.STANDARD ) 여부를 나타내는 코드입니다. AIR 버전 1.5.1부터 사용할 수 있습니다. |
bubbles | false . |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 현재 이벤트 리스너를 통해 이 InvokeEvent 객체를 처리하고 있는 객체를 나타냅니다. |
target | 항상 NativeApplication 객체입니다. |
keyDown | 이벤트 |
flash.events.KeyboardEvent
속성 KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
사용자가 키를 누를 때 전달됩니다. NativeApplication 인스턴스는 이 이벤트를 제공하여 키보드 액셀러레이터를 지원합니다. 이 키보드 이벤트는 NativeApplication에 먼저 전달됩니다. 이 이벤트를 취소하면 NativeWindow 메뉴 액셀러레이터도 취소됩니다. 이 이벤트는 keyUp
이벤트 전에 발생합니다.
KeyboardEvent.KEY_DOWN
상수는 keyDown
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | true |
cancelable | AIR에서는 true 이고 Flash Player에서는 false 입니다. AIR에서 이 이벤트를 취소하면 텍스트 필드에 문자를 입력할 수 없습니다. |
charCode | 누르거나 놓은 키의 문자 코드 값입니다. |
commandKey | Mac에서 Command 키가 활성 상태이면 true 입니다. 그렇지 않으면 false 입니다 |
controlKey | Windows 및 Linux에서 Ctrl 키가 활성 상태이면 true 입니다. Mac에서 Control 키가 활성 상태이면 true 입니다. 그렇지 않으면 false 입니다 |
ctrlKey | Windows 및 Linux에서 Ctrl 키가 활성 상태이면 true 입니다. Mac에서 Ctrl 키 또는 Command 키가 활성 상태이면 true 입니다. 그렇지 않으면 false 입니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
keyCode | 누르거나 놓은 키의 키 코드 값입니다. |
keyLocation | 키보드에서 키의 위치입니다. |
shiftKey | true 이면 Shift 키가 활성 상태이고, false 이면 비활성 상태입니다. |
target | 포커스가 있는 InteractiveObject 인스턴스입니다. target 은 표시 목록에서 이벤트 리스너를 등록한 객체가 아닐 수도 있습니다. 표시 목록에서 현재 이벤트를 처리 중인 객체에 액세스하려면 currentTarget 속성을 사용합니다. |
관련 API 요소
keyUp | 이벤트 |
flash.events.KeyboardEvent
속성 KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0 |
사용자가 키를 놓을 때 전달됩니다. NativeApplication 인스턴스는 이 이벤트를 제공하여 키보드 액셀러레이터를 지원합니다. 이 키보드 이벤트는 NativeApplication에 먼저 전달됩니다. 이 이벤트를 취소해도 다른 객체(예: NativeWindow 메뉴 액셀러레이터)에는 아무런 영향이 없습니다. 이 이벤트는 keyDown
이벤트 다음에 발생합니다.
KeyboardEvent.KEY_UP
상수는 keyUp
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | true |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
charCode | 누르거나 놓은 키의 문자 코드 값이 포함되어 있습니다. |
commandKey | Mac에서 Command 키가 활성 상태이면 true 입니다. 그렇지 않으면 false 입니다 |
controlKey | Windows 및 Linux에서 Ctrl 키가 활성 상태이면 true 입니다. Mac에서 Control 키가 활성 상태이면 true 입니다. 그렇지 않으면 false 입니다 |
ctrlKey | Windows에서 Ctrl 키가 활성 상태이면 true 입니다. Mac에서 Ctrl 키 또는 Command 키가 활성 상태이면 true 입니다. 그렇지 않으면 false 입니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
keyCode | 누르거나 놓은 키의 키 코드 값입니다. |
keyLocation | 키보드에서 키의 위치입니다. |
shiftKey | true 이면 Shift 키가 활성 상태이고, false 이면 비활성 상태입니다. |
target | 포커스가 있는 InteractiveObject 인스턴스입니다. target 은 표시 목록에서 이벤트 리스너를 등록한 객체가 아닐 수도 있습니다. 표시 목록에서 현재 이벤트를 처리 중인 객체에 액세스하려면 currentTarget 속성을 사용합니다. |
관련 API 요소
networkChange | 이벤트 |
flash.events.Event
속성 Event.type =
flash.events.Event.NETWORK_CHANGE
런타임 버전: | AIR 1.0 |
새 네트워크 연결을 사용할 수 있게 되거나 기존 네트워크 연결이 끊어질 때 전달됩니다.
networkChange
이벤트가 발생했다고 해서 호스트 컴퓨터가 반드시 온라인 또는 오프라인 상태로 전환된 것은 아닙니다. 단순히 한 연결 유형에서 다른 연결 유형으로 전환된 것일 수도 있습니다. 응용 프로그램은 이 이벤트를 사용하여 원격 리소스 가용성을 모니터링하는 작업을 최적화할 수 있습니다. 주로 networkChange
이벤트가 전달될 때가 원격 리소스의 가용성을 확인하기에 좋은 시점입니다.
참고:
- 네트워크가 변경된 후 이 이벤트가 전송될 때까지 짧은 지연 시간이 있을 수 있습니다.
- Android에서는 NativeApplication 객체가 네트워크 연결의 각 변경 사항에 대해 여러 개의 networkChange 이벤트를 전달할 수 있습니다.
Event.NETWORK_CHANGE
상수는 networkChange
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
target | NativeApplication 객체입니다. |
suspend | 이벤트 |
flash.events.Event
속성 Event.type =
flash.events.Event.SUSPEND
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 3.3 |
응용 프로그램이 운영 체제에서 일시 중단될 경우 전달됩니다.
Event.SUSPEND
상수는 suspend
이벤트 객체의 type
속성 값을 정의합니다. 이 이벤트는 AIR iOS에서만 전달됩니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | NativeApplication 객체입니다. |
target | NativeApplication 객체입니다. |
userIdle | 이벤트 |
flash.events.Event
속성 Event.type =
flash.events.Event.USER_IDLE
런타임 버전: | AIR 1.0 |
사용자가 유휴 상태일 때 전달됩니다.
idleThreshold
속성을 사용하여 이 이벤트가 전달되는 데 필요한 사용자 유휴 시간을 지정합니다. 사용자가 유휴 상태였던 시간은 timeSinceLastUserInput
속성에서 확인할 수 있습니다.
참고: 이 이벤트는 휴대 장치 또는 AIR for TV 장치에 전달되지 않습니다.
Event.USER_IDLE
상수는 userIdle
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
target | NativeApplication 객체입니다. |
관련 API 요소
userPresent | 이벤트 |
flash.events.Event
속성 Event.type =
flash.events.Event.USER_PRESENT
런타임 버전: | AIR 1.0 |
운영 체제가 유휴 기간 후에 마우스 또는 키보드 동작을 감지할 때 전달됩니다.
참고: 이 이벤트는 휴대 장치 또는 AIR for TV 장치에 전달되지 않습니다.
유휴 상태로 간주되는 기간은 idleThreshold
속성을 사용하여 구성할 수 있습니다. 사용자가 유휴 상태였던 시간은 timeSinceLastUserInput
속성에서 확인할 수 있습니다.
Event.USER_PRESENT
상수는 userPresent
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
target | NativeApplication 객체입니다. |
관련 API 요소
Tue Jun 12 2018, 03:17 PM Z