| Paket | flash.net |
| Klasse | public class FileReferenceList |
| Vererbung | FileReferenceList EventDispatcher Object |
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
So arbeiten Sie mit der FileReferenceList-Klasse:
var myFileRef = new FileReferenceList();FileReferenceList.browse() auf. Dadurch wird ein Dialogfeld geöffnet, in dem der Benutzer eine oder mehrere Dateien für den Upload-Vorgang auswählen kann: myFileRef.browse();browse() wird die Eigenschaft fileList des FileReferenceList-Objekts mit den Daten eines Arrays von FileReference-Objekten aktualisiert.fileList-Arrays FileReference.upload() auf.Zur FileReferenceList-Klasse gehören auch eine browse()-Methode und eine fileList-Eigenschaft für das Arbeiten mit mehreren Dateien. Während ein Aufruf der Methode FileReferenceList.browse() ausgeführt wird, wird die Wiedergabe von SWF-Dateien in Standalone- und externen Playern für Linux sowie Mac OS X 10.1 und ältere Versionen angehalten.
Siehe auch
| Eigenschaft | Definiert von | ||
|---|---|---|---|
![]() | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
| Object | |
| fileList : Array
[read-only] Ein Array von FileReference-Objekten.
| FileReferenceList | ||
![]() | prototype : Object
[static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
| Object | |
| Methode | Definiert von | ||
|---|---|---|---|
|
Erstellt ein neues FileReferenceList-Objekt.
| FileReferenceList | ||
![]() |
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
| EventDispatcher | |
|
Zeigt ein Dialogfeld zum Suchen von Dateien an, in dem der Benutzer eine oder mehrere lokal gespeicherte Dateien für einen Upload-Vorgang auswählen kann.
| FileReferenceList | ||
![]() |
Sendet ein Ereignis in den Ereignisablauf.
| EventDispatcher | |
![]() |
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
| EventDispatcher | |
![]() |
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
| Object | |
![]() |
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
| Object | |
![]() |
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
| Object | |
![]() |
Entfernt einen Listener aus dem EventDispatcher-Objekt.
| EventDispatcher | |
![]() |
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
| Object | |
![]() |
Gibt das angegebene Objekt als String zurück.
| Object | |
![]() |
Gibt den Grundwert des angegebenen Objekts zurück.
| Object | |
![]() |
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner vorangegangenen Elementen ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
| EventDispatcher | |
| Ereignis | Übersicht | Definiert von | ||
|---|---|---|---|---|
![]() | Wird ausgelöst, wenn Flash Player den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | ||
| Wird ausgelöst, wenn der Benutzer das Dialogfeld zum Suchen von Dateien abbricht. | FileReferenceList | |||
![]() | Wird ausgelöst, wenn Flash Player den Betriebssystemfokus verliert und inaktiv wird. | EventDispatcher | ||
| Wird ausgelöst, wenn der Benutzer im Dialogfeld zum Suchen von Dateien eine oder mehrere Dateien für einen Upload-Vorgang auswählt. | FileReferenceList | |||
| fileList | Eigenschaft |
fileList:Array [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Ein Array von FileReference-Objekten.
Wenn die Methode FileReferenceList.browse() aufgerufen wurde und ein Benutzer mindestens eine Datei aus dem mit der Methode browse() geöffneten Dialogfeld ausgewählt hat, wird diese Eigenschaft mit einem Array von FileReference-Objekten aktualisiert, die die vom Benutzer ausgewählten Dateien darstellen. Sie können dieses Array verwenden, um die einzelnen Dateien mit der Methode FileReference.upload() hochzuladen. Sie können nicht mehrere Dateien auf einmal hochladen.
Die Eigenschaft fileList wird bei jedem Aufruf von "browse()" für das FileReferenceList-Objekt aktualisiert.
Die Eigenschaften der FileReference-Objekte sind in der Dokumentation der FileReference-Klasse beschrieben.
public function get fileList():Array Siehe auch
| FileReferenceList | () | Konstruktor |
public function FileReferenceList()
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Erstellt ein neues FileReferenceList-Objekt. Ein FileReferenceList-Objekt enthält keine Werte, bis Sie dafür die Methode browse() aufrufen und der Benutzer eine oder mehrere Dateien auswählt. Beim Aufruf von browse() für das FileReferenceList-Objekt wird die Eigenschaft fileList des Objekts mit einem Array von FileReference-Objekten aktualisiert.
Siehe auch
| browse | () | Methode |
public function browse(typeFilter:Array = null):Boolean
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Zeigt ein Dialogfeld zum Suchen von Dateien an, in dem der Benutzer eine oder mehrere lokal gespeicherte Dateien für einen Upload-Vorgang auswählen kann. Das Dialogfeld stammt aus dem Betriebssystem des Benutzers. Wenn diese Methode aufgerufen wird und ein Benutzer erfolgreich Dateien ausgewählt hat, wird die Eigenschaft fileList dieses FileReferenceList-Objekts mit einem Array von FileReference-Objekten aktualisiert (ein Objekt pro vom Benutzer ausgewählter Datei). Bei jedem nachfolgenden Aufruf der Methode "FileReferenceList.browse()" wird die Eigenschaft FileReferenceList.fileList auf die vom Benutzer im Dialogfeld ausgewählten Dateien zurückgesetzt.
Mit dem Parameter typeFilter können Sie festlegen, welche Dateien im Dialogfeld angezeigt werden.
Für ein FileReferenceList-Objekt kann immer nur jeweils eine FileReference.browse()-, FileReference.download()- oder FileReferenceList.browse()-Sitzung ausgeführt werden, da immer nur ein Dialogfeld geöffnet werden kann.
Parameter
typeFilter:Array (default = null) — Ein Array mit FileFilter-Instanzen zur Filterung der im Dialogfeld angezeigten Dateien. Wenn Sie diesen Parameter weglassen, werden alle Dateien angezeigt. Weitere Informationen finden Sie im Abschnitt zur Klasse FileFilter.
|
Boolean — Gibt true zurück, wenn die Parameter gültig sind und das Dialogfeld für die Dateisuche geöffnet wird.
|
select: — Wird ausgelöst, wenn der Benutzer erfolgreich ein Element für den Upload-Vorgang aus dem Dialogfeld ausgewählt hat. |
|
cancel: — Wird aufgerufen, wenn der Benutzer das Dialogfeld abbricht oder schließt. |
IllegalOperationError — Wird aufgrund der folgenden Ursachen ausgelöst: 1) Es wird bereits eine FileReference- oder FileReferenceList-Suchsitzung ausgeführt. Es können nicht mehrere Suchsitzungen gleichzeitig ausgeführt werden. 2) Der Vorgang wird durch eine Einstellung in der Datei "mms.cfg" des Benutzers verhindert.
|
|
ArgumentError — Wenn die FileFilter-Objekte im Array typeFilter nicht richtig formatiert sind, wird eine Ausnahme ausgelöst. Nähere Informationen über das richtige Filterformat finden Sie in der Dokumentation zu "FileFilter".
|
Siehe auch
| cancel | Ereignis |
flash.events.Event flash.events.Event.CANCEL | Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Wird ausgelöst, wenn der Benutzer das Dialogfeld zum Suchen von Dateien abbricht. (Dieses Dialogfeld wird beim Aufruf der Methode FileReferenceList.browse(), FileReference.browse() oder FileReference.download() geöffnet.)
type eines cancel-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Ein Verweis auf das Objekt, dessen Operation abgebrochen wurde. |
Siehe auch
| select | Ereignis |
flash.events.Event flash.events.Event.SELECT | Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Wird ausgelöst, wenn der Benutzer im Dialogfeld zum Suchen von Dateien eine oder mehrere Dateien für einen Upload-Vorgang auswählt. (Dieses Dialogfeld wird beim Aufruf der Methode FileReferenceList.browse(), FileReference.browse() oder FileReference.download() geöffnet.) Wenn der Benutzer eine Datei auswählt und den Vorgang bestätigt (z. B. durch Klicken auf "Speichern"), wird das FileReferenceList-Objekt mit den Daten der FileReference-Objekte aktualisiert, die die vom Benutzer ausgewählten Dateien darstellen.
type eines select-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das FileReference-Objekt, auf dem ein Objekt ausgewählt wurde. |
Siehe auch
complete, das nach den Upload-Vorgängen der einzelnen Dateien im FileReferenceList-Objekt ausgelöst wird. Das Ereignis LIST_COMPLETE der FileReferenceListExample-Klasse wird ausgelöst, wenn alle Dateien im FileReferenceList-Objekt hochgeladen wurden.
Verwenden Sie zur Ausführung dieses Beispiels ein Skript, das den Upload einer Datei unter http://www.[yourDomain].com/yourUploadHandlerScript.cfm zulässt. Abhängig vom Speicherort Ihrer SWF-Datei und dem Upload-Ziel müssen Sie außerdem ggf. die SWF-Datei unter Verwendung der Einstellung "Nur auf Netzwerk zugreifen" für die Option "Sicherheit bei lokaler Wiedergabe" kompilieren oder die Flash® Player-Sicherheitseinstellungen ändern, um den Netzwerkzugriff für diese Datei zuzulassen. Wenn das Upload-Ziel ein Remote-Server ist und Sie dieses Beispiel über Ihren Desktop-Computer ausführen, muss auf dem Server eine crossdomain.xml-Datei abgelegt sein.
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());
}
}
Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht
Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/net/FileReferenceList.html