mx.preloadersIPreloaderDisplay 定义类必须实现以用作下载进度栏的接口。flash.events:IEventDispatcher 定义类必须实现以用作下载进度栏的接口。IPreloaderDisplay 从 Preloader 类接收事件，并负责向用户显示此信息。

mx.preloaders.DownloadProgressBarmx.preloaders.Preloader

initialize backgroundAlpha backgroundColor backgroundImage backgroundSize stageHeight stageWidth preloader Preloader SystemManager 使用 Preloader 类监视 Flex 应用程序的下载和初始化状态。flash.display:Sprite SystemManager 使用 Preloader 类监视 Flex 应用程序的下载和初始化状态。同时还负责下载运行时共享库 (RSL)。

Preloader 类例示必须实现 IPreloaderDisplay 接口的下载进度栏，并将下载和初始化事件传递到下载进度栏。

mx.preloaders.DownloadProgressBarmx.preloaders.Preloader

Preloader 构造函数。构造函数。 initialize 由 SystemManager 调用，用于初始化 Preloader 对象。showDisplay确定是否应该显示显示类。 displayClassNameIPreloaderDisplay 类，用于显示 preloader 状态。 backgroundColor应用程序的背景颜色。 backgroundAlpha应用程序的背景 alpha。 backgroundImage应用程序的背景图像。 backgroundSize应用程序的背景大小。 displayWidth应用程序的宽度。 displayHeight应用程序的高度。 libsnull用于运行时共享库的字符串 URL 的数组。 sizesnulluint 值的数组，包含 libs 参数中每个 URL 的字节大小 rslListnull类型 RSLItem 和 CdRSLItem 的对象数组。此数组描述要加载的所有 RSL。忽略 lib 和大小参数，必须将其设置为 null。 resourceModuleURLsnull指定用于预加载资源模块的 URL 的字符串的数组。 applicationDomainnull正在其中执行代码的应用程序域。由 SystemManager 调用，用于初始化 Preloader 对象。 registerApplication 完成例示应用程序类的一个实例后调用 SystemManager。app应用程序对象。完成例示应用程序类的一个实例后调用 SystemManager。Flex 调用此方法；您不要自己调用它。 DownloadProgressBar DownloadProgressBar 类显示下载进度。mx.preloaders:IPreloaderDisplayflash.display:Sprite DownloadProgressBar 类显示下载进度。下载和加载应用程序期间，Preloader 控件使用它提供用户反馈。

下载进度栏显示关于两个应用程序阶段的信息：下载阶段和例示阶段。

在 Application 容器中，使用 preloader 属性可以指定子类的名称。

您可以通过创建 DownloadProgressBar 类的子类来实现自定义下载进度栏组件。不要将下载进度栏实现为 MXML 组件，因为这样下载速度太慢。

mx.core.Applicationmx.preloaders.IPreloaderDisplaymx.preloaders.Preloader

DownloadProgressBar 构造函数。构造函数。 center 根据传入的维度居中放置下载进度栏。width居中放置下载进度栏的区域宽度。 height居中放置下载进度栏的区域高度。根据传入的维度居中放置下载进度栏。 completeHandler 用于 Event.COMPLETE 事件的事件侦听器。event事件对象。用于 Event.COMPLETE 事件的事件侦听器。默认实现不起任何作用。 createChildren 创建显示的子组件。创建显示的子组件。 getPercentLoaded 返回已下载应用程序的百分比值。已下载应用程序的百分比值。 loaded已下载的应用程序 SWF 文件的字节数。 total应用程序 SWF 文件的大小（以字节为单位）。返回已下载应用程序的百分比值。 initCompleteHandler 用于 FlexEvent.INIT_COMPLETE 事件的事件侦听器。event事件对象。用于 FlexEvent.INIT_COMPLETE 事件的事件侦听器。 initProgressHandler 用于 FlexEvent.INIT_PROGRESS 事件的事件侦听器。event事件对象。用于 FlexEvent.INIT_PROGRESS 事件的事件侦听器。此实现在每次分派事件时更新进度栏，并且更改标签文本。 initialize 将下载进度栏添加为 Preloader 的子级后，由 Preloader 调用。将下载进度栏添加为 Preloader 的子级后，由 Preloader 调用。这应该是配置下载进度栏的起始点。 progressHandler 用于 ProgressEvent.PROGRESS 事件的事件侦听器。event事件对象。用于 ProgressEvent.PROGRESS 事件的事件侦听器。此实现使用下载的字节百分比更新进度栏。 rslCompleteHandler 用于 RSLEvent.RSL_COMPLETE 事件的事件侦听器。eventmx.events:RSLEvent事件对象。用于 RSLEvent.RSL_COMPLETE 事件的事件侦听器。 rslErrorHandler 用于 RSLEvent.RSL_ERROR 事件的事件侦听器。eventmx.events:RSLEvent事件对象。用于 RSLEvent.RSL_ERROR 事件的事件侦听器。此事件侦听器处理下载 RSL 时检测到的任何错误。 rslProgressHandler 用于 RSLEvent.RSL_PROGRESS 事件的事件侦听器。eventmx.events:RSLEvent事件对象。用于 RSLEvent.RSL_PROGRESS 事件的事件侦听器。默认实现不起任何作用。 setProgress 使用当前下载信息更新下载进度栏的显示。completed已下载的应用程序 SWF 文件的字节数。 total应用程序 SWF 文件的大小（以字节为单位）。使用当前下载信息更新下载进度栏的显示。典型实现会根据总值划分加载值，并显示百分比。如果不实现此方法，则应创建显示动画的进度栏来向用户表明正在下载。

