包 | 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():String
width | 属性 |
Tue Jun 12 2018, 11:04 AM Z