BrowserInvokeEvent

パッケージ	flash.events
クラス	public class BrowserInvokeEvent
継承	BrowserInvokeEvent Event Object

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

AIR アプリケーションの NativeApplication オブジェクトは、ブラウザー内の SWF ファイルがブラウザー呼び出し機能を使用した結果としてアプリケーションが呼び出されたときに browserInvoke イベントを送出します。NativeApplication オブジェクトによる browserInvoke イベントの送出は、ユーザーがブラウザー内でシームレスインストール機能をインスタンス化し、ブラウザー内の SWF ファイルが arguments パラメーター（air.swf ファイルの launchApplication() メソッドのパラメーター）に配列を渡したときにも発生します（詳しくは、AIR 開発者ガイドの「AIR アプリケーションの配布、インストール、実行」を参照してください）。

ブラウザー呼び出しが許可されるのは、アプリケーション記述ファイルで次のように指定されている場合のみです。

<allowBrowserInvocation>true</allowBrowserInvocation>

アプリケーションが実行されていない場合、NativeApplication オブジェクトは、ブラウザーから起動されたときに InvokeEvent イベントと browserInvoke イベントの両方を送出します。それ以外の場合、アプリケーションが既に実行されていれば、NativeApplication オブジェクトは、ブラウザーから起動されたときに browserInvoke イベントのみを送出します。

アプリケーションが（ユーザーがインストール時に起動することを選択したことにより）ブラウザーからのシームレスインストールの結果として起動された場合、NativeApplication オブジェクトは、（ブラウザー内の SWF ファイルが arguments パラメーター（air.swf ファイルの installApplication() メソッドのパラメーター）に配列を渡すことによって）引数が渡された場合に限り、BrowserInvoke イベントを送出します詳細については、AIR 開発者ガイドの「Distributing, Installing and Running AIR applications」を参照してください。

invokeEvent イベントと同様に、browserInvokeEvent オブジェクトも NativeApplication オブジェクト（NativeApplication.nativeApplication）によって送出されます。browserInvoke イベントを受け取るには、NativeApplication オブジェクトの addEventListener() メソッドを呼び出します。browserInvoke イベントのイベントリスナーを登録すると、そのイベントリスナーは、登録の前に発生した browserInvoke イベントもすべて受け取ります。これらは addEventListener() の呼び出しが戻った後に送出されますが、必ずしも、登録後に受け取る可能性がある他の browserInvoke イベントより先に送出されるとは限りません。これにより、初期化コードを実行する前（アプリケーションが最初にブラウザーから起動されたときなど）に発生した browserInvoke イベントも処理できます。実行中の後の段階（アプリケーションの初期化後）にイベントリスナーを追加した場合でも、アプリケーション起動時以降に発生したすべての browserInvoke イベントが受信される点に注意してください。

パブリックプロパティ

継承されるパブリックプロパティを隠す

継承されるパブリックプロパティを表示

	プロパティ		定義元
		arguments : Array [読み取り専用] アプリケーションに渡す引数（ストリング）の配列です。	BrowserInvokeEvent
		bubbles : Boolean [読み取り専用] イベントがバブリングイベントかどうかを示します。	Event
		cancelable : Boolean [読み取り専用] イベントに関連付けられた動作を回避できるかどうかを示します。	Event
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。	Object
		currentTarget : Object [読み取り専用] イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。	Event
		eventPhase : uint [読み取り専用] イベントフローの現在の段階です。	Event
		isHTTPS : Boolean [読み取り専用] ブラウザー内のコンテンツが HTTPS URL スキームを使用する（true）か、使用しない（false）かを示します。	BrowserInvokeEvent
		isUserEvent : Boolean [読み取り専用] ブラウザー呼び出しがユーザーイベント（マウスのクリックなど）の結果として起こったかどうかを示します。	BrowserInvokeEvent
		sandboxType : String [読み取り専用] ブラウザー内のコンテンツのサンドボックスタイプです。	BrowserInvokeEvent
		securityDomain : String [読み取り専用] ブラウザー内のコンテンツのセキュリティドメイン（"www.adobe.com" や "www.example.org" など）です。	BrowserInvokeEvent
		target : Object [読み取り専用] イベントターゲットです。	Event
		type : String [読み取り専用] イベントのタイプです。	Event

パブリックメソッド

継承されるパブリックメソッドを隠す

継承されるパブリックメソッドを表示

	メソッド		定義元
		BrowserInvokeEvent(type:String, bubbles:Boolean, cancelable:Boolean, arguments:Array, sandboxType:String, securityDomain:String, isHTTPS:Boolean, isUserEvent:Boolean) BrowserInvokeEvent クラスのコンストラクター関数です。	BrowserInvokeEvent
		clone():Event [オーバーライド] このイベントの新しいコピーを作成します。	BrowserInvokeEvent
		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
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String Event オブジェクトのすべてのプロパティを含むストリングを返します。	Event
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object

パブリック定数

継承されるパブリック定数を隠す