只有在从远程服务器下载应用程序并且该应用程序不在浏览器缓存中时才调用 setProgress() 方法。

showDisplayForDownloading 定义是否在下载阶段显示下载进度栏的算法。如果返回值为 true，则显示下载进度栏。默认行为是，如果已经过 700 毫秒但 Flex 已下载的 SWF 文件字节数尚未过半，则显示下载进度栏。 elapsedTime下载阶段开始后已经过的毫秒数。 eventProgressEvent 对象，包含 bytesLoaded 和 bytesTotal 属性。定义是否在下载阶段显示下载进度栏的算法。 showDisplayForInit 定义确定是否在初始化阶段显示下载进度栏的算法，假设显示当前不可见。如果为 true，则显示下载进度栏。 elapsedTime下载阶段开始后已经过的毫秒数。 count已从应用程序接收 initProgress 事件的次数。定义确定是否在初始化阶段显示下载进度栏的算法，假设显示当前不可见。 DOWNLOAD_PERCENTAGE 完全下载 SWF 文件时下载阶段填充的进度栏的百分比。6060 完全下载 SWF 文件时下载阶段填充的进度栏的百分比。初始化阶段期间填充进度栏的剩余部分。此值应该介于 0 和 100 之间。 MINIMUM_DISPLAY_TIME 显示应该可见的最小毫秒数。00 显示应该可见的最小毫秒数。如果应用程序的下载和初始化时间低于此值，则 Flex 在分派 complete 事件前暂停此时间总额。 initProgressTotal 希望在初始化阶段获得的验证事件总数。66 希望在初始化阶段获得的验证事件总数。它应该是一个大于或等于 4 的整数（请注意，如果该数值大于 4，初始化代码中可能有无效部分） backgroundAlpha backgroundImage 属性定义的 SWF 文件或图像的 Alpha 级别，或者 backgroundColor 属性定义的颜色。1.0 backgroundImage 属性定义的 SWF 文件或图像的 Alpha 级别，或者 backgroundColor 属性定义的颜色。有效值范围是 0 到 1.0。

您可以指定 backgroundColor 或 backgroundImage，但是不能同时指定两者。

backgroundColor 下载进度栏的背景颜色。下载进度栏的背景颜色。您可以具有 backgroundColor 或 backgroundImage，但是不能同时具有两者。 backgroundImage 由 Preloader 传入的应用程序的背景图像。null 由 Preloader 传入的应用程序的背景图像。您可以指定 backgroundColor 或 backgroundImage，但是不能同时指定两者。

值 null 表示“未设置”。如果此样式和 backgroundColor 样式都未定义，则控件将采用透明背景。

preloader 不显示嵌入的图像。您只能使用在运行时加载的图像。

