(AIR のみ)
パッケージflash.events
クラスpublic class InvokeEvent
継承InvokeEvent Inheritance Event Inheritance Object

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0

invoke イベントは、AIR アプリケーションが呼び出されたときに、アプリケーションの NativeApplication オブジェクトによって送出されます。

invoke イベントはアプリケーションが起動されたときに NativeApplication オブジェクトによって必ず送出されますが、それ以外のときにも送出されることがあります。例えば、ユーザーがアプリケーションに関連付けられたファイルをアクティブ化すると、実行中のアプリケーションは追加の InvokeEvent を受け取ります。

特定のアプリケーションの単一のインスタンスのみを起動できます。その後で同じアプリケーションをさらに起動しようとすると、実行中のインスタンスの NativeApplication オブジェクトによって新しい invoke イベントが送出されます。このイベントを処理して適切なアクション (たとえば、新しいアプリケーションウィンドウを開いてファイルのデータを表示するなど) を実行するのはアプリケーションの役割です。

InvokeEvent オブジェクトは、NativeApplication オブジェクト (NativeApplication.nativeApplication) によって送出されます。invoke イベントを受け取るには、NativeApplication オブジェクトの addEventListener() メソッドを呼び出します。invoke イベントのイベントリスナーを登録すると、そのイベントリスナーは、登録の前に発生した invoke イベントもすべて受け取ります。これらの以前のイベントは、addEventListener() の呼び出しが戻った後に送出されますが、必ずしも登録後に送出される新しい invoke イベントよりも前に送出されるわけではありません。したがって、送出の順序に依存しないでください。

関連項目

flash.events.BrowserInvokeEvent
flash.desktop.NativeApplication


パブリックプロパティ
 プロパティ定義元
  AIR-only arguments : Array
[読み取り専用] この呼び出し中に渡されるストリング引数の配列です。
InvokeEvent
 Inheritedbubbles : Boolean
[読み取り専用] イベントがバブリングイベントかどうかを示します。
Event
 Inheritedcancelable : Boolean
[読み取り専用] イベントに関連付けられた動作を回避できるかどうかを示します。
Event
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  AIR-only currentDirectory : File
[読み取り専用] arguments 配列内の相対パスの解決に使用されるディレクトリです。
InvokeEvent
 InheritedcurrentTarget : Object
[読み取り専用] イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
Event
 InheritedeventPhase : uint
[読み取り専用] イベントフローの現在の段階です。
Event
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  AIR-only reason : String
[読み取り専用] この InvokeEvent の理由です。
InvokeEvent
 Inheritedtarget : Object
[読み取り専用] イベントターゲットです。
Event
 Inheritedtype : String
[読み取り専用] イベントのタイプです。
Event
パブリックメソッド
 メソッド定義元
  
AIR-only InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")
InvokeEvent クラスのコンストラクタ関数です。
InvokeEvent
  
[override] このイベントの新しいコピーを作成します。
InvokeEvent
 Inherited
formatToString(className:String, ... arguments):String
カスタム ActionScript 3.0 Event クラスに toString() メソッドを実装するためのユーティリティ関数です。
Event
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
イベントで preventDefault() メソッドが呼び出されたかどうかを確認します。
Event
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
イベントのデフォルト動作をキャンセルできる場合に、その動作をキャンセルします。
Event
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
イベントフローの現在のノードおよび後続するノードで、イベントリスナーが処理されないようにします。
Event
 Inherited
イベントフローの現在のノードに後続するノードで、イベントリスナーが処理されないようにします。
Event
 Inherited
Event オブジェクトのすべてのプロパティを含むストリングを返します。
Event
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
パブリック定数
 定数定義元
 InheritedACTIVATE : String = "activate"
[静的] ACTIVATE 定数は、type プロパティ(activate イベントオブジェクト)の値を定義します。
Event
 InheritedADDED : String = "added"
[静的] Event.ADDED 定数は、added イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[静的] Event.ADDED_TO_STAGE 定数は、type プロパティ (addedToStage イベントオブジェクト) の値を定義します。
Event
 InheritedCANCEL : String = "cancel"
