| 패키지 | flash.events |
| 클래스 | public class InvokeEvent |
| 상속 | InvokeEvent  Event Object |
| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0 |
invoke 이벤트를 전달합니다.
NativeApplication 객체는 응용 프로그램이 시작되었지만 이벤트가 다른 때에도 전달될 수 있는 경우에 항상 invoke 이벤트를 전달합니다. 예를 들어 사용자가 실행 중인 응용 프로그램과 연관된 파일을 활성화할 때 이 응용 프로그램이 추가 InvokeEvent를 전달합니다.
특정 응용 프로그램의 인스턴스 하나만 시작할 수 있습니다. 이후에 응용 프로그램을 시작하려고 하면 실행 중인 인스턴스의 NativeApplication 객체에 의해 새 invoke 이벤트가 전달됩니다. 응용 프로그램은 이 이벤트를 처리하고 파일에 데이터를 표시할 새 응용 프로그램 윈도우 열기 등과 같은 적절한 액션을 취해야 합니다.
InvokeEvent 객체는 NativeApplication 객체(NativeApplication.nativeApplication)에 의해 전달됩니다. invoke 이벤트를 수신하려면 NativeApplication 객체의 addEventListener() 메서드를 호출합니다. 이벤트 리스너가 invoke 이벤트를 등록하면 등록 이전에 발생된 모든 invoke 이벤트도 수신됩니다. 이러한 이전 이벤트는 addEventListener() 호출이 반환된 후에 전달되지만 등록 후에 전달될 수 있는 새 invoke 이벤트 이전에 전달되지 않을 수도 있습니다. 따라서 전달 순서에 의존하지 않아야 합니다.
관련 API 요소
상속되는 공용 속성 숨기기
상속되는 공용 속성 표시| 속성 | 정의 주체 | ||
|---|---|---|---|
| arguments : Array [읽기 전용]
이 호출 중에 전달된 문자열 인수의 배열입니다. | InvokeEvent | ||
 | bubbles : Boolean [읽기 전용]
