URLFilePromise  - AS3

包	air.desktop
类	public class URLFilePromise
继承	URLFilePromise EventDispatcher Object
实现	IFilePromise

语言版本:

ActionScript 3.0

运行时版本:

AIR 2.0

URLFilePromise 类允许将通过 URL 访问的资源作为 file promise（文件承诺）拖动到 AIR 应用程序外。

URLFilePromise 类可使用 URLStream 和 URLRequest 对象作为数据源实现 IFilePromise 接口。实现可为使用 HTTP 或 URLStream 类支持的其他协议检索的文件提供拖放支持。

创建 URL file promise：

1. 构建并初始化一个或多个 URLFilePromise 对象。
2. 将 URLFilePromise 对象添加到数组。
3. 使用 ClipboardFormat FILE_PROMISE_LIST 为新 Clipboard 对象添加数组。
4. 响应用户手势，调用 NativeDragManager startDrag() 方法，传递包含 file promise 数组的 Clipboard 对象。

当用户完成拖动操作时，运行时将下载每个 file promise 的数据。访问由 URLFilePromise 对象的 request 属性指定的 URL 上的数据，并将其保存到在 relativePath 属性中指定的文件中。文件保存到放置位置的相对位置。因此，如果相对路径是 foo/bar.txt，并且文件承诺放置到 home 目录下，则创建的文件的位置是：home/foo/bar.txt。当发生错误时，不会创建文件。

若要支持不能通过 URLStream 类访问的数据源，请实现 IFilePromise 接口。

注意：AIR 运行时自动调用 IFilePromise 方法，open()、close() 和 reportError()。永远不应该通过应用程序逻辑调用这些方法。同样，由此 URLFilePromise 对象调度的 open、progress、complete 和 close 事件主要用于调试目的。应用程序不需要响应这些事件。

此类包含在 aircore.swc 文件中。创建 Adobe^® AIR^™ 项目时，Adobe^® Flash^™ Builder 将自动加载此类。Adobe^® Flex^™ SDK 也包含此 aircore.swc 文件，当您使用 Flex SDK 编译应用程序时应包含此文件。

要在 Adobe ^® Flash ^® Professional（CS4 或更高版本）中使用 air.desktop 包：

1. 选择“文件”>“发布设置”命令。
2. 在 Flash 面板中，单击 ActionScript 3.0 对应的“设置”按钮。选择“库路径”。
3. 单击“浏览到 SWC 文件”按钮。浏览到 Adobe Flash Professional 安装文件夹中的 Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc 文件。
4. 单击“确定”按钮。
5. 向 ActionScript 3.0 代码添加以下 import 语句：import air.desktop.*;

相关 API 元素

---