BrowserInvokeEvent

套件	flash.events
類別	public class BrowserInvokeEvent
繼承	BrowserInvokeEvent Event Object

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0

AIR 應用程式的 NativeApplication 物件會在瀏覽器的 SWF 檔使用瀏覽器叫用功能，而導致叫用應用程式時傳送 browserInvoke 事件。當使用者將瀏覽器中的隱藏安裝功能實體化，而且瀏覽器中的 SWF 檔將陣列傳送至 air.swf 檔之 launchApplication() 方法的 arguments 參數時，NativeApplication 物件也會傳送 browserInvoke 事件 (如需詳細資訊，請參閱「AIR 程式開發人員指南」中的「散佈、安裝和執行 AIR 應用程式」)。

只有當應用程式在應用程式描述器檔案中指定下列項目時，才允許使用瀏覽器叫用功能：

<allowBrowserInvocation>true</allowBrowserInvocation>

如果應用程式不在執行中，從瀏覽器啟動時 NativeApplication 物件便會傳送 InvokeEvent 事件和 browserInvoke 事件。否則，如果應用程式「正在」執行中，從瀏覽器啟動時 NativeApplication 物件便只會傳送 browserInvoke 事件。

如果應用程式是因為從瀏覽器以隱藏安裝的方式啟動 (因為使用者選擇在安裝時啟動)，那麼只有在已傳遞引數的情況下 (透過瀏覽器中的 SWF 檔將陣列傳送至 air.swf 檔之 installApplication() 方法的 arguments 參數)，NativeApplication 物件才會傳送 BrowserInvoke 事件。如需詳細資訊，請參閱「AIR 程式開發人員指南」中的「散佈、安裝和執行 AIR 應用程式」。

與 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 [唯讀] 瀏覽器中的內容使用 (true) 或不使用 (false) HTTPS URL 配置。	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

瀏覽器中的內容使用 (true) 或不使用 (false) HTTPS URL 配置。

實作
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 — 內容在「本機與檔案系統」安全執行程序中。
Security.LOCAL_WITH_NETWORK — 內容在「具有網路連線的本機」安全執行程序中。
Security.REMOTE — 內容位於遠端 (網路) 網域。

實作
public function get sandboxType():String

相關 API 元素

flash.system.Security.sandboxType

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 物件具有下列屬性：

屬性	值
`引數`	在此叫用期間傳遞的字串引數陣列。
`sandBoxType`	字串，代表瀏覽器中內容的安全執行程序類型 (`Security.APPLICATION`、`Security.LOCAL_TRUSTED`、`Security.LOCAL_WITH_FILE`、`Security.LOCAL_LOCAL_WITH_NETWORK` 或 `Security.REMOTE`)。
`securityDomain`	字串，代表瀏覽器中內容的安全性網域 (例如 `"www.example.com"`)。
`isHTTPS`	瀏覽器內容使用 (`true`) 或不使用 (`false`) HTTPS URL 配置
`isUserEvent`	不管是否因為使用者事件而導致叫用了瀏覽器 (在 AIR 1.0 中一定是 `true`)。
`bubbles`	否。
`cancelable`	`false`；沒有要取消的預設行為指令。
`currentTarget`	表示以事件偵聽程式主動處理此 InvokeEvent 物件的物件。
`target`	永遠是 NativeApplication 物件。

相關 API 元素

flash.desktop.NativeApplication

法律聲明 | 線上隱私權政策

BrowserInvokeEvent - AS3

類別 x

arguments

isHTTPS

isUserEvent

sandboxType

securityDomain