활성 응용 프로그램 윈도우입니다.

활성 데스크톱 윈도우가 이 응용 프로그램에 속하지 않거나 활성 윈도우가 없으면 activeWindow가 null입니다.

이 AIR 응용 프로그램에 대한 응용 프로그램 설명자 파일의 내용입니다.

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);

이 응용 프로그램의 응용 프로그램 ID입니다.

이 ID의 값은 응용 프로그램 설명자 파일에서 설정됩니다.

모든 윈도우가 닫히면 응용 프로그램을 자동으로 종료할지 여부를 지정합니다.

autoExit가 기본값인 true이면 모든 윈도우가 닫힐 때 응용 프로그램이 종료됩니다. exiting 및 exit 이벤트가 모두 전달됩니다. autoExit가 false이면 NativeApplication.nativeApplication.exit()를 호출하여 응용 프로그램을 종료해야 합니다.

응용 프로그램 아이콘입니다.

NativeApplication.supportsDockIcon 및 NativeApplication.supportsSystemTrayIcon을 사용하여 icon 클래스를 확인합니다. 유형은 InteractiveIcon의 하위 클래스 중 하나가 됩니다. Mac^® OS X에서는 NativeApplication.icon이 DockIcon 유형의 객체입니다. Windows^®에서는 NativeApplication.icon이 SystemTrayIcon 유형의 객체입니다. Linux에서는 응용 프로그램 아이콘이 항상 지원되지는 않습니다. 이 경우 icon 속성은 null입니다.

icon 객체는 자동으로 생성성되지만 이미지 데이터를 사용하여 초기화되지 않습니다. Mac OS X와 같은 일부 운영 체제에서는 기본 이미지가 제공됩니다. Windows와 같은 다른 운영 체제에서는 이미지 데이터가 할당되지 않은 아이콘은 표시되지 않습니다. 아이콘 이미지를 할당하려면 적어도 하나의 BitmapData 객체를 포함하고 있는 배열로 icon.bitmaps 속성을 설정하십시오. 배열에 BitmapData 객체가 여러 개 포함되어 있는 경우에는 운영 체제가 아이콘의 표시 크기와 가장 비슷한 크기의 이미지를 선택하고, 필요할 경우 이미지의 크기를 조절합니다.

참고 사항

userIdle 이벤트가 전달되기까지 아무런 키보드 또는 마우스 입력 없이 경과되어야 하는 시간(초)입니다.

기본적으로 유휴 임계값은 300초(5분)입니다.

참고 사항

응용 프로그램 메뉴입니다.

응용 프로그램 메뉴는 NativeApplication.nativeApplication.supportsMenu가 true일 때 지원됩니다. 모든 운영 체제가 응용 프로그램 메뉴를 지원하는 것은 아닙니다. 예를 들어 응용 프로그램 메뉴는 Mac OS X에서는 지원되지만 Windows 또는 Linux에서는 지원되지 않습니다. NativeApplication.nativeApplication.supportsMenu가 false일 때 이 속성에 NativeMenu 객체를 할당하는 것은 허용되지만 아무런 효과가 없습니다.

참고: Mac OS X에서는 menu 속성이 운영 체제에서 제공하는 기본 응용 프로그램 메뉴를 참조합니다. 항목 및 하위 메뉴를 추가 및 제거하고 이벤트 리스너를 추가하여 기존 메뉴 구조를 수정할 수 있습니다. 또한 새 NativeMenu 객체를 이 menu 속성에 지정하여 기본 메뉴를 완전히 교체할 수 있습니다.

참고 사항

NativeApplication 객체의 단일 인스턴스입니다.

이 응용 프로그램의 열려 있는 기본 윈도우를 모두 포함하는 배열입니다.

이 응용 프로그램의 배급자 ID입니다.

이 ID의 값은 응용 프로그램의 publisherid 파일에서 설정됩니다. 이 파일은 설치할 때 응용 프로그램을 서명하는 데 사용된 인증서 체인으로부터 생성됩니다.

이 응용 프로그램을 호스팅하는 런타임의 패치 수준입니다.

이 응용 프로그램을 호스팅하는 런타임의 버전 번호입니다.

현재 사용자가 로그인할 때마다 이 응용 프로그램을 자동으로 실행할지 여부를 지정합니다.

