| Pacote | air.desktop |
| Classe | public class URLFilePromise |
| Herança | URLFilePromise  EventDispatcher Object |
| Implementações | IFilePromise |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.0 |
A classe URLFilePromise implementa a interface IFilePromise que usa URLStream e objetos URLRequest como a fonte de dados. A implementação fornece o suporte para arrastar e soltar de arquivos que podem ser recuperados utilizando HTTP ou outros protocolos suportados pela classe URLStream.
Para criar uma promessa de arquivo URL:
- Construa e inicialize um ou mais objetos URLFilePromise.
- Adicione os objetos URLFilePromise a uma matriz.
- Adicione a matriz a um novo objeto de Área de transferência utilizando o ClipboardFormat,
FILE_PROMISE_LIST. - Em resposta a um gesto de usuário, chame o método NativeDragManager
startDrag(), passando o objeto da Área de transferência que contém a matriz de promessas de arquivo.
Quando o usuário conclui a operação de arrastar, o tempo de execução carrega os dados de cada promessa de arquivo. Os dados são acessados no URL especificado pela propriedade request do objeto URLFilePromise e salvos no arquivo especificado na propriedade relativePath. O arquivo é salvo relativamente ao local de baixa. Assim, se o caminho relativo for foo/bar.txt, e a promessa de arquivo for solta em um diretório chamado home, então o local do arquivo criado será: home/foo/bar.txt . Se ocorrer um erro, o arquivo não será criado.
Para suportar fontes de dados que não são acessíveis pela classe URLStream, implemente a interface IFilePromise.
Observação: O tempo de execução AIR chama os métodos IFilePromise, open(), close() e reportError() automaticamente. Estes métodos nunca devem ser chamados pelos seus lógicos do aplicativos. Do mesmo modo, os eventos open, progress, complete e close despachados por este objeto URLFilePromise são fornecidos principalmente para fins de depuração. O seu aplicativo não precisa responder a estes eventos.
Esta classe está incluída no arquivo aircore.swc file. O Adobe® Flash™ Builder carrega essa classe automaticamente quando você cria um projeto no Adobe® AIR™. O SDK do Adobe® Flex™ também inclui este arquivo aircore.swc, que você deverá inserir na compilação do aplicativo se estiver usando o SDK do Flex.
Para usar o pacote air.desktop no Adobe ® Flash ® Professional´(CS4 ou superior):
- Selecione o comando Arquivo > Configurações de publicação.
- No painel do Flash, clique no botão Configurações do ActionScript 3.0. Selecione Caminho da biblioteca.
- Clique no botão Procurar arquivo SWC. Navegue até o arquivo Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc na pasta de instalação do Adobe Flash Professional.
- Clique no botão OK.
- Adicione a seguinte instrução
importao código do ActionScript 3.0:import air.net.*;
Elementos da API relacionados
Classe de área de transferência
classe ClipboardFormats
Classe NativeDragManager
Classe URLStream
classe URLRequest
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
 | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| isAsync : Boolean [somente leitura]
