| Package | air.desktop |
| Classe | public class URLFilePromise |
| Héritage | URLFilePromise  EventDispatcher Object |
| Implémente | IFilePromise |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.0 |
La classe URLFilePromise implémente l’interface IFilePromise à l’aide des objets URLStream et URLRequest comme source de données. L’implémentation permet le glisser-déposer de fichiers pouvant être récupérés à l’aide du protocole HTTP ou d’autres protocoles pris en charge par la classe URLStream.
Pour créer un fichier promis de type URL :
- Créez et initialisez un ou plusieurs objets URLFilePromise.
- Ajoutez les objets URLFilePromise à un tableau.
- Ajoutez le tableau à un nouvel objet Clipboard à l’aide du format ClipboardFormat
FILE_PROMISE_LIST. - En réponse à une action de l’utilisateur, appelez la méthode
startDrag()de la classe NativeDragManager en transmettant l’objet Clipboard contenant le tableau de fichiers promis.
Lorsque l’utilisateur termine l’opération de glissement, le moteur d’exécution télécharge les données de chaque fichier promis. Les données sont accessibles à partir de l’URL spécifiée par la propriété request de l’objet URLFilePromise ; il est alors possible de les enregistrer dans le fichier spécifié dans la propriété relativePath. Le fichier est enregistré par rapport à l’emplacement du dépôt. Ainsi, si le chemin relatif est foo/bar.txt et un fichier promis est déposé dans un répertoire appelé home, l’emplacement du fichier créé est : home/foo/bar.txt. Lorsqu’une erreur se produit, le fichier n’est pas créé.
Pour une prise en charge des sources de données qui ne sont pas accessibles par le biais de la classe URLStream, implémentez l’interface IFilePromise.
Remarque : le moteur d’exécution d’AIR appelle automatiquement les méthodes open(), close() et reportError() de l’objet IFilePromise. Ces méthodes ne doivent jamais être appelées par la logique de votre application. De même, les événements open, progress, complete et close distribués par cet objet URLFilePromise sont fournis principalement à des fins de débogage. Il n’est pas nécessaire que votre application réponde à ces événements.
Cette classe est incluse dans le fichier aircore.swc. Adobe® Flash™ Builder charge cette classe automatiquement lors de la création d’un projet pour Adobe® AIR™. Le kit de développement d’Adobe® Flex™ comprend également le fichier aircore.swc, que vous devez inclure lors de la compilation de l’application.
Pour utiliser le package air.desktop dans Adobe® Flash® Professional (CS4 ou version ultérieure) :
- Sélectionnez la commande Fichier > Paramètres de publication.
- Dans le panneau Flash, cliquez sur le bouton Paramètres pour ActionScript 3.0, puis sélectionnez Chemin de la bibliothèque.
- Cliquez sur le bouton Localiser le fichier SWC. Recherchez le fichier Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc dans le dossier d’installation d’Adobe Flash Professional.
- Cliquez sur le bouton OK.
- Ajoutez l’instruction
importsuivante à votre code ActionScript 3.0 :import air.desktop.*;
Plus d’exemples
Eléments de l’API associés
Classe Clipboard
Classe ClipboardFormats
Classe NativeDragManager
Classe URLStream
Classe URLRequest
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| isAsync : Boolean [lecture seule]
Indique si les données de ressources sont disponibles de manière asynchrone. | URLFilePromise | ||
| relativePath : String
Chemin et nom de fichier du fichier créé par rapport à la cible du dépôt. | URLFilePromise | ||
| request : URLRequest
L’objet URLRequest identifiant la ressource à copier suite à une opération de glisser-déposer. | URLFilePromise | ||
| Méthode | Défini par | ||
|---|---|---|---|
Crée un objet URLFilePromise. | URLFilePromise | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | |
Permet au moteur d’exécution d’AIR de fermer la source de données à l’heure indiquée pendant l’opération de glisser-déposer. | URLFilePromise | ||
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
Permet au moteur d’exécution d’AIR d’ouvrir la source de données à l’heure indiquée pendant l’opération de glisser-déposer. | URLFilePromise | ||
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
Permet au moteur d’exécution d’AIR de signaler les erreurs qui se produisent pendant l’opération de glisser-déposer. | URLFilePromise | ||
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher | |
| Evénement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| Distribué lorsque les données du fichier ont été intégralement téléchargées. | URLFilePromise | |||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
| Distribué afin que les requêtes HTTP renvoient les en-têtes de réponse. | URLFilePromise | |||
| Distribué afin que les requêtes HTTP renvoient le code d’état des requêtes. | URLFilePromise | |||
| Distribué lorsqu’une erreur IOError empêche le téléchargement du fichier. | URLFilePromise | |||
| Distribué lorsque la connexion sous-jacente de l’objet URLStream est ouverte. | URLFilePromise | |||
| Distribué lorsque la lecture d’un bloc de données est disponible depuis l’URLStream sous-jacent. | URLFilePromise | |||
| Distribué lorsqu’une erreur de sécurité empêche le téléchargement du fichier. | URLFilePromise | |||
isAsync | propriété |
isAsync:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.0 |
Indique si les données de ressources sont disponibles de manière asynchrone.
La propriété isAsync d’un objet URLFilePromise est toujours true, car les flux d’URL sont par nature asynchrones.
Implémentation
public function get isAsync():Boolean relativePath | propriété |
relativePath:String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.0 |
Chemin et nom de fichier du fichier créé par rapport à la cible du dépôt.
Le chemin peut inclure des sous-répertoires, qui sont résolus en fonction de l’emplacement du dépôt. Des sous-répertoires sont créés, le cas échéant. Lorsque vous incluez des sous-répertoires, utilisez la constante File.separator pour insérer le caractère de séparation du chemin correspondant au système d’exploitation actuel. L’utilisation du raccourci .. pour rechercher un répertoire parent n’est pas autorisé.
Il n’est pas nécessaire que le nom du fichier soit identique au nom de fichier de la ressource distante.
Implémentation
public function get relativePath():String public function set relativePath(value:String):void request | propriété |
request:URLRequest| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.0 |
L’objet URLRequest identifiant la ressource à copier suite à une opération de glisser-déposer.
Implémentation
public function get request():URLRequest public function set request(value:URLRequest):void URLFilePromise | () | Constructeur |
public function URLFilePromise()| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.0 |
Crée un objet URLFilePromise.
Vous devez définir les propriétés request et relativePath avant d’utiliser cet objet URLFilePromise.
close | () | méthode |
public function close():void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.0 |
Permet au moteur d’exécution d’AIR de fermer la source de données à l’heure indiquée pendant l’opération de glisser-déposer.
N’appelez pas cette fonction dans la logique de votre application.
open | () | méthode |
public function open():IDataInput| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.0 |
Permet au moteur d’exécution d’AIR d’ouvrir la source de données à l’heure indiquée pendant l’opération de glisser-déposer.
N’appelez pas cette fonction dans la logique de votre application.
Valeur renvoyéeIDataInput |
reportError | () | méthode |
public function reportError(e:ErrorEvent):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.0 |
Permet au moteur d’exécution d’AIR de signaler les erreurs qui se produisent pendant l’opération de glisser-déposer.
L’objet URLFilePromise redistribue tous les événements d’erreur signalés. N’appelez pas cette fonction dans la logique de votre application.
Paramètres
e:ErrorEvent |
complete | Evénement |
flash.events.Eventpropriété Event.type =
flash.events.Event.COMPLETE| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.0 |
Distribué lorsque les données du fichier ont été intégralement téléchargées.
Remarque : le moteur d’exécution d’AIR a recours à cet événement pour gérer le processus de récupération des données asynchrones. En règle générale, il n’est pas nécessaire que votre application réponde à cet événement.
La constanteEvent.COMPLETE définit la valeur de la propriété type d’un objet événement complete.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet réseau dont le chargement est terminé. |
httpResponseStatus | Evénement |
flash.events.HTTPStatusEventpropriété HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.0 |
Distribué afin que les requêtes HTTP renvoient les en-têtes de réponse.
Contrairement à l’événementhttpStatus, l’événement httpResponseStatus est renvoyé avant toute donnée de réponse. De plus, l’événement httpResponseStatus inclut des valeurs pour les propriétés responseHeaders et responseURL (qui ne sont pas définies pour un événement httpStatus. Notez que httpResponseStatus (le cas échéant) est envoyé avant (et en complément de) tout événement complete ou error.
La constante HTTPStatusEvent.HTTP_RESPONSE_STATUS définit la valeur de la propriété type d’un objet événement httpResponseStatus.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
responseURL | L’URL de laquelle la réponse a été renvoyée. |
responseHeaders | Les en-têtes de réponse que la réponse a renvoyés, sous la forme d’un tableau d’objets URLRequestHeader. |
status | Le code d’état HTTP renvoyé par le serveur. |
redirected | Indique si la réponse est le résultat d’une redirection. |
target | L’objet réseau recevant un code d’état HTTP. |
httpStatus | Evénement |
flash.events.HTTPStatusEventpropriété HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_STATUS| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.0 |
Distribué afin que les requêtes HTTP renvoient le code d’état des requêtes.
La constanteHTTPStatusEvent.HTTP_STATUS définit la valeur de la propriété type d’un objet événement httpStatus.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
status | Le code d’état HTTP renvoyé par le serveur. |
target | L’objet réseau recevant un code d’état HTTP. |
ioError | Evénement |
flash.events.IOErrorEventpropriété IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.0 |
Distribué lorsqu’une erreur IOError empêche le téléchargement du fichier.
Définit la valeur de la propriététype d’un objet d’événement ioError.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
errorID | Un numéro de référence associé à l’erreur spécifique (AIR uniquement). |
target | Objet réseau sur lequel l’erreur d’entrée/sortie s’est produite. |
text | Texte à afficher en tant que message d’erreur. |
open | Evénement |
flash.events.Eventpropriété Event.type =
flash.events.Event.OPEN| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.0 |
Distribué lorsque la connexion sous-jacente de l’objet URLStream est ouverte.
Remarque : le moteur d’exécution d’AIR a recours à cet événement pour gérer le processus de récupération des données asynchrones. En règle générale, il n’est pas nécessaire que votre application réponde à cet événement.
La constanteEvent.OPEN définit la valeur de la propriété type d’un objet événement open.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet réseau qui a ouvert une connexion. |
progress | Evénement |
flash.events.ProgressEventpropriété ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.0 |
Distribué lorsque la lecture d’un bloc de données est disponible depuis l’URLStream sous-jacent.
Remarque : le moteur d’exécution d’AIR a recours à cet événement pour gérer le processus de récupération des données asynchrones. En règle générale, il n’est pas nécessaire que votre application réponde à cet événement.
Définit la valeur de la propriététype d’un objet événement progress.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
bytesLoaded | Nombre d’éléments ou d’octets chargés lors du traitement de l’événement par l’écouteur. |
bytesTotal | Nombre total d’éléments ou d’octets qui seront chargés si le processus de chargement aboutit. |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet indiquant la progression. |
securityError | Evénement |
flash.events.SecurityErrorEventpropriété SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 2.0 |
Distribué lorsqu’une erreur de sécurité empêche le téléchargement du fichier.
La constanteSecurityErrorEvent.SECURITY_ERROR définit la valeur de la propriété type d’un objet événement securityError.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet réseau signalant l’erreur de sécurité |
text | Texte à afficher en tant que message d’erreur. |
Tue Jun 12 2018, 09:30 AM Z