startAtLogin 속성은 사용자가 로그인할 때 응용 프로그램이 자동으로 시작되어야 한다는 것을 지정하는 운영 체제 정의 메커니즘의 상태를 반영합니다. 사용자는 운영 체제 사용자 인터페이스를 사용하여 상태를 수동으로 변경할 수 있습니다. 이 속성은 AIR 응용 프로그램 또는 운영 체제에 의해 상태가 마지막으로 변경되었는지 여부에 관계없이 현재 상태를 반영합니다.

AIR이 현재 운영 체제에 대한 응용 프로그램 도크 아이콘을 지원하는지 여부를 나타냅니다.

true인 경우 NativeApplication.icon 속성의 유형은 DockIcon입니다.

Mac OS X 및 여러 Linux^® 사용자 인터페이스는 실행 중인 응용 프로그램 또는 자주 사용하는 응용 프로그램의 아이콘을 포함하고 있는 응용 프로그램 "도크"를 제공합니다.

참고 사항

현재 운영 체제가 전역 응용 프로그램 메뉴 모음을 지원하는지 여부를 지정합니다.

true인 경우 NativeApplication.menu 속성은 기본 응용 프로그램 메뉴를 정의(또는 액세스)하는 데 사용될 수 있습니다.

참고 사항

AIR이 현재 운영 체제에 대한 시스템 트레이 아이콘을 지원하는지 여부를 지정합니다.

true인 경우 NativeApplication.icon 속성의 유형은 SystemTrayIcon입니다.

참고: Windows에서는 작업 표시줄의 시스템 트레이 영역을 공식적으로 알림 영역이라고 합니다.

참고 사항

마지막 마우스 또는 키보드 입력 이후 경과된 시간입니다.

참고 사항

이 응용 프로그램을 활성화합니다.

운영 체제가 정한 특정 상황에서 이 메서드는 응용 프로그램을 활성화하지 않습니다. 대부분의 운영 체제는 한 응용 프로그램이 사용자가 다른 응용 프로그램을 사용하는 것을 의도치 않게 또는 악의적으로 불가능하게 만드는 것을 방지하기 위해 자체적으로 활성화되는 것을 제한합니다.

운영 체제가 활성화를 허용하는 경우 지정된 윈도우가 활성화되고 데스크톱 포그라운드, 즉 다른 응용 프로그램의 윈도우 앞으로 가져와집니다. window 매개 변수가 null인 경우에는 이 응용 프로그램의 표시된 윈도우가 활성화됩니다.

응용 프로그램에 표시된 윈도우가 없는 경우에는 activate() 메서드가 아무런 효과가 없습니다.

활성화 작업이 동기적입니다.

매개 변수

리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. 표시 목록의 모든 노드에서 특정 유형의 이벤트, 단계, 우선 순위에 대한 이벤트 리스너를 등록할 수 있습니다.

이벤트 리스너의 등록을 마친 뒤에는 addEventListener()를 추가로 호출하여 그 우선 순위를 변경할 수 없습니다. 리스너의 우선 순위를 변경하려면 먼저 removeListener()를 호출해야 합니다. 그런 다음 해당 리스너를 새로운 우선 순위 레벨로 다시 등록할 수 있습니다.

일단 리스너가 등록된 뒤에 type 또는 useCapture 값을 달리하여 addEventListener()를 이어서 호출하면 별도의 리스너 등록이 생성된다는 것에 유의합니다. 예를 들어, useCapture가 true로 설정된 리스너를 등록하면 이 리스너는 캡처 단계 동안에만 수신합니다. 그러나 useCapture를 false로 설정하고 동일한 리스너 객체를 사용하여 addEventListener()를 다시 호출하면 별도로 두 개의 리스너가 등록되어, 한 리스너는 캡처 단계 동안 수신하고 다른 하나는 대상 및 버블링 단계 동안 수신합니다.

대상 단계 또는 버블링 단계 전용의 이벤트 리스너를 등록할 수는 없습니다. 버블링은 대상 노드의 조상에만 적용되기 때문에 이들 단계는 등록 과정에서 하나로 통합됩니다.

사용하지 않는 이벤트 리스너는 removeEventListener()를 호출하여 제거하도록 합니다. 이렇게 하지 않으면 메모리 문제가 발생할 수 있습니다. 가비지 수집기는 참조가 남아 있는 객체를 제거하지 않으므로, 등록된 이벤트 리스너가 있는 객체는 메모리에서 자동으로 제거되지 않습니다.

EventDispatcher 인스턴스를 복사해도 연결된 이벤트 리스너는 복사되지 않습니다. 새로 만든 노드에 이벤트 리스너가 필요한 경우, 노드를 만든 후 리스너를 연결해야 합니다. 그러나 EventDispatcher 인스턴스를 이동할 때에는 연결된 이벤트 리스너도 함께 이동됩니다.