Indica se o dado de recurso está disponível assincronamente. | URLFilePromise | ||
| relativePath : String
O caminho e nome de arquivo do arquivo criado, relacionado ao local onde foi solto. | URLFilePromise | ||
| request : URLRequest
O URLRequest que identifica o recurso a ser copiado como o resultado da operação de arrastar e soltar. | URLFilePromise | ||
| Método | Definido por | ||
|---|---|---|---|
Cria um objeto URLFilePromise. | URLFilePromise | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. | EventDispatcher | |
Permite o tempo de execução de AIR para fechar a fonte de dados no momento apropriado durante a operação de arrastar e soltar. | URLFilePromise | ||
|
Envia um evento para o fluxo de eventos. | EventDispatcher | |
|
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | |
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
Permite que o tempo de execução de AIR abra a fonte de dados no momento apropriado durante a operação de arrastar e soltar. | URLFilePromise | ||
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | |
Permite que o tempo de execução de AIR para relate erros que ocorrem durante a operação de arrastar e soltar. | URLFilePromise | ||
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
|
Retorna a representação de string do objeto especificado. | Object | |
|
Retorna o valor primitivo do objeto especificado. | Object | |
|
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | EventDispatcher | |
| Evento | Resumo | Definido por | ||
|---|---|---|---|---|
| [transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo. | EventDispatcher | ||
| Despachado quando os dados do arquivo tiverem sido totalmente carregarados. | URLFilePromise | |||
| [transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo. | EventDispatcher | ||
| Despachado para solicitações HTTP para informar os cabeçalhos de resposta. | URLFilePromise | |||
| Despachado para solicitações HTTP para informar o código de status da solicitação. | URLFilePromise | |||
| Despachado quando um IOError evita o carregamento de arquivo. | URLFilePromise | |||
| Despachado quando a conexão URLStream subjacente é aberta. | URLFilePromise | |||
| Despachado quando um bloco de dados está disponível para ser lido no URLStream subjacente. | URLFilePromise | |||
| Despachado quando um erro de segurança evita o carregamento de arquivo. | URLFilePromise | |||
isAsync | propriedade |
isAsync:Boolean [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.0 |
Indica se o dado de recurso está disponível assincronamente.
A propriedade isAsync de um objeto URLFilePrmise é sempre true desde que as correntes de URL sejam inerentemente assíncronas.
Implementação
public function get isAsync():Boolean relativePath | propriedade |
relativePath:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.0 |
O caminho e nome de arquivo do arquivo criado, relacionado ao local onde foi solto.
O caminho pode incluir subdiretórios, que são resolvidos com base no local onde foi solto. Os subdiretórios são criados, se necessário. Quando incluir subdiretórios, use a constante File.separator para inserir o caractere separador de caminho próprio do sistema operacional atual. Usar o cabeçalho .. atalho para navegar a um diretório-pai não é permitido.
O nome do arquivo não precisa corresponder ao nome de arquivo do recurso remoto.
Implementação
public function get relativePath():String public function set relativePath(value:String):void request | propriedade |
request:URLRequest| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.0 |
O URLRequest que identifica o recurso a ser copiado como o resultado da operação de arrastar e soltar.
Implementação
public function get request():URLRequest public function set request(value:URLRequest):void URLFilePromise | () | Construtor |
public function URLFilePromise()| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.0 |
Cria um objeto URLFilePromise.
Você deve estabelecer as propriedades request e relativePath antes de usar este objeto URLFilePromise.
close | () | método |
public function close():void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.0 |
Permite o tempo de execução de AIR para fechar a fonte de dados no momento apropriado durante a operação de arrastar e soltar.
Não chame esta função no seu lógico do aplicativo.
open | () | método |
public function open():IDataInput| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.0 |
Permite que o tempo de execução de AIR abra a fonte de dados no momento apropriado durante a operação de arrastar e soltar.
Não chame esta função no seu lógico do aplicativo.
RetornaIDataInput |
reportError | () | método |
public function reportError(e:ErrorEvent):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.0 |
Permite que o tempo de execução de AIR para relate erros que ocorrem durante a operação de arrastar e soltar.
O objeto URLFilePromise emite novamente qualquer evento de erro relatado. Não chame esta função no seu lógico do aplicativo.
Parâmetros
e:ErrorEvent |
complete | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.COMPLETE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.0 |
Despachado quando os dados do arquivo tiverem sido totalmente carregarados.
Observação: O tempo de execução de AIR usa este evento para gerenciar o processo de recuperação de dados assíncrono. Normalmente, não há nenhuma necessidade do seu aplicativo de tomar uma ação em resposta a este evento.
A constanteEvent.COMPLETE define o valor da propriedade type de um objeto de evento complete.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto de rede que concluiu o carregamento. |
httpResponseStatus | Evento |
flash.events.HTTPStatusEventpropriedade HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.0 |
Despachado para solicitações HTTP para informar os cabeçalhos de resposta.
Ao contrário do eventohttpStatus, o evento httpResponseStatus é entregue antes de qualquer dado de resposta. O evento httpResponseStatus inclui valores para as propriedades responseHeaders e responseURL (que estão indefinidas para um evento httpStatus. Observe que o evento httpResponseStatus (se houver) será despachado antes (e além de) qualquer evento complete ou error.
A constante HTTPStatusEvent.HTTP_RESPONSE_STATUS define o valor da propriedade type de um objeto de evento httpResponseStatus.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
responseURL | O URL do qual a resposta foi retornada. |
responseHeaders | Os cabeçalhos de resposta que a resposta retornou, como uma matriz de objetos URLRequestHeader. |
status | O código de status HTTP retornado pelo servidor. |
redirecionado | Se a resposta for o resultado de um redirecionamento. |
target | O objeto de rede que recebe o código de status HTTP. |
httpStatus | Evento |
flash.events.HTTPStatusEventpropriedade HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_STATUS| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.0 |
Despachado para solicitações HTTP para informar o código de status da solicitação.
A constanteHTTPStatusEvent.HTTP_STATUS define o valor da propriedade type de um objeto de evento httpStatus.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
status | O código de status HTTP retornado pelo servidor. |
target | O objeto de rede que recebe o código de status HTTP. |
ioError | Evento |
flash.events.IOErrorEventpropriedade IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.0 |
Despachado quando um IOError evita o carregamento de arquivo.
Define o valor da propriedadetype de um objeto de evento ioError.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
errorID | Um número de referência associado ao erro específico (somente AIR). |
target | O objeto de rede que está recebendo o erro de entrada/saída. |
text | Texto a ser exibido como uma mensagem de erro. |
open | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.OPEN| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.0 |
Despachado quando a conexão URLStream subjacente é aberta.
Observação: O tempo de execução de AIR usa este evento para gerenciar o processo de recuperação de dados assíncrono. Normalmente, não há nenhuma necessidade do seu aplicativo de tomar uma ação em resposta a este evento.
A constanteEvent.OPEN define o valor da propriedade type de um objeto de evento open.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto de rede que abriu uma conexão. |
progress | Evento |
flash.events.ProgressEventpropriedade ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.0 |
Despachado quando um bloco de dados está disponível para ser lido no URLStream subjacente.
Observação: O tempo de execução de AIR usa este evento para gerenciar o processo de recuperação de dados assíncrono. Normalmente, não há nenhuma necessidade do seu aplicativo de tomar uma ação em resposta a este evento.
Define o valor da propriedadetype de um objeto de evento progress.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
bytesLoaded | O número de itens ou bytes carregados no momento em que o ouvinte processa o evento. |
bytesTotal | O número total de itens ou bytes que serão carregados no final se o processo de carregamento tiver êxito. |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto que está informando o andamento. |
securityError | Evento |
flash.events.SecurityErrorEventpropriedade SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2.0 |
Despachado quando um erro de segurança evita o carregamento de arquivo.
A constanteSecurityErrorEvent.SECURITY_ERROR define o valor da propriedade type de um objeto de evento securityError.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto de rede que reporta o erro de segurança. |
text | Texto a ser exibido como uma mensagem de erro. |
Wed Jun 13 2018, 11:10 AM Z