| 套件 | flash.events |
| 類別 | public class InvokeEvent |
| 繼承 | InvokeEvent  Event Object |
| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0 |
invoke 事件。
當應用程式啟動時，NativeApplication 物件一定會傳送 invoke 事件，但此事件也可能會在其它時候傳送。例如，當使用者啟動與執行中應用程式相關聯的檔案時，此應用程式將傳送額外的 InvokeEvent。
對於特定應用程式，您只能啟動單一實體。後續嘗試啟動該應用程式時，將會導致執行中實體的 NativeApplication 物件傳送新的 invoke 事件。應用程式必須負責處理此事件並採取適當的動作，例如開啟新的應用程式視窗以顯示檔案中的資料。
InvokeEvent 物件是由 NativeApplication 物件 (NativeApplication.nativeApplication) 傳送。若要接收 invoke 事件，請呼叫 NativeApplication 物件的 addEventListener() 方法。為 invoke 事件註冊事件偵聽程式時，此偵聽程式也將接收註冊前發生的所有 invoke 事件。雖然這些先前發生的事件會在 addEventListener() 的呼叫傳回之後傳送，但是不一定會在註冊之後可能傳送的新 invoke 事件之前傳送。因此，您不應該仰賴傳送順序。
相關 API 元素
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
| arguments : Array [唯讀]
在此叫用期間傳遞的字串引數陣列。 | InvokeEvent | ||
 | bubbles : Boolean [唯讀]
指出事件是否為反昇事件。 | Event | |
| cancelable : Boolean [唯讀]
指出是否可避免與事件相關聯的行為指令。 | Event | |
| constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| currentDirectory : File [唯讀]
應該用來解析 arguments 陣列中任何相對路徑的目錄。 | InvokeEvent | ||
| currentTarget : Object [唯讀]
正主動使用事件偵聽程式處理 Event 物件的物件。 | Event | |
| eventPhase : uint [唯讀]
事件流程中的目前階段。 | Event | |
| 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 | ||
[覆寫]
建立此事件的新副本。 | InvokeEvent | ||
|
公用程式函數，可用來實作自訂 ActionScript 3.0 Event 類別中的 toString() 方法。 | Event | |
|
指出物件是否有已定義的指定屬性。 | Object | |
|
檢查是否已經對事件呼叫 preventDefault() 方法。 | Event | |
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
|
如果可以取消事件的預設行為指令，則取消該行為指令。 | Event | |
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
|
為迴圈作業設定動態屬性的可用性。 | Object | |
|
避免處理事件流程中，目前節點以及任何後續節點中的任何事件偵聽程式。 | Event | |
|
避免處理接續在事件流程中的目前節點之後，後續節點中的任何事件偵聽程式。 | Event | |
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
傳回包含 Event 物件所有屬性的字串。 | Event | |
|
會傳回指定之物件的基本值。 | Object | |
| 常數 | 定義自 | ||
|---|---|---|---|
| INVOKE : String = "invoke" [靜態]
InvokeEvent.INVOKE 常數會定義 InvokeEvent 物件的 type 屬性值。 | InvokeEvent | ||
arguments | 屬性 |
arguments:Array [唯讀] | 執行階段版本: | AIR 1.0 |
在此叫用期間傳遞的字串引數陣列。如果這是命令列叫用，則此陣列就會包含命令列引數 (「不含」程序名稱)。
在行動平台上，這個屬性包含用來啟動應用程式之選項的陣列，而非命令列引數。此外，在行動平台上，當 reason 為 InvokeEventReason.OPEN_URL 時，引數 Array 的內容會有所不同，如下所示：
- 另一個應用程式或瀏覽器會叫用具有自訂 URL 的應用程式 (iOS 和 Android)：
引數 iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]source app id action id InvokeEvent.arguments[2]null NA - 系統會叫用應用程式以開啟關聯的檔案類型 (iOS 和 Android)：
引數 iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]null action id InvokeEvent.arguments[2]null NA - 另一個應用程式會叫用使用文件整合控制器的應用程式 (僅限 iOS)：
引數 iOS InvokeEvent.arguments.length3 InvokeEvent.arguments[0]url InvokeEvent.arguments[1]source app id InvokeEvent.arguments[2]annotation
注意：在 Mac® OS X 中選取並開啟多個檔案時，AIR 將傳送單一 invoke 事件，此事件會將所有選取檔案的名稱都包含在 arguments 陣列中。但是在 Windows® 和 Linux 中，AIR 將為每個選取的檔案傳送個別的 invoke 事件，此事件只將該檔案名稱包含在 arguments 陣列中。
實作
public function get arguments():Array currentDirectory | 屬性 |
reason | 屬性 |
reason:String [唯讀] | 執行階段版本: | AIR 1.5.1 |
InvokeEvent 的原因。此屬性指出應用程式為使用者手動啟動或登入時自動啟動。可能的值在 InvokeEventReason 類別中列舉為常數：
| InvokeEventReason 常數 | 意義 |
|---|---|
LOGIN | 登入時自動啟動。 |
NOTIFICATION | 啟動以回應通知 (僅限 iOS)。 |
OPEN_URL | 因為另一個應用程式叫用應用程式而啟動。 |
STANDARD | 因任何其他原因啟動。 |
注意：在行動平台上，reason 屬性永遠不會設定為 LOGIN。
實作
public function get reason():String相關 API 元素
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)false。
| |
cancelable:Boolean (default = false)false。
| |
dir:File (default = null)arguments 陣列中任何相對路徑的目錄。
| |
argv:Array (default = null) | |
reason:String (default = "standard")InvokeEventReason.LOGIN、InvokeEventReason.STANDARD、InvokeEventReason.OPEN_URL 或 InvokeEventReason.NOTIFICATION (這個參數可於 AIR 1.5.1 版以上使用。OPEN_URL 和 NOTIFICATION 可於 AIR 3.5 版以上使用)。
|
相關 API 元素
clone | () | 方法 |
INVOKE | 常數 |
public static const INVOKE:String = "invoke"| 語言版本: | ActionScript 3.0 |
| 執行階段版本: | AIR 1.0 |
InvokeEvent.INVOKE 常數會定義 InvokeEvent 物件的 type 屬性值。
InvokeEvent 物件具有下列屬性：
| 屬性 | 值 |
|---|---|
引數 | 在此叫用期間傳遞的字串引數陣列。 |
currentDirectory | 代表應該用來解析 arguments 陣列中任何相對路徑的目錄之 File 物件。 |
reason | 指出 invoke 事件因為應用程式在登入時自動啟動 (InvokeEventReason.LOGIN)、啟動做為遠端通知的回應 (InvokeEventReason.NOTIFICATION - 僅限 iOS)、其他應用程式叫用應用程式 (InvokeEventReason.OPEN_URL)，或是另一個原因 (InvokeEventReason.STANDARD) 而傳送的代碼。AIR 1.5.1 版以上可使用。 |
bubbles | false。 |
cancelable | false；沒有要取消的預設行為指令。 |
currentTarget | 表示以事件偵聽程式主動處理此 InvokeEvent 物件的物件。 |
target | 永遠是 NativeApplication 物件。 |
相關 API 元素
Tue Jun 12 2018, 03:47 PM Z