이벤트를 처리 중인 노드에서 이벤트 리스너를 등록하는 경우, 그 이벤트 리스너는 현재 단계 동안에는 트리거되지 않지만 이벤트 흐름에서 이후 단계(예: 버블링 단계) 동안에는 트리거될 수 있습니다.

이벤트를 처리 중인 노드에서 이벤트 리스너를 제거하는 경우, 그 리스너는 현재 액션에 의해 트리거됩니다. 일단 제거된 이벤트 리스너는 이후의 처리를 위해 재등록하지 않는 한 다시는 호출되지 않습니다.

매개 변수

function(evt:Event):void

포커스가 있는 표시 객체에서 내부 삭제 명령을 호출합니다.

포커스가 있는 객체가 명령을 구현하지 않을 경우 이 함수 호출은 무시됩니다. TextField 또는 HTMLLoader 클래스의 자손인 표시 객체만 현재 이 명령을 구현합니다.

참고: clear() 명령은 선택한 텍스트를 삭제합니다. 선택된 항목이 없는 경우 모든 텍스트를 지우지는 않습니다.

포커스가 있는 표시 객체에서 내부 복사 명령을 호출합니다.

구성 요소가 명령을 구현하지 않을 경우 이 함수 호출은 무시됩니다. TextField 또는 HTMLLoader 클래스의 자손인 표시 객체만 현재 이 명령을 구현합니다.

포커스가 있는 표시 객체에서 내부 잘라내기 명령을 호출합니다.

구성 요소가 명령을 구현하지 않을 경우 이 함수 호출은 무시됩니다. TextField 또는 HTMLLoader 클래스의 자손인 표시 객체만 현재 이 명령을 구현합니다.

이벤트를 이벤트 흐름으로 전달합니다. 이벤트 대상은 dispatchEvent() 메서드가 호출된 EventDispatcher 객체입니다.

매개 변수

이 응용 프로그램을 종료합니다.

exit() 메서드에 대한 호출이 반환됩니다. 현재 실행 중인 코드(예: 현재 이벤트 핸들러)가 완료되기 전까지는 종료 시퀀스가 시작되지 않습니다. 대기 중인 비동기 작업은 취소되며, 완료될 수도 있고 완료되지 않을 수도 있습니다.

exiting 이벤트는 전달되지 않습니다. 응용 프로그램 논리에 exiting 이벤트가 필요한 경우에는 NativeApplication.nativeApplication.dispatchEvent()를 호출하고 exiting 유형의 Event 객체를 전달합니다. 마찬가지로 closing 및 close 이벤트는 응용 프로그램 윈도우가 닫히기 전에 전달되지 않습니다. 응용 프로그램이 종료되기 전에 윈도우에 알려야 하는 경우에는 열려 있는 각 윈도우에 대해 closing 이벤트를 전달하면 됩니다. 윈도우 close 이벤트가 필요한 경우에는 종료하기 전에 윈도우의 close() 메서드를 호출하십시오.

매개 변수

지정된 확장명을 사용하는 파일을 열 기본 응용 프로그램을 가져옵니다.

참고: 이 메서드는 응용 프로그램 설명자의 fileTypes 문에서 선언된 파일 유형에만 사용할 수 있습니다.

매개 변수

참고 사항

이 응용 프로그램이 현재 지정된 확장명을 사용하는 파일을 열 기본 응용 프로그램인지 여부를 지정합니다.

매개 변수

참고 사항

포커스가 있는 표시 객체에서 내부 붙여넣기 명령을 호출합니다.

구성 요소가 명령을 구현하지 않을 경우 이 함수 호출은 무시됩니다. TextField 또는 HTMLLoader 클래스의 자손인 표시 객체만 현재 이 명령을 구현합니다.

지정된 확장명을 사용하는 파일을 열 기본값으로 이 응용 프로그램을 제거합니다.

참고: 이 메서드는 응용 프로그램 설명자에서 fileTypes 문에 나열된 파일 유형에만 사용할 수 있습니다.

매개 변수

참고 사항

EventDispatcher 객체에서 리스너를 제거합니다. EventDispatcher 객체와 함께 등록된 리스너 중 일치하는 것이 없다면 이 메서드를 호출해도 아무 영향이 없습니다.

매개 변수

포커스가 있는 표시 객체에서 내부 모두 선택 명령을 호출합니다.