이벤트가 버블링 이벤트인지 여부를 나타냅니다. | Event | |
| cancelable : Boolean [읽기 전용]
해당 이벤트와 연관된 비헤이비어를 차단할 수 있는지 여부를 나타냅니다. | Event | |
| constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
| currentDirectory : File [읽기 전용]
arguments 배열의 상대 경로를 확인하는 데 사용해야 하는 디렉토리입니다. | InvokeEvent | ||
| currentTarget : Object [읽기 전용]
이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. | Event | |
| eventPhase : uint [읽기 전용]
이벤트 흐름에서 현재 단계입니다. | Event | |
| reason : String [읽기 전용]
이 InvokeEvent에 대한 이유입니다. | InvokeEvent | ||
| target : Object [읽기 전용]
이벤트 대상입니다. | Event | |
| type : String [읽기 전용]
이벤트 유형입니다. | Event | |
| 메서드 | 정의 주체 | ||
|---|---|---|---|
InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")
InvokeEvent 클래스의 생성자 함수입니다. | InvokeEvent | ||
[재정의]
이 이벤트의 새 복사본을 만듭니다. | InvokeEvent | ||
|
사용자 정의 ActionScript 3.0 Event 클래스에서 toString() 메서드를 구현하기 위한 유틸리티 함수입니다. | Event | |
|
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | |
|
이벤트에서 preventDefault() 메서드가 호출되었는지 여부를 확인합니다. | Event | |
|
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | |
|
이벤트의 기본 비헤이비어를 취소할 수 있는 경우, 그 비헤이비어를 취소합니다. | Event | |
|
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | |
|
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | |
|
이벤트 흐름에서 현재 노드 및 그 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다. | Event | |
|
이벤트 흐름에서 현재 노드의 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다. | Event | |
|
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | |
|
Event 객체의 속성이 모두 포함된 문자열을 반환합니다. | Event | |
|
지정된 객체의 프리미티브 값을 반환합니다. | Object | |
| 상수 | 정의 주체 | ||
|---|---|---|---|
| INVOKE : String = "invoke" [정적]
InvokeEvent.INVOKE 상수는 InvokeEvent 객체의 type 속성 값을 정의합니다. | InvokeEvent | ||
arguments | 속성 |
arguments:Array [읽기 전용] | 런타임 버전: | AIR 1.0 |
이 호출 중에 전달된 문자열 인수의 배열입니다. 이 호출이 명령줄 호출인 경우 배열은 프로세스 이름을 제외한 명령줄 인수를 포함합니다.
모바일 플랫폼에서 이 속성에는 명령줄 인수가 아닌 응용 프로그램 시작 당시의 옵션 배열이 포함됩니다. 또한 모바일 플랫폼에서 reason이 InvokeEventReason.OPEN_URL인 경우 인수 Array의 내용은 다음과 같이 다양합니다.
- 다른 응용 프로그램 또는 브라우저에서 사용자 정의 URL을 사용하여 응용 프로그램을 호출한 경우(iOS 및 Android):
arguments iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]소스 응용 프로그램 ID 작업 ID InvokeEvent.arguments[2]null NA - 시스템에서 관련 파일 유형을 열기 위해 응용 프로그램을 호출하는 경우(iOS 및 Android):
arguments iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]null 작업 ID InvokeEvent.arguments[2]null NA - 다른 응용 프로그램에서 문서 상호 작용 컨트롤러를 사용하여 응용 프로그램을 호출하는 경우(iOS만 해당됨):
arguments iOS InvokeEvent.arguments.length3 InvokeEvent.arguments[0]url InvokeEvent.arguments[1]소스 응용 프로그램 ID InvokeEvent.arguments[2]주석
참고: 여러 개의 파일이 Mac® OS X에서 선택되어 열려 있으면 AIR는 arguments 배열에서 선택된 모든 파일의 이름을 포함하는 invoke 이벤트 하나를 전달합니다. 그러나 Windows® 및 Linux에서는 AIR가 arguments 배열에 있는 파일 이름만 포함하는 선택된 각 파일에 대해 별도의 invoke 이벤트를 전달합니다.
구현
public function get arguments():Array currentDirectory | 속성 |
reason | 속성 |
reason:String [읽기 전용] | 런타임 버전: | AIR 1.5.1 |
이 InvokeEvent에 대한 이유입니다. 이 속성은 응용 프로그램을 사용자가 수동으로 실행했는지 아니면 로그인 시 자동으로 실행했는지를 나타냅니다. 유효한 값은 InvokeEventReason 클래스의 상수로 열거됩니다.
| InvokeEventReason 상수 | 의미 |
|---|---|
LOGIN | 로그인 시 자동으로 실행되었습니다. |
NOTIFICATION | 알림에 대한 응답으로 시작되었습니다(iOS만 해당됨). |
OPEN_URL | 응용 프로그램이 다른 응용 프로그램에 의해 호출되었기 때문에 시작되었습니다. |
STANDARD | 다른 이유로 실행되었습니다. |
참고: 모바일 플랫폼에서 reason 속성은 절대로 LOGIN으로 설정되지 않습니다.
구현
public function get reason():String관련 API 요소
InvokeEvent | () | 생성자 |
public function InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0 |
InvokeEvent 클래스의 생성자 함수입니다.
매개 변수type:String — 이벤트 유형으로, Event.type으로 액세스할 수 있습니다.
| |
bubbles:Boolean (default = false)false로 설정합니다.
| |
cancelable:Boolean (default = false)false로 설정합니다.
| |
dir:File (default = null)인수 배열의 상대 경로를 확인하는 데 사용해야 하는 디렉토리입니다.
| |
argv:Array (default = null) | |
reason:String (default = "standard")InvokeEventReason.LOGIN, InvokeEventReason.STANDARD, InvokeEventReason.OPEN_URL 또는 InvokeEventReason.NOTIFICATION (이 매개 변수는 AIR 버전 1.5.1부터 사용 가능. OPEN_URL 및 NOTIFICATION은 AIR 버전 3.5부터 사용 가능)
|
관련 API 요소
clone | () | 메서드 |
INVOKE | 상수 |
public static const INVOKE:String = "invoke"| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | AIR 1.0 |
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 객체입니다. |
관련 API 요소
Tue Jun 12 2018, 03:17 PM Z