flash.events.InvokeEvent (ActionScript 3.0)

(AIR만 해당)

패키지	flash.events
클래스	public class InvokeEvent
상속	InvokeEvent Event Object

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

AIR 응용 프로그램의 NativeApplication 객체는 응용 프로그램이 호출될 때 invoke 이벤트를 전달합니다.

NativeApplication 객체는 응용 프로그램이 시작되었지만 이벤트가 다른 때에도 전달될 수 있는 경우에 항상 invoke 이벤트를 전달합니다. 예를 들어 사용자가 실행 중인 응용 프로그램과 연관된 파일을 활성화할 때 이 응용 프로그램이 추가 InvokeEvent를 전달합니다.

특정 응용 프로그램의 인스턴스 하나만 시작할 수 있습니다. 이후에 응용 프로그램을 시작하려고 하면 실행 중인 인스턴스의 NativeApplication 객체에 의해 새 invoke 이벤트가 전달됩니다. 응용 프로그램은 이 이벤트를 처리하고 파일에 데이터를 표시할 새 응용 프로그램 윈도우 열기 등과 같은 적절한 액션을 취해야 합니다.

InvokeEvent 객체는 NativeApplication 객체(NativeApplication.nativeApplication)를 통해 전달됩니다. invoke 이벤트를 수신하려면 NativeApplication 객체의 addEventListener() 메서드를 호출합니다. 이벤트 리스너가 invoke 이벤트를 등록하면 등록 이전에 발생된 모든 invoke 이벤트도 수신됩니다. 이러한 이전 이벤트는 addEventListener() 호출이 반환된 후에 전달되지만 등록 후에 전달될 수 있는 새 invoke 이벤트 이전에 전달되지 않을 수도 있습니다. 따라서 전달 순서에 의존하지 않아야 합니다.

참고 사항

flash.events.BrowserInvokeEvent
flash.desktop.NativeApplication

	속성	다음에 의해 정의됨
		arguments : Array [읽기 전용] 이 호출 중에 전달된 문자열 인수의 배열입니다.	InvokeEvent
		bubbles : Boolean [읽기 전용] 이벤트가 버블링 이벤트인지 여부를 나타냅니다.	Event
		cancelable : Boolean [읽기 전용] 해당 이벤트와 연관된 비헤이비어를 차단할 수 있는지 여부를 나타냅니다.	Event
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object
		currentDirectory : File [읽기 전용] arguments 배열의 상대 경로를 확인하는 데 사용해야 하는 디렉토리입니다.	InvokeEvent
		currentTarget : Object [읽기 전용] 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.	Event
		eventPhase : uint [읽기 전용] 이벤트 흐름에서 현재 단계입니다.	Event
		prototype : Object [정적] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.	Object
		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
		clone():Event 이 이벤트의 새 복사본을 만듭니다.	InvokeEvent
		formatToString(className:String, ... arguments):String 사용자 정의 ActionScript 3.0 Event 클래스에서 toString() 메서드를 구현하기 위한 유틸리티 함수입니다.	Event
		hasOwnProperty(name:String):Boolean 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.	Object
		isDefaultPrevented():Boolean 이벤트에서 preventDefault() 메서드가 호출되었는지 여부를 확인합니다.	Event
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		preventDefault():void 이벤트의 기본 비헤이비어를 취소할 수 있는 경우, 그 비헤이비어를 취소합니다.	Event
		propertyIsEnumerable(name:String):Boolean 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		stopImmediatePropagation():void 이벤트 흐름에서 현재 노드 및 그 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다.	Event
		stopPropagation():void 이벤트 흐름에서 현재 노드의 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다.	Event
		toString():String Event 객체의 속성이 모두 포함된 문자열을 반환합니다.	Event
		valueOf():Object 지정된 객체의 프리미티브 값을 반환합니다.	Object

Public 상수

상속되는 Public 상수 숨기기

