| Пакет | air.desktop |
| Класс | public class URLFilePromise |
| Наследование | URLFilePromise  EventDispatcher Object |
| Реализует | IFilePromise |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.0 |
Класс URLFilePromise реализует интерфейс IFilePromise, использующий объекты URLStream и URLRequest в качестве источника данных. Реализация этого интерфейса обеспечивает поддержку перетаскивания для файлов, которые можно получить через HTTP или другие протоколы, поддерживаемые классом URLStream.
Чтобы создать предварительный образ файла по URL-ссылке, выполните следующие действия.
- Создайте и инициализируйте один или несколько объектов URLFilePromise.
- Добавьте объекты URLFilePromise в массив.
- Добавьте массив в новый объект Clipboard с помощью экземпляра ClipboardFormat,
FILE_PROMISE_LIST. - В ответ на действие пользователя вызовите метод
startDrag()экземпляра NativeDragManager, передав при этом объект Clipboard, содержащий массив предварительных образов файлов.
Когда пользователь завершает перетаскивание, среда выполнения загружает данные для каждого предварительного образа файла. Данные загружаются с URL-адреса, указанного в свойстве request объекта URLFilePromise, и сохраняются в файл, указанный в свойстве relativePath. Файл сохраняется относительно того места, куда он помещен в процессе перетаскивания. Таким образом, если относительный путь — foo/bar.txt и предварительный образ файла перетаскиванием перемещен в каталог с именем home, тогда полный путь будет — home/foo/bar.txt. В случае ошибки файл не создается.
Чтобы обеспечить поддержку источников данных, к которым нельзя получить доступ с помощью класса URLStream, необходимо реализовать интерфейс IFilePromise.
Примечание. Среда выполнения AIR вызывает автоматически методы IFilePromise: open(), close() и reportError(). Эти методы ни в коем случае нельзя вызывать с помощью логики программы. Подобным образом события open, progress, complete и close отправляются этим объектом URLFilePromise в первую очередь с целью отладки работы. Программа не должна отвечать на эти события.
Этот класс включен в файл aircore.swc. Adobe® Flash™ Builder загружает этот класс автоматически при создании проекта для Adobe® AIR™. Adobe® Flex™ SDK также включает файл aircore.swc, который необходимо добавлять при компиляции приложения с использованием Flex SDK.
Чтобы использовать пакет air.desktop в Adobe® Flash® Professional (CS4 и более поздних версий), выполните следующие действия.
- Выберите меню «Файл» > «Параметры публикации».
- В панели Flash нажмите кнопку «Параметры» для ActionScript 3.0. Выберите «Путь к библиотеке».
- Нажмите кнопку «Перейти к файлу SWC». Найдите файл Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc в папке установки Adobe Flash Professional.
- Нажмите кнопку «ОК».
- Вставьте следующую инструкцию
importв код ActionScript 3.0:import air.desktop.*;
Связанные элементы API
Класс Clipboard
Класс ClipboardFormats
Класс NativeDragManager
Класс URLStream
Класс URLRequest
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| isAsync : Boolean [только для чтения]
Указывает, доступны ли данные ресурса в асинхронном режиме. | URLFilePromise | ||
| relativePath : String
Путь и имя созданного файла относительно места назначения перетаскивания. | URLFilePromise | ||
| request : URLRequest
Объект URLRequest, указывающий ресурс, который должен быть скопирован в результате операции перетаскивания. | URLFilePromise | ||
| Метод | Определено | ||
|---|---|---|---|
Создает объект URLFilePromise. | URLFilePromise | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
Позволяет среде выполнения AIR вовремя закрыть источник данных в ходе операции перетаскивания. | URLFilePromise | ||
|
Посылает событие в поток событий. | EventDispatcher | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
Позволяет среде выполнения AIR вовремя открыть источник данных в ходе операции перетаскивания. | URLFilePromise | ||
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
Позволяет среде выполнения AIR сообщать об ошибках в ходе операции перетаскивания. | URLFilePromise | ||
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
| Отправляется после завершения загрузки данных файла. | URLFilePromise | |||
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | ||
| Отправляется для запросов HTTP с целью сообщения заголовков ответа. | URLFilePromise | |||
| Отправляется для запросов HTTP с целью сообщения кода состояния запроса. | URLFilePromise | |||
| Отправляется, когда объект IOError препятствует загрузке файла. | URLFilePromise | |||
| Отправляется после открытия подключения для основного объекта URLStream. | URLFilePromise | |||
| Отправляется, когда блок данных доступен для чтения из основного экземпляра URLStream. | URLFilePromise | |||
| Отправляется, когда ошибка безопасности препятствует загрузке файла. | URLFilePromise | |||
isAsync | свойство |
isAsync:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.0 |
Указывает, доступны ли данные ресурса в асинхронном режиме.
Свойство isAsync объекта URLFilePrmise всегда имеет значение true, так как потоки URL являются асинхронными по определению.
Реализация
public function get isAsync():Boolean relativePath | свойство |
relativePath:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.0 |
Путь и имя созданного файла относительно места назначения перетаскивания.
Путь может включать подкаталоги, разрешение которых выполняется относительно местоположения перетаскивания. При необходимости создаются подкаталоги. При включении подкаталогов следует использовать константу File.separator, чтобы вставить символ-разделитель, который используется для указания пути в текущей операционной системе. Указание .. в качестве комбинации клавиш для перехода к родительскому каталогу не поддерживается.
Имя файла может не соответствовать имени файла удаленного ресурса.
Реализация
public function get relativePath():String public function set relativePath(value:String):void request | свойство |
request:URLRequest| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.0 |
Объект URLRequest, указывающий ресурс, который должен быть скопирован в результате операции перетаскивания.
Реализация
public function get request():URLRequest public function set request(value:URLRequest):void URLFilePromise | () | Конструктор |
public function URLFilePromise()| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.0 |
Создает объект URLFilePromise.
Прежде чем использовать этот объект URLFilePromise, необходимо задать свойства request и relativePath.
close | () | метод |
public function close():void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.0 |
Позволяет среде выполнения AIR вовремя закрыть источник данных в ходе операции перетаскивания.
Не вызывайте эту функцию в логике программы.
open | () | метод |
public function open():IDataInput| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.0 |
Позволяет среде выполнения AIR вовремя открыть источник данных в ходе операции перетаскивания.
Не вызывайте эту функцию в логике программы.
ВозвращаетIDataInput |
reportError | () | метод |
public function reportError(e:ErrorEvent):void| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.0 |
Позволяет среде выполнения AIR сообщать об ошибках в ходе операции перетаскивания.
Объект URLFilePromise повторно отправляет любые события ошибки. Не вызывайте эту функцию в логике программы.
Параметры
e:ErrorEvent |
complete | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.COMPLETE| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.0 |
Отправляется после завершения загрузки данных файла.
Примечание. Среда выполнения AIR использует это событие, чтобы управлять асинхронным процессом получения данных. Как правило, программе нет необходимости предпринимать действия в ответ на это событие.
КонстантаEvent.COMPLETE определяет значение свойства type объекта complete.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Сетевой объект, который завершил загрузку. |
httpResponseStatus | Событие |
flash.events.HTTPStatusEventсвойство HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.0 |
Отправляется для запросов HTTP с целью сообщения заголовков ответа.
В отличии от событияhttpStatus, событие httpResponseStatus доставляется до получения данных ответа. Таким образом, в событие httpResponseStatus входят значения свойств responseHeaders и responseURL (которые для события httpStatus имеют значение undefined.) Обратите внимание на то, что httpResponseStatus (при наличии такового) будет отправляться до (как дополнение) любого события complete или error.
Константа HTTPStatusEvent.HTTP_RESPONSE_STATUS определяет значение свойства type объекта события httpResponseStatus.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
responseURL | URL-адрес, с которого был получен ответ. |
responseHeaders | Заголовки ответа, возвращаемые в ответе, представляют собой массив объектов URLRequestHeader. |
status | Код состояния HTTP, возвращенный сервером. |
redirected | Является ли ответ ли результатом перенаправления. |
target | Сетевой объект, получающий код состояния НТТР. |
httpStatus | Событие |
flash.events.HTTPStatusEventсвойство HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_STATUS| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.0 |
Отправляется для запросов HTTP с целью сообщения кода состояния запроса.
КонстантаHTTPStatusEvent.HTTP_STATUS определяет значение свойства type объекта события httpStatus.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
status | Код состояния HTTP, возвращенный сервером. |
target | Сетевой объект, получающий код состояния НТТР. |
ioError | Событие |
flash.events.IOErrorEventсвойство IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.0 |
Отправляется, когда объект IOError препятствует загрузке файла.
Задает значение свойстваtype для объекта события ioError.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
errorID | Ссылочный номер, связываемый с конкретной ошибкой (только AIR). |
target | Сетевой объект, с которым произошла ошибка ввода/вывода. |
text | Текст, отображаемый в качестве сообщения об ошибке. |
open | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.OPEN| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.0 |
Отправляется после открытия подключения для основного объекта URLStream.
Примечание. Среда выполнения AIR использует это событие, чтобы управлять асинхронным процессом получения данных. Как правило, программе нет необходимости предпринимать действия в ответ на это событие.
КонстантаEvent.OPEN определяет значение свойства type объекта события open.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Сетевой объект, установивший подключение. |
progress | Событие |
flash.events.ProgressEventсвойство ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.0 |
Отправляется, когда блок данных доступен для чтения из основного экземпляра URLStream.
Примечание. Среда выполнения AIR использует это событие, чтобы управлять асинхронным процессом получения данных. Как правило, программе нет необходимости предпринимать действия в ответ на это событие.
Задает значение свойстваtype для объекта события progress.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
bytesLoaded | Число элементов или байтов, загруженных на момент обработки события прослушивателем. |
bytesTotal | Общее число элементов или байтов, которые в итоге будут получены в случае успешного завершения загрузки. |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект, сообщающий сведения о прогрессе. |
securityError | Событие |
flash.events.SecurityErrorEventсвойство SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.0 |
Отправляется, когда ошибка безопасности препятствует загрузке файла.
КонстантаSecurityErrorEvent.SECURITY_ERROR определяет значение свойства type для объекта события securityError.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Сетевой объект, сообщающий об ошибке безопасности. |
text | Текст, отображаемый в качестве сообщения об ошибке. |
Tue Jun 12 2018, 11:34 AM Z