[静的] Event.CANCEL 定数は、cancel イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCHANGE : String = "change"
[静的] Event.CHANGE 定数は、type プロパティ (change イベントオブジェクト) の値を定義します。
Event
 InheritedCLEAR : String = "clear"
[静的] Event.CLEAR 定数は、clear イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCLOSE : String = "close"
[静的] Event.CLOSE 定数は、close イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedAIR-only CLOSING : String = "closing"
[静的] Event.CLOSING 定数は、closing イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCOMPLETE : String = "complete"
[静的] Event.COMPLETE 定数は、complete イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCONNECT : String = "connect"
[静的] Event.CONNECT 定数は、connect イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCOPY : String = "copy"
[静的] copy イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedCUT : String = "cut"
[静的] cut イベントオブジェクトの type プロパティ値を定義します。
Event
 InheritedDEACTIVATE : String = "deactivate"
[静的] Event.DEACTIVATE 定数は、deactivate イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedDISPLAYING : String = "displaying"
[静的] Event.DISPLAYING 定数は、displaying イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedENTER_FRAME : String = "enterFrame"
[静的] Event.ENTER_FRAME 定数は、enterFrame イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedEXIT_FRAME : String = "exitFrame"
[静的] Event.EXIT_FRAME 定数は、exitFrame イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedAIR-only EXITING : String = "exiting"
[静的] Event.EXITING 定数は、type プロパティ (exiting イベントオブジェクト) の値を定義します。
Event
 InheritedFRAME_CONSTRUCTED : String = "frameConstructed"
[静的] Event.FRAME_CONSTRUCTED 定数は、frameConstructed イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedFULLSCREEN : String = "fullScreen"
[静的] Event.FULL_SCREEN 定数は、fullScreen イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedAIR-only HTML_BOUNDS_CHANGE : String = "htmlBoundsChange"
[静的] Event.HTML_BOUNDS_CHANGE 定数は、htmlBoundsChange イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedAIR-only HTML_DOM_INITIALIZE : String = "htmlDOMInitialize"
[静的] Event.HTML_DOM_INITIALIZE 定数は、htmlDOMInitialize イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedAIR-only HTML_RENDER : String = "htmlRender"
[静的] Event.HTML_RENDER 定数は、htmlRender イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedID3 : String = "id3"
[静的] Event.ID3 定数は、id3 イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedINIT : String = "init"
[静的] Event.INIT 定数は、init イベントオブジェクトの type プロパティの値を定義します。
Event
  AIR-only INVOKE : String = "invoke"
[静的] InvokeEvent.INVOKE 定数は、InvokeEvent オブジェクトの type プロパティの値を定義します。
InvokeEvent
 InheritedAIR-only LOCATION_CHANGE : String = "locationChange"
[静的] Event.LOCATION_CHANGE 定数は、locationChange イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[静的] Event.MOUSE_LEAVE 定数は、mouseLeave イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedAIR-only NETWORK_CHANGE : String = "networkChange"
[静的] Event.NETWORK_CHANGE 定数は、networkChange イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedOPEN : String = "open"
[静的] Event.OPEN 定数は、open イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedPASTE : String = "paste"
[静的] Event.PASTE 定数は、paste イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedREMOVED : String = "removed"
[静的] Event.REMOVED 定数は、removed イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[静的] Event.REMOVED_FROM_STAGE 定数は、removedFromStage イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedRENDER : String = "render"
[静的] Event.RENDER 定数は、render イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedRESIZE : String = "resize"
[静的] Event.RESIZE 定数は、resize イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedSCROLL : String = "scroll"
[静的] Event.SCROLL 定数は、scroll イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedSELECT : String = "select"
[静的] Event.SELECT 定数は、select イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedSELECT_ALL : String = "selectAll"
[静的] Event.SELECT_ALL 定数は、selectAll イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[静的] Event.SOUND_COMPLETE 定数は、soundComplete イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[静的] Event.TAB_CHILDREN_CHANGE 定数は、tabChildrenChange イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[静的] Event.TAB_ENABLED_CHANGE 定数は、tabEnabledChange イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[静的] Event.TAB_INDEX_CHANGE 定数は、tabIndexChange イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedUNLOAD : String = "unload"
[静的] Event.UNLOAD 定数は、unload イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedAIR-only USER_IDLE : String = "userIdle"
[静的] Event.USER_IDLE 定数は、userIdle イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedAIR-only USER_PRESENT : String = "userPresent"
[静的] Event.USER_PRESENT 定数は、userPresent イベントオブジェクトの type プロパティの値を定義します。
Event
プロパティの詳細
AIR-only argumentsプロパティ
arguments:Array  [読み取り専用]

