LoaderInfo  - AS3

載入的 SWF 檔之 ActionScript 版本。 您可以使用 ActionScriptVersion 類別中的列舉項目來指定語言版本，例如 ActionScriptVersion.ACTIONSCRIPT2 和 ActionScriptVersion.ACTIONSCRIPT3。

注意：此屬性永遠具有 ActionScriptVersion.ACTIONSCRIPT2 或 ActionScriptVersion.ACTIONSCRIPT3 的值。 ActionScript 1.0 和 2.0 都會回報為 ActionScriptVersion.ACTIONSCRIPT2 (版本 2.0)。 此屬性只能區別出 ActionScript 3.0 與 ActionScript 1.0 和 2.0。

相關 API 元素

當載入外部 SWF 檔時，所有包含在載入類別的 ActionScript 3.0 定義都會儲存在 applicationDomain 屬性中。

SWF 檔中的所有程式碼，都是為了存在於應用程式網域中而定義。 目前的應用程式網域也就是您的主應用程式的執行位置。 系統網域包含所有的應用程式網域，其中包括目前的網域以及 Flash Player 或 Adobe AIR 所使用的全部類別。

所有的應用程式網域，除了系統網域之外，都具有相關的父網域。 主要應用程式之 applicationDomain 的父網域就是系統網域。 只有在其父輩尚未定義載入的類別時，這些類別才會獲得定義。 因此，您不能以較新的定義覆寫載入類別的定義。

如需應用程式網域的使用範例，請參閱「ActionScript 3.0 開發人員指南」中的「用戶端系統環境」一章。

相關 API 元素

與 LoaderInfo 物件相關聯的位元組。

媒體所載入的位元組數。 當此數等於 bytesTotal 值，就會載入所有位元組。

整個媒體檔的壓縮位元組數。

在此 LoaderInfo 物件的相對應 Loader 物件傳送第一個 progress 事件之前，bytesTotal 為 0。 在 Loader 物件傳送了 progress 事件之後，bytesTotal 就會反映要下載的實際位元組數。

注意 (僅 iOS)：在 iOS 上執行應用程式時，傳回的值與其他平台上的不同。

相關 API 元素

傳達內容 (子系) 對載入器 (父輩) 的信任關係。 如果子系允許父輩存取，則為 true；否則為 false。 如果子物件已經呼叫 allowDomain() 方法授與父網域權限，或者子網域已經載入授與父網域權限的 URL 原則，則此屬性會設為 true。如果子系與父輩都位於相同的網域，則此屬性會設為 true。

如需安全性詳細資訊，請參閱「Flash Player 開發人員中心」主題：安全性。

物件，可以由載入之內容的程式碼設定，以顯露屬性和方法供 Loader 物件之安全執行程序中的程式碼存取。此「安全執行程序橋接」可讓來自非應用程式網域的內容控制存取權限，以編寫應用程式安全執行程序中的指令碼，反之亦然。此安全執行程序橋接的作用是做為多個安全執行程序之間的閘道，可提供應用程式和非應用程式安全執行程序之間明確的互動。

相關 API 元素

與此 LoaderInfo 物件相關聯的載入物件。

載入檔案的 MIME 類型。 如果未完全載入檔案以判斷類型的話，數值將為 null。以下清單列出可能的值：

• "application/x-shockwave-flash"
• "image/jpeg"
• "image/gif"
• "image/png"

載入的 SWF 檔之名目影格速率，以每秒影格數來定義。 雖然此數通常是整數型態，但不必然是整數。

此數值可能與實際使用的影格速率相異。 在任何時候，Flash Player 或 Adobe AIR 每一次只會在所有載入的 SWF 檔案上使用一個影格速率，而且這個影格速率將由主要 SWF 檔案的名目影格速率所決定。此外，視硬體、音效同步化和其它因素而定，可能無法達到主要影格速率。

載入檔案的名目高度。 此值可能與顯示內容的實際高度相異，因為載入內容或其上層顯示物件可能已經縮放過了。

