Pakket | flash.net |
Klasse | public class FileReferenceList |
Overerving | FileReferenceList EventDispatcher Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
U kunt als volgt met de klasse FileReferenceList werken:
- Instantieer de klasse:
var myFileRef = new FileReferenceList();
- Roep de methode
FileReferenceList.browse()
aan, waarmee een dialoogvenster wordt geopend waarin de gebruiker een of meer bestanden kan selecteren om te uploaden:myFileRef.browse();
- Wanneer de methode
browse()
is aangeroepen, wordt de eigenschapfileList
van het object FileReferenceList met een array van objecten FileReference gevuld. - Roep
FileReference.upload()
aan op elk element in de arrayfileList
.
De klasse FileReferenceList bevat een methode browse()
en een eigenschap fileList
om met meerdere bestanden te werken. Terwijl een aanroep naar FileReferenceList.browse()
wordt uitgevoerd, wordt het afspelen van SWF-bestanden gepauzeerd in zelfstandige en externe versies van Flash Player en in AIR voor Linux en Mac OS X 10.1 en lager.
Verwante API-elementen
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
fileList : Array [alleen-lezen]
Array van objecten FileReference. | FileReferenceList |
Methode | Gedefinieerd door | ||
---|---|---|---|
Maakt een nieuw object FileReferenceList. | FileReferenceList | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. | EventDispatcher | ||
Geeft een bladerdialoogvenster weer waarin de gebruiker een of meer lokale bestanden kan selecteren om te uploaden. | FileReferenceList | ||
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | ||
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | ||
Retourneert de primitieve waarde van het opgegeven object. | Object | ||
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher |
Gebeurtenis | Overzicht | Gedefinieerd door | ||
---|---|---|---|---|
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt. | EventDispatcher | |||
Wordt verzonden wanneer de gebruiker het bladerdialoogvenster sluit zonder een bestand te kiezen. | FileReferenceList | |||
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt. | EventDispatcher | |||
Wordt verzonden wanneer de gebruiker in het bladerdialoogvenster een of meer bestanden selecteert om te uploaden. | FileReferenceList |
fileList | eigenschap |
fileList:Array
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Een array van objecten FileReference
.
Wanneer de methode FileReferenceList.browse()
is aangeroepen en de gebruiker een of meer bestanden heeft geselecteerd in het dialoogvenster dat is geopend door de methode browse()
, wordt deze eigenschap gevuld met een array van objecten FileReference die elk de bestanden vertegenwoordigen die de gebruiker heeft geselecteerd. U kunt deze array vervolgens gebruiken om elk bestand te uploaden met de methode FileReference.upload()
. U moet één bestand tegelijk uploaden.
Telkens wanneer browse() wordt aangeroepen op dat object FileReferenceList, wordt de eigenschap fileList
opnieuw gevuld.
De eigenschappen van objecten FileReference
worden beschreven in de documentatie van de klasse FileReference.
Implementatie
public function get fileList():Array
Verwante API-elementen
FileReferenceList | () | Constructor |
public function FileReferenceList()
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Maakt een nieuw object FileReferenceList. Een object FileReferenceList bevat niets voordat u de methode browse()
aanroept en de gebruiker een of meer bestanden selecteert. Wanneer u browse()
aanroept op het object FileReference, wordt de eigenschap fileList
van het object gevuld met een array van objecten FileReference
.
Verwante API-elementen
browse | () | methode |
public function browse(typeFilter:Array = null):Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Geeft een bladerdialoogvenster weer waarin de gebruiker een of meer lokale bestanden kan selecteren om te uploaden. Het dialoogvenster behoort tot het besturingssysteem van de gebruiker.
In Flash Player 10 en hoger kunt u deze methode alleen gebruiken in reactie op een gebruikersgebeurtenis (bijvoorbeeld in een gebeurtenishandler voor een muisklik of een toetsaanslag). Als u deze methode op een ander moment aanroept, treedt er een fout op in Flash Player.
Wanneer u deze methode aanroept en de gebruiker bestanden selecteert, wordt de eigenschap fileList
van dit object FileReferenceList gevuld met een array van objecten FileReference, één voor elk bestand dat de gebruiker selecteert. Telkens wanneer de methode FileReferenceList.browse() wordt aangeroepen, wordt de eigenschap FileReferenceList.fileList
teruggezet naar het bestand of de bestanden die de gebruiker in het dialoogvenster selecteert.
Met de parameter typeFilter
kunt u bepalen welke bestanden in het dialoogvenster worden weergegeven.
Er kan slechts een sessie FileReference.browse()
, FileReference.download()
of FileReferenceList.browse()
tegelijk worden uitgevoerd op een object FileReferenceList (aangezien slechts een dialoogvenster tegelijk kan zijn geopend).
Parameters
typeFilter:Array (default = null ) — Een array van instanties FileFilter die wordt gebruikt om de bestanden te filteren die in het dialoogvenster worden weergegeven. Wanneer u deze parameter weglaat, worden alle bestanden weergegeven. Zie de klasse FileFilter voor meer informatie.
|
Boolean — Retourneert true wanneer de parameters geldig zijn en het bladerdialoogvenster wordt geopend.
|
Gebeurtenissen
select: — Wordt aangeroepen wanneer de gebruiker in het dialoogvenster een item heeft geselecteerd om te uploaden.
| |
cancel: — Wordt aangeroepen wanneer de gebruiker het dialoogvenster verlaat door te klikken op Annuleren of door het te sluiten.
|
Gegenereerde uitzondering
IllegalOperationError — Wordt gegenereerd door de volgende oorzaken: 1) Een andere bladersessie van FileReference of FileReferenceList wordt uitgevoerd. Er kan slechts een enkele bladersessie tegelijk worden uitgevoerd. 2) Een instelling in het bestand mms.cfg van de gebruiker staat deze bewerking niet toe.
| |
ArgumentError — Wanneer de array typeFilter geen juist ingedeelde objecten FileFilter bevat, wordt een uitzondering gegenereerd. Zie de documentatie over FileFilter voor meer informatie over de juiste indeling van filters.
| |
Error — Als de methode niet wordt aangeroepen in reactie op een gebruikersactie, zoals het klikken met de muis of het indrukken van een toets.
|
Verwante API-elementen
cancel | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.CANCEL
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Wordt verzonden wanneer de gebruiker het bladerdialoogvenster sluit zonder een bestand te kiezen. (Dit dialoogvenster wordt geopend wanneer u de methode FileReferenceList.browse()
, FileReference.browse()
of FileReference.download()
aanroept.)
Event.CANCEL
definieert de waarde van de eigenschap type
van een cancel
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Een verwijzing naar het object waarop de handeling wordt geannuleerd. |
Verwante API-elementen
select | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.SELECT
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Wordt verzonden wanneer de gebruiker in het bladerdialoogvenster een of meer bestanden selecteert om te uploaden. (Dit dialoogvenster wordt geopend wanneer u de methode FileReferenceList.browse()
, FileReference.browse()
of FileReference.download()
aanroept.) Wanneer de gebruiker een bestand selecteert en de handeling bevestigt (door bijvoorbeeld op Opslaan te klikken), wordt het object FileReferenceList
gevuld met objecten FileReference die de bestanden vertegenwoordigen die de gebruiker selecteert.
Event.SELECT
definieert de waarde van de eigenschap type
van een select
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het object waarop een item is geselecteerd. |
Verwante API-elementen
complete
die wordt verzonden wanneer elk afzonderlijk bestand in het object FileReferenceList is geüpload. De gebeurtenis LIST_COMPLETE
in de klasse FileReferenceListExample wordt verzonden wanneer alle bestanden in het object FileReferenceList zijn geüpload.
Wanneer u dit voorbeeld wilt uitvoeren, plaatst u een script dat is geschreven om het uploaden van een bestand te accepteren op http://www.[yourDomain].com/yourUploadHandlerScript.cfm. Op basis van de locatie van uw SWF-bestand en waar u de bestanden uploadt, moet u mogelijk ook het SWF-bestand compileren met Lokale afspeelbeveiliging ingesteld op Alleen lokale bestanden benaderen, of beveiligingsinstellingen in Flash ® Player bijwerken zodat dit bestand toegang tot het netwerk krijgt. Wanneer u een externe uploadserver hebt en u voert dit voorbeeld uit vanaf uw computer, moet de server een bestand crossdomain.xml hebben.
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()); } }
Wed Jun 13 2018, 11:42 AM Z