구성 요소가 명령을 구현하지 않을 경우 이 함수 호출은 무시됩니다. TextField 또는 HTMLLoader 클래스의 자손인 표시 객체만 현재 이 명령을 구현합니다.

지정된 확장명을 사용하는 파일을 열 기본 응용 프로그램으로 이 응용 프로그램을 설정합니다.

참고: 이 메서드는 응용 프로그램 설명자의 fileTypes 문에서 선언된 파일 유형에만 사용할 수 있습니다.

매개 변수

참고 사항

이 응용 프로그램이 활성 데스크톱 응용 프로그램이 될 때 전달됩니다.

참고: 이 이벤트에는 "캡처 단계" 또는 "버블링 단계"가 없으므로 대상이 표시 목록에 있는지 여부에 관계없이 잠재적인 모든 대상에 이벤트 리스너를 직접 추가해야 합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

사용자 브라우저에서 실행되는 SWF 파일로 인해 응용 프로그램이 호출될 때 전달됩니다.

응용 프로그램이 응용 프로그램 설명자 파일에 다음을 지정하는 경우에만 브라우저를 호출할 수 있습니다.

<allowBrowserInvocation>true</allowBrowserInvocation>

데스크톱 포커스가 다른 응용 프로그램으로 전환될 때 전달됩니다.

참고: 이 이벤트에는 "캡처 단계" 또는 "버블링 단계"가 없으므로 대상이 표시 목록에 있는지 여부에 관계없이 잠재적인 모든 대상에 이벤트 리스너를 직접 추가해야 합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

응용 프로그램의 종료 시퀀스가 시작될 때 전달됩니다.

사용자가 Mac OS X에서 Cmd-Q 키 시퀀스를 실행하거나, NativeApplication 객체의 autoExit 속성이 true이고 마지막 응용 프로그램 윈도우가 닫힐 때와 같이 운영 체제에서 응용 프로그램 종료가 시작될 때 exiting 이벤트가 전달됩니다. 이 이벤트를 취소하면 응용 프로그램이 종료되지 않습니다.

참고: NativeApplication exit() 메서드를 호출한다고 해서 exiting 이벤트가 전달되는 것은 아닙니다. 곧 종료됨을 구성 요소에 경고하려면 exit()를 호출하기 전에 exiting 이벤트를 전달합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

응용 프로그램이 호출될 때 전달됩니다.

응용 프로그램이 두 번째로 호출될 때 응용 프로그램의 또 다른 인스턴스가 시작되지 않습니다. 대신 첫 번째 인스턴스가 추가적인 invoke 이벤트를 수신합니다. 후속 invoke 이벤트를 적절히 처리하는 것은 응용 프로그램이 담당합니다.

참고: 모든 invoke 이벤트가 대기열에 보관됩니다. 이 이벤트의 리스너가 등록되어 있으면 해당 리스너는 대기열에 있는 모든 이벤트는 물론 새 이벤트도 수신합니다. 대기열에 있는 이벤트는 새 invoke 이벤트 이전 또는 이후에 전송될 수 있습니다.

InvokeEvent 객체에는 다음과 같은 속성이 있습니다.

새 네트워크 연결을 사용할 수 있게 되거나 기존 네트워크 연결이 끊어질 때 전달됩니다.

networkChange 이벤트가 발생했다고 해서 호스트 컴퓨터가 반드시 온라인 또는 오프라인 상태로 전환된 것은 아닙니다. 단순히 한 연결 유형에서 다른 연결 유형으로 전환된 것일 수도 있습니다. 응용 프로그램은 이 이벤트를 사용하여 원격 리소스 가용성을 모니터링하는 작업을 최적화할 수 있습니다. 주로 networkChange 이벤트가 전달될 때가 원격 리소스의 가용성을 확인하기에 좋은 시점입니다.

참고: 네트워크가 변경된 후 이 이벤트가 전송될 때까지 짧은 지연 시간이 있을 수 있습니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

사용자가 idleThreshold 속성으로 지정된 기간 동안 유휴 상태일 때 전달됩니다.

사용자가 유휴 상태였던 시간은 timeSinceLastUserInput 속성에서 확인할 수 있습니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

참고 사항

운영 체제가 유휴 기간 후에 마우스 또는 키보드 동작을 감지할 때 전달됩니다.

유휴 상태로 간주되는 기간은 idleThreshold 속성을 사용하여 구성할 수 있습니다. 사용자가 유휴 상태였던 시간은 timeSinceLastUserInput 속성에서 확인할 수 있습니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

참고 사항