상속되는 Public 상수 표시

	상수		다음에 의해 정의됨
		ACTIVATE : String = "activate" [정적] ACTIVATE 상수는 activate 이벤트 객체의 type 속성 값을 정의합니다.	Event
		ADDED : String = "added" [정적] Event.ADDED 상수는 added 이벤트 객체의 type 속성 값을 정의합니다.	Event
		ADDED_TO_STAGE : String = "addedToStage" [정적] Event.ADDED_TO_STAGE 상수는 addedToStage 이벤트 객체의 type 속성 값을 정의합니다.	Event
		CANCEL : String = "cancel" [정적] Event.CANCEL 상수는 cancel 이벤트 객체의 type 속성 값을 정의합니다.	Event
		CHANGE : String = "change" [정적] Event.CHANGE 상수는 change 이벤트 객체의 type 속성 값을 정의합니다.	Event
		CLEAR : String = "clear" [정적] Event.CLEAR 상수는 clear 이벤트 객체의 type 속성 값을 정의합니다.	Event
		CLOSE : String = "close" [정적] Event.CLOSE 상수는 close 이벤트 객체의 type 속성 값을 정의합니다.	Event
		CLOSING : String = "closing" [정적] Event.CLOSING 상수는 closing 이벤트 객체의 type 속성 값을 정의합니다.	Event
		COMPLETE : String = "complete" [정적] Event.COMPLETE 상수는 이벤트 객체의 type 속성 값을 정의합니다.	Event
		CONNECT : String = "connect" [정적] Event.CONNECT 상수는 connect 이벤트 객체의 type 속성 값을 정의합니다.	Event
		COPY : String = "copy" [정적] copy 이벤트 객체의 type 속성 값을 정의합니다.	Event
		CUT : String = "cut" [정적] cut 이벤트 객체의 type 속성 값을 정의합니다.	Event
		DEACTIVATE : String = "deactivate" [정적] Event.DEACTIVATE 상수는 deactivate 이벤트 객체의 type 속성 값을 정의합니다.	Event
		DISPLAYING : String = "displaying" [정적] Event.DISPLAYING 상수는 displaying 이벤트 객체의 type 속성 값을 정의합니다.	Event
		ENTER_FRAME : String = "enterFrame" [정적] Event.ENTER_FRAME 상수는 enterFrame 이벤트 객체의 type 속성 값을 정의합니다.	Event
		EXIT_FRAME : String = "exitFrame" [정적] Event.EXIT_FRAME 상수는 exitFrame 이벤트 객체의 type 속성 값을 정의합니다.	Event
		EXITING : String = "exiting" [정적] Event.EXITING 상수는 exiting 이벤트 객체의 type 속성 값을 정의합니다.	Event
		FRAME_CONSTRUCTED : String = "frameConstructed" [정적] Event.FRAME_CONSTRUCTED 상수는 frameConstructed 이벤트 객체의 type 속성 값을 정의합니다.	Event
		FULLSCREEN : String = "fullScreen" [정적] Event.FULL_SCREEN 상수는 fullScreen 이벤트 객체의 type 속성 값을 정의합니다.	Event
		HTML_BOUNDS_CHANGE : String = "htmlBoundsChange" [정적] Event.HTML_BOUNDS_CHANGE 상수는 htmlBoundsChange 이벤트 객체의 type 속성 값을 정의합니다.	Event
		HTML_DOM_INITIALIZE : String = "htmlDOMInitialize" [정적] Event.HTML_DOM_INITIALIZE 상수는 htmlDOMInitialize 이벤트 객체의 type 속성 값을 정의합니다.	Event
		HTML_RENDER : String = "htmlRender" [정적] Event.HTML_RENDER 상수는 htmlRender 이벤트 객체의 type 속성 값을 정의합니다.	Event
		ID3 : String = "id3" [정적] Event.ID3 상수는 id3 이벤트 객체의 type 속성 값을 정의합니다.	Event
		INIT : String = "init" [정적] Event.INIT 상수는 init 이벤트 객체의 type 속성 값을 정의합니다.	Event
		INVOKE : String = "invoke" [정적] InvokeEvent.INVOKE 상수는 InvokeEvent 객체의 type 속성 값을 정의합니다.	InvokeEvent
		LOCATION_CHANGE : String = "locationChange" [정적] Event.LOCATION_CHANGE 상수는 locationChange 이벤트 객체의 type 속성 값을 정의합니다.	Event
		MOUSE_LEAVE : String = "mouseLeave" [정적] Event.MOUSE_LEAVE 상수는 mouseLeave 이벤트 객체의 type 속성 값을 정의합니다.	Event
		NETWORK_CHANGE : String = "networkChange" [정적] Event.NETWORK_CHANGE 상수는 networkChange 이벤트 객체의 type 속성 값을 정의합니다.	Event
		OPEN : String = "open" [정적] Event.OPEN 상수는 open 이벤트 객체의 type 속성 값을 정의합니다.	Event
		PASTE : String = "paste" [정적] Event.PASTE 상수는 paste 이벤트 객체의 type 속성 값을 정의합니다.	Event
		REMOVED : String = "removed" [정적] Event.REMOVED 상수는 removed 이벤트 객체의 type 속성 값을 정의합니다.	Event
		REMOVED_FROM_STAGE : String = "removedFromStage" [정적] Event.REMOVED_FROM_STAGE 상수는 removedFromStage 이벤트 객체의 type 속성 값을 정의합니다.	Event
		RENDER : String = "render" [정적] Event.RENDER 상수는 render 이벤트 객체의 type 속성 값을 정의합니다.	Event
		RESIZE : String = "resize" [정적] Event.RESIZE 상수는 resize 이벤트 객체의 type 속성 값을 정의합니다.	Event
		SCROLL : String = "scroll" [정적] Event.SCROLL 상수는 scroll 이벤트 객체의 type 속성 값을 정의합니다.	Event
		SELECT : String = "select" [정적] Event.SELECT 상수는 select 이벤트 객체의 type 속성 값을 정의합니다.	Event
		SELECT_ALL : String = "selectAll" [정적] Event.SELECT_ALL 상수는 selectAll 이벤트 객체의 type 속성 값을 정의합니다.	Event
		SOUND_COMPLETE : String = "soundComplete" [정적] Event.SOUND_COMPLETE 상수는 soundComplete 이벤트 객체의 type 속성 값을 정의합니다.	Event
		TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [정적] Event.TAB_CHILDREN_CHANGE 상수는 tabChildrenChange 이벤트 객체의 type 속성 값을 정의합니다.	Event
		TAB_ENABLED_CHANGE : String = "tabEnabledChange" [정적] Event.TAB_ENABLED_CHANGE 상수는 tabEnabledChange 이벤트 객체의 type 속성 값을 정의합니다.	Event
		TAB_INDEX_CHANGE : String = "tabIndexChange" [정적] Event.TAB_INDEX_CHANGE 상수는 tabIndexChange 이벤트 객체의 type 속성 값을 정의합니다.	Event
		UNLOAD : String = "unload" [정적] Event.UNLOAD 상수는 unload 이벤트 객체의 type 속성 값을 정의합니다.	Event
		USER_IDLE : String = "userIdle" [정적] Event.USER_IDLE 상수는 userIdle 이벤트 객체의 type 속성 값을 정의합니다.	Event
		USER_PRESENT : String = "userPresent" [정적] Event.USER_PRESENT 상수는 userPresent 이벤트 객체의 type 속성 값을 정의합니다.	Event