backgroundSize 将 backgroundImage 指定的图像缩放到不同的百分比大小。"auto" 将 backgroundImage 指定的图像缩放到不同的百分比大小。"100%" 值将拉抻该图像以适应整个组件。要指定百分比值，您必须输入百分号 (%)。值 "auto" 表示维持原始图像大小。 barFrameRect 进度栏边框的尺寸。mx.geom:RoundedRectangle 进度栏边框的尺寸。此为只读属性，如果您需要更改，则必须覆盖该属性。 barRect 进度栏的尺寸。mx.geom:RoundedRectangle 进度栏的尺寸。此为只读属性，如果您需要更改，则必须覆盖该属性。 borderRect 显示边框的尺寸。mx.geom:RoundedRectangle 显示边框的尺寸。此为只读属性，如果您需要更改，则必须覆盖该属性。 downloadingLabel 下载阶段要显示为标签的字符串。"Loading" 下载阶段要显示为标签的字符串。 initializingLabel 初始化阶段要显示为标签的字符串。"Initializing" 初始化阶段要显示为标签的字符串。 labelFormat 标签的 TextField 组件的 TextFormat 对象。标签的 TextField 组件的 TextFormat 对象。此为只读属性，如果您需要更改，则必须覆盖该属性。 labelRect 标签 TextField 组件的尺寸。标签 TextField 组件的尺寸。此为只读属性，如果您需要更改，则必须覆盖该属性。 label 进度栏活动时要显示的文本。"" 进度栏活动时要显示的文本。Preloader 类在显示进度栏前设置此值。可以选择是否在子类中实现此属性。 percentFormat 显示百分比的 TextField 组件的 TextFormat。显示百分比的 TextField 组件的 TextFormat。此为只读属性，如果您需要更改，则必须覆盖该属性。 percentRect 显示百分比的 TextField 组件的尺寸。显示百分比的 TextField 组件的尺寸。此为只读属性，如果您需要更改，则必须覆盖该属性。 showLabel 控制是否要显示标签。是，则为 true；或者否，则为 false。true 控制是否显示标签。是，则为 true；或者否，则为 false。 showPercentage 控制是否显示百分比。是，则为 true；或者否，则为 false。true 控制是否显示百分比。是，则为 true；或者否，则为 false。 stageHeight 舞台的高度，由 Preloader 类传入。舞台的高度，由 Preloader 类传入。 stageWidth 舞台的宽度，由 Preloader 类传入。舞台的宽度，由 Preloader 类传入。 visible 指定下载进度栏是否可见。false 指定下载进度栏是否可见。

当 Preloader 控件决定应该显示进度栏时，它将此值设置为 true。当 Preloader 控件决定应该隐藏进度栏时，它将该值设置为 false。

DownloadProgressBar 类的子类绝不应该修改此属性。相反，您可以覆盖 setter 方法来识别 Preloader 控件修改此属性的时间，并且执行任何必要的动作。

preloader Preloader 类会将到自身的引用传入显示类，以侦听来自 Preloader 的事件。 Preloader 类会将到自身的引用传入显示类，以侦听来自 Preloader 的事件。 SparkDownloadProgressBar SparkDownloadProgressBar 类可显示下载进度。mx.preloaders:IPreloaderDisplayflash.display:Sprite SparkDownloadProgressBar 类可显示下载进度。下载和加载应用程序期间，Preloader 控件使用它提供用户反馈。

下载进度栏显示关于两个应用程序阶段的信息：下载阶段和例示阶段。

在 Application 容器中，使用 preloader 属性可以指定子类的名称。

您可以通过创建 SparkDownloadProgressBar 类的子类来实现自定义下载进度栏组件。不要将下载进度栏实现为 MXML 组件，因为这样下载速度太慢。

mx.core.Applicationmx.preloaders.IPreloaderDisplaymx.preloaders.Preloader

