| 套件 | fl.display |
| 類別 | public class ProLoaderInfo |
| 繼承 | ProLoaderInfo  EventDispatcher Object |
| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS5.5 |
| 執行階段版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
這個類別的一些成員，包括 childSandboxBridge 和 parentSandboxBridge，在所有的 Flash Player 和 AIR 版本中都不受支援。請只在您的發佈 AIR 或 Flash Player 版本支援時，才呼叫這些屬性。在其他內容中呼叫這些屬性會產生執行階段錯誤。
相關 API 元素
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
| actionScriptVersion : uint [唯讀]
載入的 SWF 檔之 ActionScript 版本。 | ProLoaderInfo | ||
| applicationDomain : ApplicationDomain [唯讀]
當載入外部 SWF 檔時，所有包含在載入類別的 ActionScript 3.0 定義都會儲存在 applicationDomain 屬性中。 | ProLoaderInfo | ||
| bytes : ByteArray [唯讀]
與 ProLoaderInfo 物件相關聯的位元組。 | ProLoaderInfo | ||
| bytesLoaded : uint [唯讀]
媒體所載入的位元組數。 | ProLoaderInfo | ||
| bytesTotal : uint [唯讀]
在此物件的相對應 ProLoader 物件傳送第一個 progress 事件之前，bytesTotal 為 0。 | ProLoaderInfo | ||
| childAllowsParent : Boolean [唯讀]
表示內容 (子系) 對 ProLoader (父輩) 的信任關係。 | ProLoaderInfo | ||
| childSandboxBridge : Object
物件，可以由載入之內容的程式碼設定，以顯露屬性和方法供 ProLoader 物件之安全執行程序中的程式碼存取。 | ProLoaderInfo | ||
 | constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| content : DisplayObject [唯讀]
