| 包 | 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 [只读]
SWF 文件的 URL,该 SWF 文件启动对此 ProLoaderInfo 对象所描述的媒体的加载。 | 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 1.0 和 2.0 与 ActionScript 3.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,则可以对在 Flash Player 10.1 和 AIR 2 之前发布的运行时使用和编译此 API。
对于 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。仅对于包含使用 ActionScript 3.0 的 SWF 文件的 ProLoader 对象,该值才为非 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, 11:04 AM Z
隐藏继承的公共属性
显示继承的公共属性