使用 UILoader 組件

此 UILoader 組件是一個容器，可以顯示 SWF、JPEG、漸進式 JPEG、PNG 和 GIF 檔。如果您需要從遠端位置擷取內容再放入 Flash 應用程式中，就可以使用 UILoader。例如，您可以使用 UILoader 將公司的標誌 (JPEG 檔) 加入表單中。您也可以在顯示相片的應用程式中使用 UILoader 組件。使用 load() 方法可載入內容、 percentLoaded 屬性可判斷已載入多少內容、 complete 事件可判斷載入作業何時完成。

您可以縮放 UILoader 的內容，或者調整 UILoader 本身的大小來配合內容的大小。在預設狀況下，內容會進行縮放來配合 UILoader。您也可以在執行階段載入內容，並且監視載入進度 (只不過既然已經快取內容，載入進度便會很快就跳至 100%)。如果您在載入內容至 UILoader 時指定位置，則必須將該位置 (X 和 Y 座標) 指定為 0, 0。

與 UILoader 組件的使用者互動

UILoader 組件不能成為焦點。但是，載入至 UILoader 組件中的內容可以成為焦點，並且可以有自己的焦點互動。如需有關控制焦點的詳細資訊，請參閱 Flash Professional 的 ActionScript 3.0 參考 中的「FocusManager 類別」，以及 使用 FocusManager 。

UILoader 組件參數

您可以在「屬性」檢測器或「組件檢測器」中，為每個 UILoader 組件實體設定下列編寫參數： autoLoad 、 maintainAspectRatio 、 source 和 scaleContent 。這些參數都具有相對應的 ActionScript 同名屬性。

進行編寫時，每個 UILoader 實體的即時預覽會反映您在「屬性」檢測器或「組件檢測器」中對參數的變更。

您可以撰寫 ActionScript，使用 UILoader 實體的屬性、方法和事件，以設定 UILoader 實體的其它選項。如需詳細資訊，請參閱 適用於 Adobe Flash Platform 的 ActionScript 3.0 參考 中的 UILoader 類別。

建立具有 UILoader 組件的應用程式

下列程序說明如何在編寫時將 UILoader 組件加入應用程式。在此範例中，載入器會載入某標誌的 GIF 影像。

  1. 建立新的 Flash (ActionScript 3.0) 文件。

  2. 將 UILoader 組件從「組件」面板拖曳到「舞台」。

  3. 在「屬性」檢測器中，輸入實體名稱 aUI 。

  4. 選取「舞台」上的載入器，然後在「組件檢測器」中輸入 http://www.helpexamples.com/images/logo.gif 做為 source 參數的值。

使用 ActionScript 建立 UILoader 組件實體

此範例使用 ActionScript 建立 UILoader 組件，並載入 JPEG 花朵影像。發生 complete 事件時，「輸出」面板將會顯示已載入的位元組數。

  1. 建立新的 Flash (ActionScript 3.0) 文件。

  2. 將 UILoader 組件從「組件」面板拖曳到「元件庫」面板。

  3. 開啟「動作」面板，選取主要「時間軸」中的「影格 1」，然後輸入下列 ActionScript 程式碼： 

    import fl.containers.UILoader; 
 
var aLoader:UILoader = new UILoader(); 
aLoader.source = "http://www.flash-mx.com/images/image1.jpg"; 
aLoader.scaleContent = false; 
addChild(aLoader); 
 
aLoader.addEventListener(Event.COMPLETE, completeHandler); 
function completeHandler(event:Event) { 
    trace("Number of bytes loaded: " + aLoader.bytesLoaded); 
}

  4. 選取「控制 > 測試影片」。