継承されるパブリック定数を表示

	定数		定義元
		BROWSER_INVOKE : String = "browserInvoke" [静的] BrowserInvokeEvent.BROWSER_INVOKE 定数は、BrowserInvokeEvent オブジェクトの type プロパティの値を定義します。	BrowserInvokeEvent

プロパティの詳細

arguments

プロパティ

arguments:Array [読み取り専用]

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

アプリケーションに渡す引数（ストリング）の配列です。

実装
public function get arguments():Array

isHTTPS

プロパティ

isHTTPS:Boolean [読み取り専用]

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

ブラウザー内のコンテンツが HTTPS URL スキームを使用する（true）か、使用しない（false）かを示します。

実装
public function get isHTTPS():Boolean

isUserEvent

プロパティ

isUserEvent:Boolean [読み取り専用]

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

ブラウザー呼び出しがユーザーイベント（マウスのクリックなど）の結果として起こったかどうかを示します。AIR 1.0 では、これは常に true に設定されます。AIR では、ブラウザー呼び出し機能を呼び出すために常にユーザーイベントが必要となります。

実装
public function get isUserEvent():Boolean

sandboxType

プロパティ

sandboxType:String [読み取り専用]

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

ブラウザー内のコンテンツのサンドボックスタイプです。これは次のいずれかの値に設定できます。

Security.APPLICATION — コンテンツはアプリケーションセキュリティサンドボックス内にあります。
Security.LOCAL_TRUSTED — コンテンツは、信頼できるローカルのセキュリティサンドボックス内にあります。
Security.LOCAL_WITH_FILE — コンテンツは local-with-filesystem セキュリティサンドボックス内にあります。
Security.LOCAL_WITH_NETWORK — コンテンツは local-with-networking セキュリティサンドボックス内にあります。
Security.REMOTE — コンテンツはリモート（ネットワーク）ドメイン内にあります。

実装
public function get sandboxType():String

securityDomain

プロパティ

securityDomain:String [読み取り専用]

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

ブラウザー内のコンテンツのセキュリティドメイン（"www.adobe.com" や "www.example.org" など）です。このプロパティはリモートセキュリティサンドボックス内のコンテンツ（ネットワークドメイン内のコンテンツ）に対してのみ設定されます。ローカルまたはアプリケーションセキュリティサンドボックス内のコンテンツには設定されません。

実装
public function get securityDomain():String

コンストラクターの詳細

()

コンストラクター

public function BrowserInvokeEvent(type:String, bubbles:Boolean, cancelable:Boolean, arguments:Array, sandboxType:String, securityDomain:String, isHTTPS:Boolean, isUserEvent:Boolean)

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

BrowserInvokeEvent クラスのコンストラクター関数です。通常、開発者が BrowserInvokeEvent() コンストラクターを直接呼び出すことはありません。BrowserInvokeEvent オブジェクトはランタイムによってのみ作成されます。

パラメーター

	`type:String` — `Event.type` としてアクセス可能なイベントタイプです。

	`bubbles:Boolean` — BrowserInvokeEvent オブジェクトでは `false` に設定します。

	`cancelable:Boolean` — BrowserInvokeEvent オブジェクトでは `false` に設定します。

	`arguments:Array` — アプリケーションに渡す引数（ストリング）の配列です。

	`sandboxType:String` — ブラウザー内のコンテンツのサンドボックスタイプです。

	`securityDomain:String` — ブラウザー内のコンテンツのセキュリティドメインです。

	`isHTTPS:Boolean` — ブラウザー内のコンテンツが HTTPS URL スキームを使用するかどうかを示します。

	`isUserEvent:Boolean` — ブラウザー呼び出しがユーザーイベントの結果として起こったかどうかを示します。

メソッドの詳細

clone

()

メソッド

override public function clone():Event

ランタイムバージョン:

AIR 1.0

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

戻り値

Event — イベントのコピーです。

定数の詳細

BROWSER_INVOKE

定数

public static const BROWSER_INVOKE:String = "browserInvoke"

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0

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

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

プロパティ	値
`arguments`	この呼び出し中に渡されるストリング引数の配列です。
`sandBoxType`	ブラウザーのコンテンツのサンドボックスタイプを表すストリング（`Security.APPLICATION`、`Security.LOCAL_TRUSTED`、`Security.LOCAL_WITH_FILE`、`Security.LOCAL_LOCAL_WITH_NETWORK`、`Security.REMOTE` のいずれか）。
`securityDomain`	ブラウザー内のコンテンツのセキュリティドメインを表すストリング（`"www.example.com"` など）です。
`isHTTPS`	ブラウザーコンテンツが HTTPS URL スキームを使用する（`true`）か、使用しない（`false`）かを示します。
`isUserEvent`	ブラウザー呼び出しがユーザーイベントの結果として起こったかどうかを示します（AIR 1.0 では常に `true` になります）。
`bubbles`	なし。
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`currentTarget`	イベントリスナーで InvokeEvent オブジェクトをアクティブに処理しているオブジェクトを示します。
`target`	常に NativeApplication object オブジェクトです。

BrowserInvokeEvent - AS3

パッケージx

言語エレメント

付録

パッケージ flash.events

arguments

isHTTPS

isUserEvent

sandboxType

securityDomain