NativeApplication  - AS3

作用中的應用程式視窗。

如果作用中的桌面視窗不屬於此應用程式，或者沒有任何作用中視窗，activeWindow 就會是 null。

在不支援 NativeWindow 類別的平台上，不支援此屬性。

此 AIR 應用程式的應用程式描述器檔案內容。

var appDescriptor:XML = NativeApplication.nativeApplication.applicationDescriptor;
var ns:Namespace = appDescriptor.namespace();
var appCopyright:String = appDescriptor.ns::copyright;
var appVersion:String = appDescriptor.ns::version;
trace("appId:", appCopyright);
trace("version:", appVersion);

此應用程式的應用程式 ID。

此 ID 的值是在應用程式描述器檔案中設定。

指定應用程式是否應該在所有視窗都關閉時自動終止。

當 autoExit 為 true (預設值) 時，應用程式會在所有視窗關閉時終止，也會傳送 exiting 和 exit 事件。如果 autoExit 為 false，則必須呼叫 NativeApplication.nativeApplication.exit() 來終止應用程式。

在不支援 NativeWindow 類別的平台上，不支援此屬性。

指定應用程式是否將在背景執行。

若 executeInBackground 為預設值 false，則應用程式在移至背景時會維持暫停狀態。當 executeInBackground 為 true 時，應用程式會在背景執行。

注意：在 SWF 版本 21 及舊版中，當設定「直接」顯示模式時，AIR 並未支援背景執行。由於這個限制，Stage3D 應用程式無法執行背景工作，例如音效播放、位置更新、網路上傳或下載等。iOS 不允許在背景執行 OpenGLES 或顯示呼叫。嘗試在背景進行 OpenGL 呼叫的應用程式會遭到 iOS 加以終止。Android 並未限制應用程式在背景進行 OpenGLES 呼叫或是執行其他背景工作 (如音效播放)。透過 SWF 版本 22 及更新版本，AIR 行動裝置應用程式可以在已設定 renderMode direct 的情況下在背景執行。如果在背景進行 OpenGLES 呼叫，AIR iOS 執行階段會造成 ActionScript 錯誤 (3768 - 在背景執行期間不會使用 Stage3D API)。不過，在 Android 則不會造成任何錯誤，因為 Android 原生應用程式是可以在背景進行 OpenGLES 呼叫的。為了讓行動裝置資源的運用達到最佳化，當應用程式在背景執行時，請不要進行顯示呼叫。

這個屬性在 AIR iOS 和 Android 受到支援。

應用程式圖示。

您可以使用 NativeApplication.supportsDockIcon 和 NativeApplication.supportsSystemTrayIcon 判斷 icon 類別。此類型將為 InteractiveIcon 的其中一個子類別。在 Mac^® OS X 上，NativeApplication.icon 為 DockIcon 類型的物件。在 Windows^® 上，NativeApplication.icon 為 SystemTrayIcon 類型的物件。當不支援某個應用程式圖示時，NativeApplication.supportsDockIcon 和 NativeApplication.supportsSystemTrayIcon 都為 false，且 icon 屬性為 null。

icon 物件是自動建立的，但是不會使用影像資料初始化。在某些作業系統 (例如 Mac OS X) 上，將會提供預設影像。但是在其他作業系統 (如 Windows) 上，除非已為圖示指定影像資料，否則不會顯示圖示。若要指定圖示影像，請使用陣列來設定 icon.bitmaps 屬性，此陣列至少要包含一個 BitmapData 物件。如果此陣列包含一個以上的 BitmapData 物件，則作業系統會選擇在大小上最接近圖示顯示尺寸的影像，並在必要時縮放影像。

相關 API 元素

在傳送 userIdle 事件之前，必須經過多久的時間沒有使用者輸入。

依照預設，閒置臨界值為 300 秒 (5 分鐘)。值的可接受範圍是從 5 (5 秒) 到 86,400 (1 天) (含)。

相關 API 元素