속성 정보

arguments

속성

arguments:Array [읽기 전용]

런타임 버전:

AIR 1.0

이 호출 중에 전달된 문자열 인수의 배열입니다. 이 호출이 명령줄 호출인 경우 배열은 프로세스 이름을 제외한 명령줄 인수를 포함합니다.

참고: 여러 개의 파일이 Mac^® OS X에서 선택되어 열려 있으면 AIR은 arguments 배열에서 선택된 모든 파일의 이름을 포함하는 invoke 이벤트 하나를 전달합니다. 하지만 Windows^® 및 Linux에서는 AIR이 arguments 배열에 있는 파일 이름만 들어 있는 선택된 각 파일에 대해 별도의invoke 이벤트를 전달합니다.

구현
public function get arguments():Array

currentDirectory

속성

currentDirectory:File [읽기 전용]

런타임 버전:

AIR 1.0

인수 배열의 상대 경로를 확인하는 데 사용해야 하는 디렉토리입니다.

응용 프로그램이 명령줄에서 시작하는 경우 이 속성은 일반적으로 해당 응용 프로그램이 시작된 명령줄 셸의 현재 작업 디렉토리로 설정됩니다. 응용 프로그램이 GUI 셸에서 시작되는 경우 이 디렉토리는 일반적으로 파일 시스템 루트입니다.

구현
public function get currentDirectory():File

reason

속성

reason:String [읽기 전용]

런타임 버전:

AIR 1.5.1

이 InvokeEvent에 대한 이유입니다. 이 속성은 사용자가 응용 프로그램을 수동으로 실행할지 로그인 시 자동으로 실행할지를 지정합니다. 유효한 값은 InvokeEventReason 클래스의 상수로 열거됩니다.

InvokeEventReason 상수	의미
`LOGIN`	로그인 시 자동으로 실행되었습니다.
`STANDARD`	사용자가 수동으로 실행했습니다.

구현
public function get reason():String

참고 사항

flash.desktop.InvokeEventReason

생성자 정보

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`) — InvokeEvent 객체에 대해 `false`로 설정합니다.

	`cancelable:Boolean` (default = `false`) — InvokeEvent 객체에 대해 `false`로 설정합니다.

	`dir:File` (default = `null`) — `인수` 배열의 상대 경로를 확인하는 데 사용해야 하는 디렉토리입니다.

	`argv:Array` (default = `null`) — 응용 프로그램으로 전달할 인수(문자열)의 배열입니다.

	`reason:String` (default = "`standard`")

메서드 정보

clone

()

메서드

override public function clone():Event

런타임 버전:

AIR 1.0

이 이벤트의 새 복사본을 만듭니다.

반환값

Event — 이벤트의 복사본입니다.

상수 정보

INVOKE

상수

public static const INVOKE:String = "invoke"

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0

InvokeEvent.INVOKE 상수는 InvokeEvent 객체의 type 속성 값을 정의합니다.

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

속성	값
`arguments`	이 호출 중에 전달된 문자열 인수의 배열입니다.
`currentDirectory`	arguments 배열의 상대 경로를 확인하는 데 사용해야 하는 디렉토리를 나타내는 File 객체입니다.
`bubbles`	`false`.
`cancelable`	`false`; 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	현재 이벤트 리스너를 통해 이 InvokeEvent 객체를 처리하고 있는 객체를 나타냅니다.
`target`	항상 NativeApplication 객체입니다.

참고 사항

flash.desktop.NativeApplication

ActionScript 3.0 언어 및 구성 요소 참조 설명서		홈 \| 모든 패키지 \| 모든 클래스 \| 언어 요소 \| 색인 \| 부록 \| 규칙 \| 프레임 비프레임
InvokeEvent	속성 \| 메서드 \| 상수