ランタイムバージョン: AIR 1.0

この呼び出し中に渡されるストリング引数の配列です。これがコマンドラインからの呼び出しの場合、この配列は、プロセス名を除くコマンドライン引数になります。

メモ : Mac® OS X で複数のファイルを選択して開くと、AIR によって単一の invoke イベント (選択したすべてのファイルの名前を arguments 配列に含む) が送出されます。ただし Windows® および Linux では、AIR は別々の invoke イベントを送出します(arguments 配列にあるファイル名のみを含んだ選択済みのファイルごとに送出します)。



実装
    public function get arguments():Array
AIR-only currentDirectoryプロパティ 
currentDirectory:File  [読み取り専用]

ランタイムバージョン: AIR 1.0

arguments 配列内の相対パスの解決に使用されるディレクトリです。

このプロパティは、アプリケーションがコマンドラインから起動された場合には通常、アプリケーションが起動されたコマンドラインシェルの現在の作業ディレクトリに設定されます。アプリケーションが GUI シェルから起動された場合には通常、ファイルシステムのルートに設定されます。



実装
    public function get currentDirectory():File
AIR-only reasonプロパティ 
reason:String  [読み取り専用]

ランタイムバージョン: AIR 1.5.1

この InvokeEvent の理由です。このプロパティは、アプリケーションがユーザーの手動によって起動されたか、ログイン時に自動的に起動されたかを示します。使用される値は、InvokeEventReason クラス内に列挙されている次の定数です。

InvokeEventReason 定数説明
LOGINログイン時に自動的に起動されたことを示します。
STANDARDその他の理由により起動されたことを示します。



実装
    public function get reason():String

関連項目

コンストラクタの詳細
AIR-only 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:StringEvent.type としてアクセス可能なイベントタイプです。
 
bubbles:Boolean (default = false) — InvokeEvent オブジェクトでは false に設定します。
 
cancelable:Boolean (default = false) — InvokeEvent オブジェクトでは false に設定します。
 
dir:File (default = null)arguments 配列内の相対パスの解決に使用されるディレクトリです。
 
argv:Array (default = null) — アプリケーションに渡す引数 (ストリング) の配列です。
 
reason:String (default = "standard") — イベントの原因です。値は InvokeEventReason.LOGINInvokeEventReason.STANDARD のいずれかです。(このパラメータは AIR バージョン 1.5.1 から使用できます)。

関連項目

メソッドの詳細
AIR-only clone()メソッド
override public function clone():Event

ランタイムバージョン: AIR 1.0

このイベントの新しいコピーを作成します。

戻り値
Event — イベントのコピーです。
定数の詳細
AIR-only INVOKE定数
public static const INVOKE:String = "invoke"

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0

InvokeEvent.INVOKE 定数は、InvokeEvent オブジェクトの type プロパティの値を定義します。

InvokeEvent オブジェクトには、次のプロパティがあります。

プロパティ
argumentsこの呼び出し中に渡されるストリング引数の配列です。
currentDirectoryarguments 配列内の相対パスの解決に使用されるディレクトリを表す File オブジェクトです。
reasoninvoke イベントの送出された原因が、ログイン時にアプリケーションが自動的に起動したことである(InvokeEventReason.LOGIN)か、またはその他の理由である(InvokeEventReason.STANDARD)かを示すコードです。AIR バージョン 1.5.1 から使用できます。
bubblesfalse.
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
currentTargetイベントリスナーで InvokeEvent オブジェクトをアクティブに処理しているオブジェクトを示します。
target常に NativeApplication object オブジェクトです。

関連項目





 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/flash/events/InvokeEvent.html