指定是否針對所要的平台編譯或解譯應用程式。這個 API 只針對 iOS 目標 (ipa-app-store、ipa-test、ipa-debug、ipa-ad-hoc) 傳回 (true)。對於其他 AIR 平台，這個 API 則會傳回 (false)。

應用程式選單。

當 NativeApplication.supportsMenu 為 true 時，即支援應用程式選單。並非所有作業系統都支援應用程式選單。例如，Mac OS X 支援應用程式選單，但是 Windows 或 Linux 則不支援。當 NativeApplication.supportsMenu 為 false 時，您可以將 NativeMenu 物件指派給此屬性，但是不會有任何作用。請務必使用 NativeApplication.supportsMenu 屬性來判斷作業系統是否支援應用程式選單。使用其他方法 (例如 Capabilities.os) 來判斷這種支援是否會造成程式設計錯誤 (如果未考慮到部分可能的目標作業系統)。

AIR 描述檔支援：行動裝置或 AIR for TV 裝置不支援此功能。如需有關跨多個描述檔之 API 支援的詳細資訊，請參閱 AIR 描述檔支援。

注意：在 Mac OS X 中，menu 屬性會參考作業系統支援的預設應用程式選單。您可以透過加入和移除項目和子選單以及加入事件偵聽程式，修改現有的選單結構。您也可以將新的 NativeMenu 物件指定給這個 menu 屬性，完全取代預設選單。

相關 API 元素

NativeApplication 物件的 Singleton 實體。

包含這個應用程式之所有開啟原生視窗的陣列。

在不支援 NativeWindow 類別的平台上，不支援此屬性。

此應用程式的發行者 ID。

這個 ID 的值會設定在應用程式的 publisherid 檔案中，這個檔案是在安裝時，由用來簽署應用程式的憑證鏈結所產生。

裝載此應用程式之執行階段的修補程式等級。

裝載此應用程式之執行階段的版本號碼。

指定此應用程式是否會在目前的使用者每次登入時自動啟動。

AIR 描述檔支援：所有桌上型電腦作業系統都支援此項功能，但行動裝置或 AIR for TV 裝置不支援。您可以使用 NativeApplication.supportsStartAtLogin 屬性測試執行階段的支援狀況。如需有關跨多個描述檔之 API 支援的詳細資訊，請參閱 AIR 描述檔支援。

startAtLogin 屬性會反映作業系統定義之機制的狀態，以指定使用者登入時，應用程式應該自動啟動。使用者可以使用作業系統的使用者介面，手動變更此狀態。不管 AIR 應用程式或作業系統最後是否變更此狀態，此屬性都會反應目前的狀態。

相關 API 元素

指示目前的平台是否支援 setAsDefaultApplication()、removeAsDefaultApplication() 以及 isSetAsDefaultApplication()。

如果為 true，則上述方法將按照所述執行。如果為 false，則 setAsDefaultApplication() 和 removeDefaultApplication() 不會執行任何動作，而且 isSetAsDefaultApplication() 會傳回 false。

相關 API 元素

指出 AIR 是否支援在目前的作業系統中使用停駐式應用程式圖示。

如果為 true，則 NativeApplication.icon 屬性的類型為 DockIcon。

Mac OS X 使用者介面為執行中或常用的應用程式提供一種內含圖示的應用程式停駐點。

請務必使用 NativeApplication.supportsDockIcon 屬性來判斷作業系統是否支援應用程式停駐圖示。使用其他方法 (例如 Capabilities.os) 來判斷這種支援是否會造成程式設計錯誤 (如果未考慮到部分可能的目標作業系統)。

相關 API 元素

指定目前的作業系統是否支援全域應用程式選單列。

設定為 true 時，NativeApplication.menu 屬性便可以用來定義 (或存取) 原生應用程式選單。

請務必使用 NativeApplication.supportsMenu 屬性來判斷作業系統是否支援應用程式選單列。使用其他方法 (例如 Capabilities.os) 來判斷這種支援是否會造成程式設計錯誤 (如果未考慮到部分可能的目標作業系統)。

相關 API 元素

指示目前的平台是否支援 startAtLogin。