與此 ProLoaderInfo 物件相關聯的載入物件。 | ProLoaderInfo | ||
| contentType : String [唯讀]
載入檔案的 MIME 類型。 | ProLoaderInfo | ||
| frameRate : Number [唯讀]
載入的 SWF 檔之名目影格速率，以每秒影格數來定義。 | ProLoaderInfo | ||
| height : int [唯讀]
載入檔案的名目高度。 | ProLoaderInfo | ||
| isURLInaccessible : Boolean [唯讀]
指出 ProLoaderInfo.url 屬性是否曾被截斷。 | ProLoaderInfo | ||
| loader : ProLoader [唯讀]
與此 ProLoaderInfo 物件相關聯的 ProLoader 物件。 | ProLoaderInfo | ||
| loaderURL : String [唯讀]
針對這個 ProLoaderInfo 物件所描述的媒體，負責將其載入作業初始化之 SWF 檔案的 URL。 | ProLoaderInfo | ||
| parameters : Object [唯讀]
包含名稱/數值配對的物件，可代表提供給載入之 SWF 檔案的參數。 | ProLoaderInfo | ||
| parentAllowsChild : Boolean [唯讀]
表示 ProLoader (父輩) 對內容 (子系) 的信任關係。 | ProLoaderInfo | ||
| parentSandboxBridge : Object
物件，可以透過程式碼在 ProLoader 物件之安全執行程序中設定，以顯露屬性和方法供所載入之內容的程式碼存取。 | ProLoaderInfo | ||
| sameDomain : Boolean [唯讀]
傳達載入器與內容之間的關係： 如果它們來自相同的原始網域則為 true；否則為 false。 | ProLoaderInfo | ||
| sharedEvents : EventDispatcher [唯讀]
因為載入 RSL 預先載入內容的時間問題，建議等收到 init 事件，才新增事件偵聽程式至 sharedEvents 物件，或是在收到 init 事件時再次新增事件偵聽程式。 | ProLoaderInfo | ||
| swfVersion : uint [唯讀]
載入的 SWF 檔之檔案格式版本。 | ProLoaderInfo | ||
| url : String [唯讀]
要載入的媒體 URL。 | ProLoaderInfo | ||
| width : int [唯讀]
載入內容的名目寬度。 | ProLoaderInfo | ||
actionScriptVersion | 屬性 |
actionScriptVersion:uint [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS5.5 |
| 執行階段版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
載入的 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。
實作
public function get actionScriptVersion():uint相關 API 元素
applicationDomain | 屬性 |
applicationDomain:ApplicationDomain [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS5.5 |
| 執行階段版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
當載入外部 SWF 檔時，所有包含在載入類別的 ActionScript 3.0 定義都會儲存在 applicationDomain 屬性中。
SWF 檔中的所有程式碼，都是為了存在於應用程式網域中而定義。 目前的應用程式網域也就是您的主應用程式的執行位置。 系統網域包含所有的應用程式網域，其中包括目前的網域以及 Flash Player 或 Adobe AIR 所使用的全部類別。
所有的應用程式網域，除了系統網域之外，都具有相關的父網域。 主要應用程式之 applicationDomain 的父網域就是系統網域。 只有在其父輩尚未定義載入的類別時，這些類別才會獲得定義。 因此，您不能以較新的定義覆寫載入類別的定義。
如需應用程式網域的使用範例，請參閱「ActionScript 3.0 開發人員指南」中的「用戶端系統環境」一章。
實作
public function get applicationDomain():ApplicationDomain相關 API 元素
bytes | 屬性 |
bytesLoaded | 屬性 |
bytesTotal | 屬性 |
childAllowsParent | 屬性 |
childAllowsParent:Boolean [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS5.5 |
| 執行階段版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
表示內容 (子系) 對 ProLoader (父輩) 的信任關係。如果子系允許父輩存取，則為 true；否則為 false。 如果子物件已經呼叫 allowDomain() 方法授與父網域權限，或者子網域已經載入授與父網域權限的 URL 原則，則此屬性會設為 true。如果子系與父輩都位於相同的網域，則此屬性會設為 true。
如需安全性詳細資訊，請參閱「Flash Player 開發人員中心」主題：安全性。
實作
public function get childAllowsParent():Boolean相關 API 元素
childSandboxBridge | 屬性 |
childSandboxBridge:Object| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS5.5 |
| 執行階段版本: | AIR 1.0 |
物件，可以由載入之內容的程式碼設定，以顯露屬性和方法供 ProLoader 物件之安全執行程序中的程式碼存取。此「安全執行程序橋接」可讓來自非應用程式網域的內容控制存取權限，以編寫 AIR 應用程式安全執行程序中的指令碼，反之亦然。此安全執行程序橋接的作用是做為多個安全執行程序之間的閘道，可提供應用程式和非應用程式安全執行程序之間明確的互動。
實作
public function get childSandboxBridge():Object public function set childSandboxBridge(value:Object):void擲回值
SecurityError — 只有載入之內容的安全執行程序可以存取此屬性。
|
相關 API 元素
content | 屬性 |
content:DisplayObject [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS5.5 |
| 執行階段版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
與此 ProLoaderInfo 物件相關聯的載入物件。
實作
public function get content():DisplayObject相關 API 元素
contentType | 屬性 |
frameRate | 屬性 |
frameRate:Number [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS5.5 |
| 執行階段版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
載入的 SWF 檔之名目影格速率，以每秒影格數來定義。 雖然此數通常是整數型態，但不必然是整數。
此數值可能與實際使用的影格速率相異。 在任何時候，Flash Player 或 Adobe AIR 每一次只會在所有載入的 SWF 檔案上使用一個影格速率，而且這個影格速率將由主要 SWF 檔案的名目影格速率所決定。此外，視硬體、音效同步化和其它因素而定，可能無法達到主要影格速率。
實作
public function get frameRate():Number相關 API 元素
height | 屬性 |
isURLInaccessible | 屬性 |
isURLInaccessible:Boolean [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS5.5 |
| 執行階段版本: | Flash Player 10.1, AIR 2 |
指出 ProLoaderInfo.url 屬性是否曾被截斷。當 isURLInaccessible 值為 true 時，ProLoaderInfo.url 值便只是載入內容之最終 URL 的網域。例如，如果從 http://www.adobe.com/assets/hello.swf 載入內容，而 ProLoaderInfo.url 屬性的值為 http://www.adobe.com，屬性便會被截斷。只有下列項目都為 true 時，isURLInaccessible 值才會為 true：
- 載入內容過程中，發生 HTTP 重新導向。
- 呼叫
ProLoader.load()的 SWF 檔案是來自內容最終 URL 以外的網域。 - 呼叫
ProLoader.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。
實作
public function get isURLInaccessible():Boolean相關 API 元素
loader | 屬性 |
loaderURL | 屬性 |
parameters | 屬性 |
parameters:Object [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS5.5 |
| 執行階段版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
包含名稱/數值配對的物件，可代表提供給載入之 SWF 檔案的參數。
您可以使用 for-in 迴圈，將所有名稱與數值從 parameters 物件中擷取出來。
兩個參數來源為：主要 SWF 檔之 URL 的查詢字串，以及 FlashVars HTML 參數值 (只會影響主要 SWF 檔)。
parameters 屬性會取代 ActionScript 1.0 與 2.0 做為主要時間軸屬性提供給 SWF 檔案參數使用的功能。
包含運用 ActionScript 1.0 或 2.0 的 SWF 檔案，其 ProLoader 物件的 parameters 屬性值為 null。只有當 ProLoader 物件所包含的 SWF 檔案使用的是 ActionScript 3.0，其屬性值才不會是 null。
實作
public function get parameters():Object相關 API 元素
parentAllowsChild | 屬性 |
parentAllowsChild:Boolean [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS5.5 |
| 執行階段版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
表示 ProLoader (父輩) 對內容 (子系) 的信任關係。如果父輩允許子系存取，則為 true；否則為 false。 如果父物件已經呼叫 allowDomain() 方法授與子網域權限，或者父網域已經載入授與子網域權限的 URL 原則檔，則此屬性會設為 true。如果子系與父輩都位於相同的網域，則此屬性會設為 true。
如需安全性詳細資訊，請參閱「Flash Player 開發人員中心」主題：安全性。
實作
public function get parentAllowsChild():Boolean擲回值
Error — 如果檔案未完全下載即擷取要求的資訊，則會擲出事件。
|
相關 API 元素
parentSandboxBridge | 屬性 |
parentSandboxBridge:Object| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS5.5 |
| 執行階段版本: | AIR 1.0 |
物件，可以透過程式碼在 ProLoader 物件之安全執行程序中設定，以顯露屬性和方法供所載入之內容的程式碼存取。此「安全執行程序橋接」可讓來自非應用程式網域的內容控制存取權限，以編寫 AIR 應用程式安全執行程序中的指令碼，反之亦然。此安全執行程序橋接的作用是做為多個安全執行程序之間的閘道，可提供應用程式和非應用程式安全執行程序之間明確的互動。
實作
public function get parentSandboxBridge():Object public function set parentSandboxBridge(value:Object):void擲回值
SecurityError — 只有 ProLoader 物件之安全執行程序中的內容可以存取此屬性。
|
相關 API 元素
sameDomain | 屬性 |
sharedEvents | 屬性 |
sharedEvents:EventDispatcher [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS5.5 |
| 執行階段版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
因為載入 RSL 預先載入內容的時間問題，建議等收到 init 事件，才新增事件偵聽程式至 sharedEvents 物件，或是在收到 init 事件時再次新增事件偵聽程式。
實作
public function get sharedEvents():EventDispatcher相關 API 元素
swfVersion | 屬性 |
url | 屬性 |
url:String [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flash CS5.5 |
| 執行階段版本: | Flash Player 9, AIR 1.0, Flash Lite 4 |
要載入的媒體 URL。
在這個 ProLoaderInfo 物件相對應的 ProLoader 物件傳送第一個 progress 事件之前，url 屬性值只能反映對 ProLoader 物件的 load() 方法呼叫中指定的初始 URL。在第一個 progress 事件之後，url 屬性會在解析了任何重新導向作業與相關的 URL 之後，反映媒體的最終 URL。
在某些案例中，url 屬性的值會被截斷; 請參閱 isURLInaccessible 屬性，取得詳細資訊。
實作
public function get url():Stringwidth | 屬性 |
Tue Jun 12 2018, 03:47 PM Z