指出 LoaderInfo.url 屬性是否曾被截斷。當 isURLInaccessible 值為 true 時，LoaderInfo.url 值便只是載入內容之最終 URL 的網域。例如，如果從 http://www.adobe.com/assets/hello.swf 載入內容，而 LoaderInfo.url 屬性的值為 http://www.adobe.com，屬性便會被截斷。只有下列項目都為 true 時，isURLInaccessible 值才會為 true：

• 載入內容過程中，發生 HTTP 重新導向。
• 呼叫 Loader.load() 的 SWF 檔案是來自內容最終 URL 以外的網域。
• 呼叫 Loader.load() 的 SWF 檔案沒有存取內容的權限。授與存取內容權限的方式，和授與 BitmapData.draw() 權限的方式一樣：都是呼叫 Security.allowDomain() 來存取 SWF 檔案 (對於非 SWF 檔案內容，則是建立原則檔案，並使用 LoaderContext.checkPolicyFile 屬性)。

注意：isURLInaccessible 屬性是 Flash Player 10.1 及 AIR 2.0 新增的屬性。不過當 Flash 執行階段支援它時，所有版本的 SWF 檔案都可以使用這個屬性。所以在「嚴謹模式」中使用某些編寫工具會造成編譯錯誤。若要解決錯誤，請使用間接語法 myLoaderInfo["isURLInaccessible"] 或停用嚴謹模式。如果您使用 Flash Professional CS5 或 Flex SDK 4.1，您可以使用及編譯此 API，供 Flash Player 10.1 及 AIR 2 之前的執行階段版本使用。

對於 AIR 中的應用程式內容，這個屬性的值永遠都是 false。

相關 API 元素

與此 LoaderInfo 物件相關聯的 Loader 物件。 如果這個 LoaderInfo 物件是 SWF 檔案主要類別實體的 loaderInfo 屬性，則不會關聯任何 Loader 物件。

針對這個 LoaderInfo 物件所描述的媒體，負責將其載入作業初始化的 SWF 檔案之 URL。 至於 SWF 檔案的主要類別實體，此 URL 與 SWF 檔案自身的 URL 是一樣的。

包含名稱/數值配對的物件，可代表提供給載入之 SWF 檔案的參數。

您可以使用 for-in 迴圈，將所有名稱與數值從 parameters 物件中擷取出來。

兩個參數來源為：主要 SWF 檔之 URL 的查詢字串，以及 FlashVars HTML 參數值 (只會影響主要 SWF 檔)。

parameters 屬性會取代 ActionScript 1.0 與 2.0 做為主要時間軸屬性提供給 SWF 檔案參數使用的功能。

包含運用 ActionScript 1.0 或 2.0 的 SWF 檔，其 Loader 物件的 parameters 屬性值為 null。 只有當 Loader 物件所包含的 SWF 檔使用的是 ActionScript 3.0，其屬性值才不會是 null。

傳達 Loader (父輩) 對內容 (子系) 的信任關係。 如果父輩允許子系存取，則為 true；否則為 false。 如果父物件已經呼叫 allowDomain() 方法授與子網域權限，或者父網域已經載入授與子網域權限的 URL 原則檔，則此屬性會設為 true。如果子系與父輩都位於相同的網域，則此屬性會設為 true。

如需安全性詳細資訊，請參閱「Flash Player 開發人員中心」主題：安全性。

物件，可以透過程式碼在 Loader 物件之安全執行程序中設定，以顯露屬性和方法供所載入之內容的程式碼存取。此「安全執行程序橋接」可讓來自非應用程式網域的內容控制存取權限，以編寫應用程式安全執行程序中的指令碼，反之亦然。此安全執行程序橋接的作用是做為多個安全執行程序之間的閘道，可提供應用程式和非應用程式安全執行程序之間明確的互動。

相關 API 元素

傳達載入器與內容之間的關係：true，如果它們來自相同的原始網域；否則為 false。

EventDispatcher 實體，可用來交換各安全性邊界之間的事件。 即使當 Loader 物件和所載入的內容都是來自安全性網域 (彼此互不信任的網域) 時，兩者還是可以存取 sharedEvents 並透過此物件傳送和接收事件。