SparkDownloadProgressBar 构造函数。构造函数。 completeHandler 用于 Event.COMPLETE 事件的事件侦听器。event事件对象。用于 Event.COMPLETE 事件的事件侦听器。默认实现不起任何作用。 createChildren 创建显示的子组件。创建显示的子组件。 initCompleteHandler 用于 FlexEvent.INIT_COMPLETE 事件的事件侦听器。event事件对象用于 FlexEvent.INIT_COMPLETE 事件的事件侦听器。此实现可分派 Event.COMPLETE 事件。 initProgressHandler 用于 FlexEvent.INIT_PROGRESS 事件的事件侦听器。event事件对象。用于 FlexEvent.INIT_PROGRESS 事件的事件侦听器。此实现在每次分派事件时更新进度栏。 initialize 将下载进度栏添加为 Preloader 的子级后，由 Preloader 调用。将下载进度栏添加为 Preloader 的子级后，由 Preloader 调用。这应该是配置下载进度栏的起始点。 progressHandler 用于 ProgressEvent.PROGRESS 事件的事件侦听器。event事件对象。用于 ProgressEvent.PROGRESS 事件的事件侦听器。此实现使用下载的字节百分比更新进度栏。 rslCompleteHandler 用于 RSLEvent.RSL_COMPLETE 事件的事件侦听器。eventmx.events:RSLEvent事件对象。用于 RSLEvent.RSL_COMPLETE 事件的事件侦听器。 rslErrorHandler 用于 RSLEvent.RSL_ERROR 事件的事件侦听器。eventmx.events:RSLEvent事件对象。用于 RSLEvent.RSL_ERROR 事件的事件侦听器。此事件侦听器处理下载 RSL 时检测到的任何错误。 rslProgressHandler 用于 RSLEvent.RSL_PROGRESS 事件的事件侦听器。eventmx.events:RSLEvent事件对象。用于 RSLEvent.RSL_PROGRESS 事件的事件侦听器。默认实现不起任何作用。 setDownloadProgress 更新下载进度栏的外部部分以指明下载进度。completed已下载的应用程序 SWF 文件的字节数。 total应用程序 SWF 文件的大小（以字节为单位）。更新下载进度栏的外部部分以指明下载进度。 setInitProgress 更新下载进度栏的内部部分以指明初始化进度。completed已完成的初始化步骤数 total总初始化步骤数更新下载进度栏的内部部分以指明初始化进度。 showDisplayForDownloading 定义是否在下载阶段显示下载进度栏的算法。如果返回值为 true，则显示下载进度栏。默认行为是，如果已经过 700 毫秒但 Flex 已下载的 SWF 文件字节数尚未过半，则显示下载进度栏。 elapsedTime下载阶段开始后已经过的毫秒数。 eventProgressEvent 对象，包含 bytesLoaded 和 bytesTotal 属性。定义是否在下载阶段显示下载进度栏的算法。 showDisplayForInit 定义确定是否在初始化阶段显示下载进度栏的算法，假设显示当前不可见。如果为 true，则显示下载进度栏。 elapsedTime下载阶段开始后已经过的毫秒数。 count已从应用程序接收 initProgress 事件的次数。定义确定是否在初始化阶段显示下载进度栏的算法，假设显示当前不可见。 initProgressTotal 希望在初始化阶段获得的验证事件总数。66 希望在初始化阶段获得的验证事件总数。它应该是一个大于或等于 4 的整数（请注意，如果该数值大于 4，初始化代码中可能有无效部分） backgroundAlpha backgroundImage 属性定义的 SWF 文件或图像的 Alpha 级别，或者 backgroundColor 属性定义的颜色。1.0 backgroundImage 属性定义的 SWF 文件或图像的 Alpha 级别，或者 backgroundColor 属性定义的颜色。有效值范围是 0 到 1.0。覆盖此属性可以在自定义类中设置自己的值。

您可以指定 backgroundColor 或 backgroundImage，但是不能同时指定两者。

backgroundColor 下载进度栏的背景颜色。下载进度栏的背景颜色。覆盖此属性可以在自定义类中设置自己的值。

您可以指定 backgroundColor 或 backgroundImage，但是不能同时指定两者。

backgroundImage 由 Preloader 传入的应用程序的背景图像。null 由 Preloader 传入的应用程序的背景图像。覆盖此属性可以在自定义类中设置自己的值。

您可以指定 backgroundColor 或 backgroundImage，但是不能同时指定两者。

值 null 表示“未设置”。如果此样式和 backgroundColor 样式都未定义，则控件将采用透明背景。

preloader 不显示嵌入的图像。您只能使用在运行时加载的图像。

backgroundSize 将 backgroundImage 指定的图像缩放到不同的百分比大小。"auto" 将 backgroundImage 指定的图像缩放到不同的百分比大小。"100%" 值将拉抻该图像以适应整个组件。要指定百分比值，您必须输入百分号 (%)。值 "auto" 表示维持原始图像大小。 stageHeight 舞台的高度，由 Preloader 类传入。舞台的高度，由 Preloader 类传入。 stageWidth 舞台的宽度，由 Preloader 类传入。舞台的宽度，由 Preloader 类传入。 visible 指定下载进度栏是否可见。false 指定下载进度栏是否可见。

当 Preloader 控件决定应该显示进度栏时，它将此值设置为 true。当 Preloader 控件决定应该隐藏进度栏时，它将该值设置为 false。

SparkDownloadProgressBar 类的子类绝不应该修改此属性。相反，您可以覆盖 setter 方法来识别 Preloader 控件修改此属性的时间，并且执行任何必要的动作。

preloader Preloader 类会将到自身的引用传入显示类，以侦听来自 Preloader 的事件。 Preloader 类会将到自身的引用传入显示类，以侦听来自 Preloader 的事件。