| Pacchetto | air.desktop |
| Classe | public class URLFilePromise |
| Ereditarietà | URLFilePromise  EventDispatcher Object |
| Implementa | IFilePromise |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.0 |
La classe URLFilePromise implementa l'interfaccia IFilePromise utilizzando gli oggetti URLStream e URLRequest come origine dati. L'implementazione supporta il trascinamento per i file recuperabili tramite HTTP o gli altri protocolli supportati dalla classe URLStream.
Per creare una "promessa" di file URL:
- Costruite e inizializzate uno o più oggetti URLFilePromise.
- Aggiungete l'oggetto URLFilePromise a un array.
- Aggiungete l'array a un nuovo oggetto Clipboard utilizzando ClipboardFormat,
FILE_PROMISE_LIST. - In risposta a un'azione dell'utente, chiamate il metodo NativeDragManager
startDrag(), passando l'oggetto Clipboard che contiene l'array di "promesse" di file.
Quando l'utente completa l'operazione di trascinamento, il runtime scarica i dati per ogni "promessa" di file. Viene effettuato l'accesso ai dati in corrispondenza dell'URL specificato dalla proprietà request dell'oggetto URLFilePromise. Tali dati vengono quindi salvati nel file specificato nella proprietà relativePath. Il file viene salvato in una posizione relativa a quella di rilascio. Quindi, se il percorso relativo è foo/bar.txt e la promessa file viene rilasciata in una directory chiamata home, la posizione del file creato sarà home/foo/bar.txt. In caso di errore, il file non viene creato.
Per supportare le origini dati non accessibili tramite la classe URLStream, implementate l'interfaccia IFilePromise.
Nota: il runtime AIR chiama automaticamente i metodi IFilePromise open(), close() e reportError(). Questi metodi non dovranno mai essere chiamati dalla logica della vostra applicazione. In modo analogo, gli eventi open, progress, complete e close inviati da questo oggetto URLFilePromise vengono forniti soprattutto a scopo di debug. Non è necessario che l'applicazione risponda a questi eventi.
Questa classe è incusa nel file aircore.swc. Adobe® Flash™ Builder carica automaticamente questa classe quando create un progetto per Adobe® AIR™. L'SDK Adobe® Flex™ comprende anche questo file aircore.swc, che dovete sempre includere quando compilate l'applicazione se utilizzate l'SDK Flex.
Per utilizzare il pacchetto air.desktop in Adobe ® Flash ® Professional (CS4 o successivo):
- Selezionate il comando File > Impostazioni pubblicazione.
- Nel pannello Flash fate clic sul pulsante Impostazioni per ActionScript 3.0. Selezionate Percorso di libreria.
- Fate clic sul pulsante Specifica file SWC. Passate al file Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc nella cartella di installazione di Adobe Flash Professional.
- Fate clic sul pulsante OK.
- Aggiungete l'istruzione
importseguente al codice ActionScript 3.0:import air.desktop.*;
Altri esempi
Elementi API correlati
Classe Clipboard
Classe ClipboardFormats
Classe NativeDragManager
Classe URLStream
Classe URLRequest
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| isAsync : Boolean [sola lettura]
Indica se i dati risorsa sono disponibili in modalità asincrona. | URLFilePromise | ||
| relativePath : String
Il percorso e il nome file del file creato, relativo alla destinazione di rilascio. | URLFilePromise | ||
| request : URLRequest
URLRequest che identifica la risorsa da copiare come risultato dell'operazione di trascinamento. | URLFilePromise | ||
| Metodo | Definito da | ||
|---|---|---|---|
Crea un oggetto URLFilePromise. | URLFilePromise | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | EventDispatcher | |
Consente al runtime AIR di chiudere l'origine dati nel momento appropriato durante l'operazione di trascinamento. | URLFilePromise | ||
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
|
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
Consente al runtime AIR di aprire l'origine dati nel momento appropriato durante l'operazione di trascinamento. | URLFilePromise | ||
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
Consente al runtime AIR di segnalare gli errori che si verificano durante l'operazione di trascinamento. | URLFilePromise | ||
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
|
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher | |
| Evento | Riepilogo | Definito da | ||
|---|---|---|---|---|
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo. | EventDispatcher | ||
| Inviato quando i dati per il file sono stati completamente scaricati. | URLFilePromise | |||
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo. | EventDispatcher | ||
| Inviato affinché le richieste HTTP segnalino le intestazioni di risposta. | URLFilePromise | |||
| Inviato affinché le richieste HTTP segnalino il relativo codice di stato. | URLFilePromise | |||
| Inviato quando un evento IOError impedisce il download del file. | URLFilePromise | |||
| Inviato quando viene aperta la connessione dell'oggetto URLStream sottostante. | URLFilePromise | |||
| Inviato quando un blocco di dati è disponibile per la lettura dall'oggetto URLStream sottostante. | URLFilePromise | |||
| Inviato quando un errore di sicurezza impedisce il download del file. | URLFilePromise | |||
isAsync | proprietà |
isAsync:Boolean [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.0 |
Indica se i dati risorsa sono disponibili in modalità asincrona.
La proprietà isAsync di un oggetto URLFilePromise è sempre true poiché i flussi di URL sono intrinsecamente asincroni.
Implementazione
public function get isAsync():Boolean relativePath | proprietà |
relativePath:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.0 |
Il percorso e il nome file del file creato, relativo alla destinazione di rilascio.
Il percorso può includere delle sottodirectory, che vengono risolte in base alla posizione di rilascio. Le sottodirectory vengono create, se necessario. Se includete delle sottodirectory, utilizzate la costante File.separator per inserire il carattere separatore di percorso appropriato per il sistema operativo corrente. L'utilizzo della scorciatoia .. per spostarsi a una directory principale non è consentito.
Non è necessario che il nome file sia uguale a quello della risorsa remota.
Implementazione
public function get relativePath():String public function set relativePath(value:String):void request | proprietà |
request:URLRequest| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.0 |
URLRequest che identifica la risorsa da copiare come risultato dell'operazione di trascinamento.
Implementazione
public function get request():URLRequest public function set request(value:URLRequest):void URLFilePromise | () | Funzione di costruzione |
public function URLFilePromise()| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.0 |
Crea un oggetto URLFilePromise.
Prima di utilizzare l'oggetto URLFilePromise, dovete impostare le proprietà request e relativePath.
close | () | metodo |
public function close():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.0 |
Consente al runtime AIR di chiudere l'origine dati nel momento appropriato durante l'operazione di trascinamento.
Evitate di chiamare questa funzione nella logica della vostra applicazione.
open | () | metodo |
public function open():IDataInput| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.0 |
Consente al runtime AIR di aprire l'origine dati nel momento appropriato durante l'operazione di trascinamento.
Evitate di chiamare questa funzione nella logica della vostra applicazione.
RestituisceIDataInput |
reportError | () | metodo |
public function reportError(e:ErrorEvent):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.0 |
Consente al runtime AIR di segnalare gli errori che si verificano durante l'operazione di trascinamento.
L'oggetto URLFilePromise invia di nuovo qualsiasi evento di errore segnalato. Evitate di chiamare questa funzione nella logica della vostra applicazione.
Parametri
e:ErrorEvent |
complete | Evento |
flash.events.Eventproprietà Event.type =
flash.events.Event.COMPLETE| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.0 |
Inviato quando i dati per il file sono stati completamente scaricati.
Nota: il runtime AIR utilizza questo evento per gestire il processo asincrono di recupero dei dati. Solitamente, l'applicazione non deve eseguire alcuna azione in risposta a questo evento.
La costanteEvent.COMPLETE definisce il valore della proprietà type di un oggetto evento complete.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto di rete che ha completato il caricamento. |
httpResponseStatus | Evento |
flash.events.HTTPStatusEventproprietà HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.0 |
Inviato affinché le richieste HTTP segnalino le intestazioni di risposta.
A differenza dell'eventohttpStatus, l'evento httpResponseStatus viene inviato prima dei dati di risposta. Inoltre, l'evento httpResponseStatus include valori per le proprietà responseHeaders e responseURL (che non sono definite per un evento httpStatus). L'evento httpResponseStatus (se presente) viene inviato prima di (e in aggiunta a) qualsiasi evento complete o error.
La costante HTTPStatusEvent.HTTP_RESPONSE_STATUS definisce il valore della proprietà type di un oggetto evento httpResponseStatus.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
responseURL | L'URL da cui è stata restituita la risposta. |
responseHeaders | Le intestazioni di risposta che la risposta ha restituito, come un array di oggetti URLRequestHeader. |
status | Il codice di stato HTTP restituito dal server. |
redirected | Se la risposta è il risultato di un reindirizzamento. |
target | L'oggetto di rete che riceve un codice di stato HTTP. |
httpStatus | Evento |
flash.events.HTTPStatusEventproprietà HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_STATUS| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.0 |
Inviato affinché le richieste HTTP segnalino il relativo codice di stato.
La costanteHTTPStatusEvent.HTTP_STATUS definisce il valore della proprietà type di un oggetto evento httpStatus.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
status | Il codice di stato HTTP restituito dal server. |
target | L'oggetto di rete che riceve un codice di stato HTTP. |
ioError | Evento |
flash.events.IOErrorEventproprietà IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.0 |
Inviato quando un evento IOError impedisce il download del file.
Definisce il valore della proprietàtype di un oggetto evento ioError.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
errorID | Un numero di riferimento associato all'errore specifico (solo AIR). |
target | L'oggetto di rete interessato dall'errore di input/output. |
text | Testo da visualizzare come messaggio di errore. |
open | Evento |
flash.events.Eventproprietà Event.type =
flash.events.Event.OPEN| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.0 |
Inviato quando viene aperta la connessione dell'oggetto URLStream sottostante.
Nota: il runtime AIR utilizza questo evento per gestire il processo asincrono di recupero dei dati. Solitamente, l'applicazione non deve eseguire alcuna azione in risposta a questo evento.
La costanteEvent.OPEN definisce il valore della proprietà type di un oggetto evento open.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto di rete che ha aperto una connessione. |
progress | Evento |
flash.events.ProgressEventproprietà ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.0 |
Inviato quando un blocco di dati è disponibile per la lettura dall'oggetto URLStream sottostante.
Nota: il runtime AIR utilizza questo evento per gestire il processo asincrono di recupero dei dati. Solitamente, l'applicazione non deve eseguire alcuna azione in risposta a questo evento.
Definisce il valore della proprietàtype di un oggetto evento progress.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
bytesLoaded | Il numero di elementi o di byte caricati nel momento in cui il listener elabora l'evento. |
bytesTotal | Il numero totale di elementi o byte che vengono caricati se il processo di caricamento viene completato correttamente. |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto che riporta l'avanzamento. |
securityError | Evento |
flash.events.SecurityErrorEventproprietà SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2.0 |
Inviato quando un errore di sicurezza impedisce il download del file.
La costanteSecurityErrorEvent.SECURITY_ERROR definisce il valore della proprietà type di un oggetto evento securityError.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto di rete che riporta l'errore di sicurezza. |
text | Testo da visualizzare come messaggio di errore. |
Tue Jun 12 2018, 02:44 PM Z