如果為 true，則 startAtLogin 會按照所述執行。如果為 false，則 startAtLogin 無任何作用。

相關 API 元素

指定 AIR 是否支援在目前的作業系統中使用系統匣圖示。

如果為 true，則 NativeApplication.icon 屬性的類型為 SystemTrayIcon。

Windows 使用者介面提供工作列的「系統匣」圖示，正式名稱為「通知區域」，應用程式圖示就是顯示在這個地方。未顯示預設圖示。您必須將圖示物件的 bitmaps 陣列設定成顯示圖示。

請務必使用 NativeApplication.supportsSystemTrayIcon 屬性來判斷作業系統是否支援系統匣圖示。使用其他方法 (例如 Capabilities.os) 來判斷這種支援是否會造成程式設計錯誤 (如果未考慮到部分可能的目標作業系統)。

相關 API 元素

提供一種方法給應用程式，來禁止使用者介面進入「閒置」模式。

SystemIdleMode 類別的值，用於影響主機系統的閒置模式行為。這個屬性只對包含輸入焦點的應用程式有效，而且只能從應用程式安全執行程序中執行的內容存取。

AIR 描述檔支援：行動裝置支援此項功能，但桌上型電腦作業系統或 AIR for TV 裝置不支援。如需有關跨多個描述檔之 API 支援的詳細資訊，請參閱 AIR 描述檔支援。

相關 API 元素

上一次使用者輸入之後所經過的時間，以秒為單位。

相關 API 元素

啟動此應用程式。

在不支援 NativeWindow 類別的平台上，不支援此方法。

在作業系統判斷的某些情況下，這個方法並不會啟動應用程式。大多數的作業系統都會限制應用程式啟動自己的能力，以避免它在意外或惡意情況下讓使用者無法使用其他應用程式。

如果作業系統允許啟動，指定的視窗就會啟動，並移至桌面前景，也就是在其他應用程式視窗的前面。(如果 window 參數為 null，則會啟動這個應用程式的任何可見視窗)。

如果應用程式沒有任何可見視窗，activate() 方法就不會有任何效果。

啟動作業是同步的。

參數

會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。您可以在顯示清單上的所有節點，為特定類型的事件、階段與優先順序註冊事件偵聽程式。

當您成功註冊事件偵聽程式後，就不可以透過對 addEventListener() 的額外呼叫來變更其優先順序。 若要變更偵聽程式的優先順序，您必須先呼叫 removeListener()。 然後，您就可以使用新的優先順序等級來重新註冊偵聽程式。

請記住，一旦您註冊了偵聽程式，對 addEventListener() 進行後續呼叫，若使用不同的 type 或 useCapture 值，將會導致建立個別的偵聽程式註冊程序。 例如，如果您先將 useCapture 設為 true 來註冊偵聽程式，則只會在捕捉階段進行偵聽。 如果您使用相同的偵聽程式物件，再次呼叫 addEventListener() (但將 useCapture 設為 false) 會得到兩個不同的偵聽程式： 一個會在捕捉階段進行偵聽，另一個則會在目標與反昇階段進行偵聽。

您無法單獨針對目標階段或反昇階段註冊事件偵聽程式。 由於反昇階段只適用於目標節點的祖系，因此這兩種階段必須一起進行註冊。

如果您不再需要事件偵聽程式，可以呼叫 removeEventListener() 來移除它，否則可能產生記憶體問題。 事件偵聽程式不會自動從記憶體中移除，因為只要傳送的物件存在，垃圾回收器就不會移除偵聽程式 (除非 useWeakReference 參數設定為 true)。

複製 EventDispatcher 實體並不會將附加在該實體上的事件偵聽程式一併複製 (如果新建立的節點需要事件偵聽程式，則您必須在建立節點後再附加偵聽程式)。 然而，如果您移動了 EventDispatcher 實體，則附加的事件偵聽程式也會跟著移動。

若於此節點正在處理事件的同時將事件偵聽程式註冊到某個節點上，則事件偵聽程式不會在目前階段觸發，但會在事件流程的後續階段 (例如反昇階段) 中觸發。

