| 套件 | flash.events |
| 類別 | public class BrowserInvokeEvent |
| 繼承 | BrowserInvokeEvent  Event Object |
| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0 |
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 事件。
相關 API 元素
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
| 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 | ||
[覆寫]
建立此事件的新副本。 | BrowserInvokeEvent | ||
|
公用程式函數，可用來實作自訂 ActionScript 3.0 Event 類別中的 toString() 方法。 | Event | |
|
指出物件是否有已定義的指定屬性。 | Object | |
|
檢查是否已經對事件呼叫 preventDefault() 方法。 | Event | |
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
|
如果可以取消事件的預設行為指令，則取消該行為指令。 | Event | |
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
|
為迴圈作業設定動態屬性的可用性。 | Object | |
|
避免處理事件流程中，目前節點以及任何後續節點中的任何事件偵聽程式。 | Event | |
|
避免處理接續在事件流程中的目前節點之後，後續節點中的任何事件偵聽程式。 | Event | |
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
傳回包含 Event 物件所有屬性的字串。 | Event | |
|
會傳回指定之物件的基本值。 | Object | |
| 常數 | 定義自 | ||
|---|---|---|---|
| BROWSER_INVOKE : String = "browserInvoke" [靜態]
BrowserInvokeEvent.BROWSER_INVOKE 常數會定義 BrowserInvokeEvent 物件的 type 屬性值。 | BrowserInvokeEvent | ||
arguments | 屬性 |
isHTTPS | 屬性 |
isUserEvent | 屬性 |
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 元素
securityDomain | 屬性 |
BrowserInvokeEvent | () | 建構函式 |
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 | () | 方法 |
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 元素
Tue Jun 12 2018, 03:47 PM Z