URLFilePromise

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 permite que recursos acessíveis em um URL sejam arrastados para fora de um aplicativo de AIR como uma promessa de arquivo.

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 import ao código do ActionScript 3.0: import air.net.*;

Elementos da API relacionados

Interface IFilePromise
Classe de área de transferência
classe ClipboardFormats
Classe NativeDragManager
Classe URLStream
classe URLRequest

Propriedades públicas

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étodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		URLFilePromise() 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
		close():void 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
		dispatchEvent(event:Event):Boolean Envia um evento para o fluxo de eventos.	EventDispatcher
		hasEventListener(type:String):Boolean Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade especificada definida.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.	Object
		open():IDataInput 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
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Remove um ouvinte do objeto EventDispatcher.	EventDispatcher
		reportError(e:ErrorEvent):void Permite que o tempo de execução de AIR para relate erros que ocorrem durante a operação de arrastar e soltar.	URLFilePromise
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Define a disponibilidade de uma propriedade dinâmica para operações de repetição.	Object
		toLocaleString():String Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.	Object
		toString():String Retorna a representação de string do objeto especificado.	Object
		valueOf():Object Retorna o valor primitivo do objeto especificado.	Object
		willTrigger(type:String):Boolean 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

Eventos

Clique para obter mais informações sobre eventos

Ocultar eventos herdados

Mostrar eventos herdados

	Resumo	Definido por
activate	[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
complete	Despachado quando os dados do arquivo tiverem sido totalmente carregarados.	URLFilePromise
deactivate	[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
httpResponseStatus	Despachado para solicitações HTTP para informar os cabeçalhos de resposta.	URLFilePromise
httpStatus	Despachado para solicitações HTTP para informar o código de status da solicitação.	URLFilePromise
ioError	Despachado quando um IOError evita o carregamento de arquivo.	URLFilePromise
open	Despachado quando a conexão URLStream subjacente é aberta.	URLFilePromise
progress	Despachado quando um bloco de dados está disponível para ser lido no URLStream subjacente.	URLFilePromise
securityError	Despachado quando um erro de segurança evita o carregamento de arquivo.	URLFilePromise

Detalhes da propriedade

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

Detalhes do construtor

()

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.

Detalhes do método

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.

Retorna

IDataInput

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

Detalhe do evento

complete

Evento

Tipo do objeto de evento: flash.events.Event
propriedade 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 constante Event.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

Tipo do objeto de evento: flash.events.HTTPStatusEvent
propriedade 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 evento httpStatus, 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

Tipo do objeto de evento: flash.events.HTTPStatusEvent
propriedade 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 constante HTTPStatusEvent.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

Tipo do objeto de evento: flash.events.IOErrorEvent
propriedade 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 propriedade type 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

Tipo do objeto de evento: flash.events.Event
propriedade 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.

A constante Event.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

Tipo do objeto de evento: flash.events.ProgressEvent
propriedade 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.

Define o valor da propriedade type 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

Tipo do objeto de evento: flash.events.SecurityErrorEvent
propriedade 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 constante SecurityErrorEvent.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.

Aspectos jurídicos | Política de privacidade on-line

URLFilePromise - AS3

Pacotesx

Elementos de linguagem

Apêndices

Pacote air.desktop

isAsync

relativePath

request

URLFilePromise

close

open

reportError

complete

httpResponseStatus

httpStatus

ioError

open

progress

securityError