如果您在節點正在處理事件的同時將事件偵聽程式從節點中移除，則事件偵聽程式還是會被目前的動作觸發。 一旦移除了事件偵聽程式，就無法再叫用它 (除非您為了日後的處理而再次註冊它)。

參數

function(evt:Event):void

在取得焦點的顯示物件上叫用內部刪除命令。

如果取得焦點的物件未實作此命令，則會忽略這個函數呼叫。目前只有 TextField 或 HTMLLoader 類別的後代顯示物件才會實作此命令。

注意：clear() 命令會刪除選取的文字。如果未選取任何內容，它不會清除所有文字。

在取得焦點的顯示物件上叫用內部複製命令。

如果組件未實作此命令，則會忽略這個函數呼叫。目前只有 TextField 或 HTMLLoader 類別的後代顯示物件才會實作此命令。

在取得焦點的顯示物件上叫用內部剪下命令。

如果組件未實作此命令，則會忽略這個函數呼叫。目前只有 TextField 或 HTMLLoader 類別的後代顯示物件才會實作此命令。

會將事件傳送到事件流程。事件目標就是呼叫 dispatchEvent() 方法時所需的 EventDispatcher 物件。

參數

終止此應用程式。

對 exit() 方法的呼叫「將會」傳回。直到目前執行中的程式碼 (例如目前的事件處理常式) 都完成之後，關機序列才會開始。待處理的非同步作業都會取消，可能會或可能不會完成。

請注意，不會傳送 exiting 事件。如果應用程式邏輯需要 exiting 事件，請呼叫 NativeApplication.nativeApplication.dispatchEvent()，傳入 exiting 類型的 Event 物件。對於任何開啟的視窗，NativeWindow 物件會傳送 closing 和 close 事件。呼叫 closing 事件物件的 preventDefault() 會防止應用程式結束。

注意：在 iOS 作業系統上，不支援此方法。

參數

取得預設應用程式，以便開啟具有指定副檔名的檔案。

注意：此方法只能搭配應用程式描述器之 fileTypes 陳述式中宣告的檔案類型來使用。

此方法不適用於 AIR for TV 裝置。若以應用程式描述器中宣告的檔案類型來呼叫，將會傳回 null。

參數

相關 API 元素

指定此應用程式目前是否為用於開啟具有指定副檔名之檔案的預設應用程式。

AIR 描述檔支援：所有桌上型電腦作業系統都支援此項功能，但行動裝置或 AIR for TV 裝置不支援。您可以使用 NativeApplication.supportsDefaultApplication 屬性測試執行階段的支援狀況。如需有關跨多個描述檔之 API 支援的詳細資訊，請參閱 AIR 描述檔支援。

參數

相關 API 元素

在取得焦點的顯示物件上叫用內部貼上命令。

如果組件未實作此命令，則會忽略這個函數呼叫。目前只有 TextField 或 HTMLLoader 類別的後代顯示物件才會實作此命令。

移除此應用程式，使其不再成為開啟具有指定副檔名之檔案的預設應用程式。

注意：此方法只能搭配應用程式描述器之 fileTypes 陳述式中列出的檔案類型來使用。

參數

相關 API 元素

會從 EventDispatcher 物件移除偵聽程式。 如果沒有相符的偵聽程式以 EventDispatcher 物件來註冊，則呼叫此方法不會產生任何作用。

參數

在取得焦點的顯示物件上叫用內部全選命令。

如果組件未實作此命令，則會忽略這個函數呼叫。目前只有 TextField 或 HTMLLoader 類別的後代顯示物件才會實作此命令。

將此應用程式設定為用於開啟具有指定副檔名之檔案的預設應用程式。

注意：此方法只能搭配應用程式描述器之 fileTypes 陳述式中宣告的檔案類型來使用。

參數

相關 API 元素

在此應用程式成為作用中的桌面應用程式時傳送。

注意：這個事件沒有「捕捉階段」也沒有「反昇階段」，這表示事件偵聽程式必須直接加入至任何可能的目標，不論目標是否在顯示清單上。

