Package | flash.net |
Classe | public class FileReferenceList |
Héritage | FileReferenceList EventDispatcher Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Pour utiliser la classe FileReferenceList :
- Instanciez la classe :
var myFileRef = new FileReferenceList();
- Appelez la méthode
FileReferenceList.browse()
, pour afficher une boîte de dialogue dans laquelle l’utilisateur peut choisir un ou plusieurs fichiers à charger :myFileRef.browse();
- Après l’appel de la méthode
browse()
, la propriétéfileList
de l’objet FileReferenceList est renseignée à l’aide d’un tableau d’objets FileReference. - Appelez
FileReference.upload()
sur chaque élément du tableaufileList
.
La classe FileReferenceList comprend une méthode browse()
et une propriété fileList
pour travailler avec plusieurs fichiers. Lors de l’exécution d’un appel à la méthode FileReferenceList.browse()
, la lecture du fichier SWF s’interrompt dans les versions autonomes et externes de Flash Player et AIR pour Linux, et Mac OS X version 10.1 et antérieures.
Eléments de l’API associés
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 | ||
fileList : Array [lecture seule]
Un tableau d’objets FileReference. | FileReferenceList |
Méthode | Défini par | ||
---|---|---|---|
Crée un nouvel objet FileReferenceList. | FileReferenceList | ||
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 | ||
Affiche une boîte de dialogue de recherche de fichiers dans laquelle l’utilisateur peut sélectionner un ou plusieurs fichiers locaux à charger. | FileReferenceList | ||
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 | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | ||
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 l’utilisateur ferme la boîte de dialogue de recherche de fichiers. | FileReferenceList | |||
[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é lorsque l’utilisateur sélectionne un ou plusieurs fichiers à charger dans la boîte de dialogue de recherche de fichiers. | FileReferenceList |
fileList | propriété |
fileList:Array
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Tableau d’objets FileReference
.
Quand la méthode FileReferenceList.browse()
est appelée et que l’utilisateur a sélectionné un ou plusieurs fichiers dans la boîte de dialogue ouverte par la méthode browse()
, cette propriété est renseignée par un tableau d’objets FileReference qui représentent les fichiers que l’utilisateur a sélectionnés. Vous pouvez ensuite utiliser ce tableau pour charger les fichiers par le biais de la méthode FileReference.upload()
. Vous devez charger les fichiers un par un.
La propriété fileList
est renseignée à nouveau à chaque appel de la méthode browse() sur cet objet FileReferenceList.
Les propriétés des objets FileReference
sont décrites dans la documentation relative à la classe FileReference.
Implémentation
public function get fileList():Array
Informations complémentaires
Eléments de l’API associés
FileReferenceList | () | Constructeur |
public function FileReferenceList()
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Crée un nouvel objet FileReferenceList. Tout objet FileReferenceList reste vide tant que vous n’avez pas appelé pour lui la méthode browse()
et que l’utilisateur n’a pas sélectionné de fichiers. Quand vous appelez browse()
sur l’objet FileReference, sa propriété fileList
est renseignée par un tableau d’objets FileReference
.
Eléments de l’API associés
browse | () | méthode |
public function browse(typeFilter:Array = null):Boolean
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Affiche une boîte de dialogue de recherche de fichiers dans laquelle l’utilisateur peut sélectionner un ou plusieurs fichiers locaux à charger. La boîte de dialogue est spécifique au système d’exploitation de l’utilisateur.
Dans Flash Player versions 10 et ultérieures, l’appel de cette méthode aboutit uniquement en réponse à un événement utilisateur (par exemple, un événement de type clic de souris ou pression de touche). Dans les autres cas, Flash Player renvoie une erreur à l’appel de cette méthode.
Lorsque vous appelez cette méthode et que l’utilisateur réussit à sélectionner des fichiers, la propriété fileList
de cet objet FileReferenceList est renseignée par un tableau d’objets FileReference, à raison d’un objet pour chaque fichier sélectionné par l’utilisateur. Par la suite, à chaque appel de la méthode FileReferenceList.browse(), la propriété FileReferenceList.fileList
est réinitialisée en fonction des fichiers sélectionnés par l’utilisateur dans la boîte de dialogue.
Le paramètre typeFilter
vous permet de déterminer les fichiers répertoriés dans la boîte de dialogue.
Une seule session FileReference.browse()
, FileReference.download()
ou FileReferenceList.browse()
peut être effectuée à la fois sur un objet FileReferenceList (car une seule boîte de dialogue peut être ouverte à la fois).
Paramètres
typeFilter:Array (default = null ) — Tableau d’occurrences de FileFilter utilisé pour filtrer les fichiers qui s’affichent dans la boîte de dialogue. Si vous omettez ce paramètre, tous les fichiers s’affichent. Pour plus d’informations, voir la classe FileFilter.
|
Boolean — Renvoie true si les paramètres sont valides et que la boîte de dialogue de recherche de fichiers est ouverte.
|
Evénements
select: — Appelé quand l’utilisateur réussit à sélectionner un élément à charger dans la boîte de dialogue.
| |
cancel: — Appelé quand l’utilisateur quitte la boîte de dialogue en cliquant sur Annuler ou en la fermant.
|
Valeur émise
IllegalOperationError — Renvoyé dans les cas suivants : 1) Une autre session browse FileReference ou FileReferenceList est en cours. Il est impossible d’exécuter plusieurs sessions de recherche de fichiers simultanément. 2) Un paramètre du fichier mms.cfg de l’utilisateur bloque cette opération.
| |
ArgumentError — Une exception est renvoyée si le tableau typeFilter contient des objets FileFilter incorrectement formatés. Pour plus d’informations sur le formatage correct des filtres, voir la documentation FileFilter.
| |
Error — Si la méthode n’est pas appelée en réponse à l’action d’un utilisateur, notamment à un événement de type souris ou pression de touche.
|
Informations complémentaires
Eléments de l’API associés
cancel | Evénement |
flash.events.Event
propriété Event.type =
flash.events.Event.CANCEL
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Distribué lorsque l’utilisateur ferme la boîte de dialogue de recherche de fichiers (cette boîte de dialogue s’ouvre quand vous appelez la méthode FileReferenceList.browse()
, FileReference.browse()
ou FileReference.download()
).
Event.CANCEL
définit la valeur de la propriété type
d’un objet événement cancel
.
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 | Référence à l’objet pour lequel l’opération est annulée. |
Eléments de l’API associés
select | Evénement |
flash.events.Event
propriété Event.type =
flash.events.Event.SELECT
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Distribué lorsque l’utilisateur sélectionne un ou plusieurs fichiers à charger dans la boîte de dialogue de recherche de fichiers (cette boîte de dialogue s’ouvre quand vous appelez la méthode FileReferenceList.browse()
, FileReference.browse()
ou FileReference.download()
). Lorsque l’utilisateur sélectionne un fichier et confirme l’opération (par exemple, en cliquant sur Enregistrer), l’objet FileReferenceList
est renseigné par les objets FileReference représentant les fichiers sélectionnés par l’utilisateur.
Event.SELECT
définit la valeur de la propriété type
d’un objet événement select
.
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 sur lequel un élément a été sélectionné. |
Eléments de l’API associés
complete
, distribué au chargement de chaque fichier que contient l’objet FileReferenceList. L’événement LIST_COMPLETE
de la classe FileReferenceListExample est distribué après le chargement de tous les fichiers de l’objet FileReferenceList.
Pour exécuter cet exemple, placez un script conçu pour accepter un chargement de fichiers à l’adresse http://www.[yourDomain].com/yourUploadHandlerScript.cfm. Selon l’emplacement de votre fichier SWF et la destination des fichiers à charger, vous aurez peut-être besoin de compiler le fichier SWF avec l’option Protection de lecture locale définie sur Accéder au réseau seulement ou de mettre à jour vos paramètres de sécurité Flash® Player pour autoriser ce fichier à accéder au réseau. Si le serveur de chargement est distant et que vous exécutez cet exemple depuis votre ordinateur de bureau, assurez-vous que le serveur contienne un fichier crossdomain.xml.
package { import flash.display.Sprite; import flash.events.*; import flash.net.FileReference; import flash.net.FileReferenceList; public class FileReferenceListExample extends Sprite { public static var LIST_COMPLETE:String = "listComplete"; public function FileReferenceListExample() { initiateFileUpload(); } private function initiateFileUpload():void { var fileRef:CustomFileReferenceList = new CustomFileReferenceList(); fileRef.addEventListener(FileReferenceListExample.LIST_COMPLETE, listCompleteHandler); fileRef.browse(fileRef.getTypes()); } private function listCompleteHandler(event:Event):void { trace("listCompleteHandler"); } } } import flash.events.*; import flash.net.FileReference; import flash.net.FileReferenceList; import flash.net.FileFilter; import flash.net.URLRequest; class CustomFileReferenceList extends FileReferenceList { private var uploadURL:URLRequest; private var pendingFiles:Array; public function CustomFileReferenceList() { uploadURL = new URLRequest(); uploadURL.url = "http://www.[yourDomain].com/yourUploadHandlerScript.cfm"; initializeListListeners(); } private function initializeListListeners():void { addEventListener(Event.SELECT, selectHandler); addEventListener(Event.CANCEL, cancelHandler); } public function getTypes():Array { var allTypes:Array = new Array(); allTypes.push(getImageTypeFilter()); allTypes.push(getTextTypeFilter()); return allTypes; } private function getImageTypeFilter():FileFilter { return new FileFilter("Images (*.jpg, *.jpeg, *.gif, *.png)", "*.jpg;*.jpeg;*.gif;*.png"); } private function getTextTypeFilter():FileFilter { return new FileFilter("Text Files (*.txt, *.rtf)", "*.txt;*.rtf"); } private function doOnComplete():void { var event:Event = new Event(FileReferenceListExample.LIST_COMPLETE); dispatchEvent(event); } private function addPendingFile(file:FileReference):void { trace("addPendingFile: name=" + file.name); pendingFiles.push(file); file.addEventListener(Event.OPEN, openHandler); file.addEventListener(Event.COMPLETE, completeHandler); file.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler); file.addEventListener(ProgressEvent.PROGRESS, progressHandler); file.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); file.upload(uploadURL); } private function removePendingFile(file:FileReference):void { for (var i:uint; i < pendingFiles.length; i++) { if (pendingFiles[i].name == file.name) { pendingFiles.splice(i, 1); if (pendingFiles.length == 0) { doOnComplete(); } return; } } } private function selectHandler(event:Event):void { trace("selectHandler: " + fileList.length + " files"); pendingFiles = new Array(); var file:FileReference; for (var i:uint = 0; i < fileList.length; i++) { file = FileReference(fileList[i]); addPendingFile(file); } } private function cancelHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("cancelHandler: name=" + file.name); } private function openHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("openHandler: name=" + file.name); } private function progressHandler(event:ProgressEvent):void { var file:FileReference = FileReference(event.target); trace("progressHandler: name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal); } private function completeHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("completeHandler: name=" + file.name); removePendingFile(file); } private function httpErrorHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("httpErrorHandler: name=" + file.name); } private function ioErrorHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("ioErrorHandler: name=" + file.name); } private function securityErrorHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("securityErrorHandler: name=" + file.name + " event=" + event.toString()); } }
Tue Jun 12 2018, 09:30 AM Z