載入的 SWF 檔之檔案格式版本。 您可以使用 SWFVersion 類別中的列舉項目來指定檔案格式，例如 SWFVersion.FLASH7 和 SWFVersion.FLASH9。

相關 API 元素

是一個物件，當這個 LoaderInfo 物件之 SWF 檔案的程式碼發生未處理的錯誤時，這個物件就會傳送 uncaughtError 事件。在任何 try..catch 區塊外面發生錯誤時，或傳送的 ErrorEvent 物件沒有註冊偵聽程式時，就會發生未捕捉到的錯誤。

例如，若在 try 區塊中，則會有呼叫其事件處理常式的事件發送程式，而且 catch 區塊不會捕捉以事件處理常式擲回的錯誤。透過偵聽 LoaderInfo.uncaughtErrorEvents 可以捕捉之後擲回的任何錯誤。

當此 LoaderInfo 相關的 SWF 載入完成之後，就會建立這個屬性。直到 uncaughtErrorEvents 屬性變成 null 為止。在僅有 ActionScript 的專案中，您可以在執行 SWF 檔案主要類別的建構函數期間或之後存取此屬性。對於 Flex 專案，傳送 applicationComplete 事件之後，就可以取得 uncaughtErrorEvents 屬性。

相關 API 元素

package
{
    import flash.display.Sprite;
    import flash.events.ErrorEvent;
    import flash.events.MouseEvent;
    import flash.events.UncaughtErrorEvent;

    public class UncaughtErrorEventExample extends Sprite
    {
        public function UncaughtErrorEventExample()
        {
            loaderInfo.uncaughtErrorEvents.addEventListener(UncaughtErrorEvent.UNCAUGHT_ERROR, uncaughtErrorHandler);
            
            drawUI();
        }
        
        private function uncaughtErrorHandler(event:UncaughtErrorEvent):void
        {
            if (event.error is Error)
            {
                var error:Error = event.error as Error;
                // do something with the error
            }
            else if (event.error is ErrorEvent)
            {
                var errorEvent:ErrorEvent = event.error as ErrorEvent;
                // do something with the error
            }
            else
            {
                // a non-Error, non-ErrorEvent type was thrown and uncaught
            }
        }
        
        private function drawUI():void
        {
            var btn:Sprite = new Sprite();
            btn.graphics.clear();
            btn.graphics.beginFill(0xFFCC00);
            btn.graphics.drawRect(0, 0, 100, 50);
            btn.graphics.endFill();
            addChild(btn);
            btn.addEventListener(MouseEvent.CLICK, clickHandler);
        }
        
        private function clickHandler(event:MouseEvent):void
        {
            throw new Error("Gak!");
        }
    }
}

<?xml version="1.0" encoding="utf-8"?>
<s:WindowedApplication xmlns:fx="http://ns.adobe.com/mxml/2009" 
                       xmlns:s="library://ns.adobe.com/flex/spark" 
                       xmlns:mx="library://ns.adobe.com/flex/halo"
                       applicationComplete="applicationCompleteHandler();">
    
    <fx:Script>
        <![CDATA[
            import flash.events.ErrorEvent;
            import flash.events.MouseEvent;
            import flash.events.UncaughtErrorEvent;
            
            private function applicationCompleteHandler():void
            {
                loaderInfo.uncaughtErrorEvents.addEventListener(UncaughtErrorEvent.UNCAUGHT_ERROR, uncaughtErrorHandler);
            }
    
            private function uncaughtErrorHandler(event:UncaughtErrorEvent):void
            {
                if (event.error is Error)
                {
                    var error:Error = event.error as Error;
                    // do something with the error
                }
                else if (event.error is ErrorEvent)
                {
                    var errorEvent:ErrorEvent = event.error as ErrorEvent;
                    // do something with the error
                }
                else
                {
                    // a non-Error, non-ErrorEvent type was thrown and uncaught
                }
            }
            
            private function clickHandler(event:MouseEvent):void
            {
                throw new Error("Gak!");
            }
        ]]>
    </fx:Script>
      
    <s:Button label="Cause Error" click="clickHandler(event);"/>