AIR for TV 裝置永遠不會自動傳送此事件。但是，您可以手動傳送。

這個事件具有下列屬性：

在使用者瀏覽器中執行的 SWF 檔案叫用應用程式時傳送。

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

<allowBrowserInvocation>true</allowBrowserInvocation>

在桌面焦點切換至不同的應用程式時傳送。

注意：這個事件沒有「捕捉階段」也沒有「反昇階段」，這表示事件偵聽程式必須直接加入至任何可能的目標，不論目標是否在顯示清單上。

AIR for TV 裝置永遠不會自動傳送此事件。但是，您可以手動傳送。

這個事件具有下列屬性：

當啟動應用程式結束序列時傳送。

當應用程式結束動作是由作業系統所起始時，就會傳送 exiting 事件，例如，當使用者在 Mac OS X 上發出 Cmd-Q 按鍵組合時，或是當 NativeApplication 物件的 autoExit 屬性為 true，且關閉最後一個應用程式視窗時。取消這個事件可避免應用程式結束。

AIR for TV 裝置永遠不會傳送 exiting 事件。

注意：呼叫 NativeApplication 的 exit() 方法並不會造成 exiting 事件的傳送。若要警告組件即將結束，請在呼叫 exit() 之前傳送 exiting 事件。

這個事件具有下列屬性：

在叫用應用程式時傳送。

第二次叫用應用程式時，並不會啟動應用程式的另一個實體。相反地，第一個實體會接收到額外的 invoke 事件。該應用程式必須負責適當地處理後續的 invoke 事件。

注意：所有的 invoke 事件都會排入佇列中。當註冊這個事件的偵聽程式時，它會在佇列中收到所有事件以及任何新的事件。佇列中的事件可能會在任何新的 invoke 事件加入之前或之後傳送。

InvokeEvent 物件具有下列屬性：

會當使用者按下按鍵時傳送。 NativeApplication 實體會提供這個事件以支援鍵盤快速鍵。這個鍵盤事件會先傳送至 NativeApplication。取消此事件也會取消 NativeWindow 選單快速鍵。此事件會在 keyUp 事件之前發生。

這個事件具有下列屬性：

相關 API 元素

會當使用者放開按鍵時傳送。 NativeApplication 實體會提供這個事件以支援鍵盤快速鍵。這個鍵盤事件會先傳送至 NativeApplication。取消此事件不會影響其他物件 (例如 NativeWindow 選單快速鍵)。這個事件會在 keyDown 事件之後發生。

這個事件具有下列屬性：

相關 API 元素

在新的網路連線可用之後或是現有的網路連線遺失時傳送。

networkChange 事件不一定表示主機電腦已連線或離線，因為它可能只是從某種連線類型轉換成另一種而已。應用程式可以使用此事件，協助將監視遠端資源可用性的工作最佳化。傳送 networkChange 事件時，通常就是確認是否有遠端資源可使用的好時機。

注意：

• 網路變更和傳送此事件之間，可能會有短暫的延遲。
• 在 Android 上，網路連線每次變更時，NativeApplication 物件可能會傳送超過一個以上的 networkChange 事件。

這個事件具有下列屬性：

當作業系統即將暫停應用程式時傳送。

這個事件具有下列屬性：

當使用者閒置時傳送。

指定使用 idleThreshold 屬性傳送此事件之前，使用者必須閒置的期間。使用者已閒置時間量可透過 timeSinceLastUserInput 屬性來判斷。

注意：行動裝置或 AIR for TV 裝置不會傳送此事件。

這個事件具有下列屬性：

相關 API 元素

當作業系統在閒置一段時間之後偵測到滑鼠或鍵盤活動時傳送。

注意：行動裝置或 AIR for TV 裝置不會傳送此事件。

視為閒置的時期可使用 idleThreshold 屬性來設定。使用者已閒置時間量可透過 timeSinceLastUserInput 屬性來判斷。

這個事件具有下列屬性：

相關 API 元素