</s:WindowedApplication>

要載入的媒體 URL。

在這個 LoaderInfo 物件相對應的 Loader 物件傳送第一個 progress 事件之前，url 屬性值只能反映對 Loader 物件的 load() 方法呼叫中指定的初始 URL。 在第一個 progress 事件之後，url 屬性會在解析了任何重新導向作業與相關的 URL 之後，反映媒體的最終 URL。

在某些案例中，url 屬性的值會被截斷; 請參閱 isURLInaccessible 屬性，取得詳細資訊。

相關 API 元素

載入內容的名目寬度。 此值可能與顯示內容的實際寬度相異，因為載入內容或其上層顯示物件可能已經縮放過了。

傳回與 SWF 檔 (定義為物件) 相關聯的 LoaderInfo 物件。

參數

在順利載入資料時傳送。 換句話說，它會在已經下載所有內容而且完成載入時傳送。complete 事件一定會在 init 事件之後傳送。在物件可供存取時會傳送 init 事件，儘管內容可能仍在下載中。

這個事件具有下列屬性：

相關 API 元素

當透過 HTTP 發出網路要求並可以偵測到 HTTP 狀態碼時傳送。

這個事件具有下列屬性：

相關 API 元素

當載入的 SWF 檔的屬性和方法可供存取使用時傳送。不過，內容可能仍在下載中。當下列條件存在時，LoaderInfo 物件會傳送 init 事件：

• 所有與載入物件相關聯的屬性和方法，以及那些與 LoaderInfo 物件相關聯的屬性和方法都可以存取。
• 所有子物件的建構函式都已完成。
• 所載入 SWF 檔的主要時間軸的第一個影格中的所有 ActionScript 程式碼都已經執行。

例如，Event.INIT 會在影片或動畫的第一個影格載入時傳送。接著，影片便可供存取並可加入至顯示清單。不過，完整的影片會花較長的時間來下載。Event.COMPLETE 只會在已載入完整影片時傳送。

init 事件一定會在 complete 事件之前發生。

這個事件具有下列屬性：

相關 API 元素

當發生輸入或輸出錯誤而導致載入作業失敗時傳送。

這個事件具有下列屬性：

相關 API 元素

在載入作業開始時傳送。

這個事件具有下列屬性：

相關 API 元素

在下載作業進行中收到資料時傳送。

這個事件具有下列屬性：

相關 API 元素

每當使用 Loader 物件的 unload() 方法移除載入的物件，或是使用相同的 Loader 物件執行第二次載入並在載入開始之前移除原始內容時，由 LoaderInfo 物件傳送。

這個事件具有下列屬性：

相關 API 元素

1. 會建立 url 屬性，此屬性將為影像的位置與名稱。
2. 類別建構函式會建立一個物件，名為 loader。
3. loader 物件會將事件偵聽程式實體化，以確保影像正確載入。
4. 建構函式會建立新的 URLRequest 物件實體 request，並傳遞 url 以便告知檔案名稱與位置。
5. request 物件會傳遞至 loader 物件的 load() 方法，然後將影像載入顯示清單中。

重要：在此範例中，您需要將名為 Image.gif 的檔案加入與已編譯 SWF 檔案相同的目錄中。 使用的影像之影像區域必須與主要 SWF 檔的尺寸相符。

package {
    import flash.display.Loader;
    import flash.display.LoaderInfo;
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.URLRequest;

    public class LoaderInfoExample extends Sprite {
        private var url:String = "Image.gif";

        public function LoaderInfoExample() {
            var loader:Loader = new Loader();
            loader.contentLoaderInfo.addEventListener(Event.INIT, initHandler);
            loader.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            var request:URLRequest = new URLRequest(url);
            loader.load(request);
            addChild(loader);
        }

        private function initHandler(event:Event):void {
            var loader:Loader = Loader(event.target.loader);
            var info:LoaderInfo = LoaderInfo(loader.contentLoaderInfo);
            trace("initHandler: loaderURL=" + info.loaderURL + " url=" + info.url);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}