| Pacchetto | flash.net |
| Classe | public class FileReferenceList |
| Ereditarietà | FileReferenceList EventDispatcher Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Per utilizzare la classe FileReferenceList:
var myFileRef = new FileReferenceList();FileReferenceList.browse(), che apre una finestra di dialogo che consente all'utente di selezionare uno o più file da caricare: myFileRef.browse();browse(), la proprietà fileList dell'oggetto FileReferenceList viene compilata con un array di oggetti FileReference.FileReference.upload() su ciascun elemento nell'array fileList.La classe FileReferenceList include un metodo browse() e una proprietà fileList da utilizzare per le operazioni con più file. Mentre è in esecuzione una chiamata al metodo FileReferenceList.browse(), la riproduzione del file SWF viene messa in pausa sui lettori autonomi ed esterni per Linux e Mac OS X 10.1 e versioni precedenti.
Vedere anche
| Proprietà | Definito da | ||
|---|---|---|---|
![]() | constructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
| Object | |
| fileList: Array
[sola lettura]
Un array di oggetti FileReference.
| FileReferenceList | ||
![]() | prototype: Object
[statico]
Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
| Object | |
| Metodo | Definito da | ||
|---|---|---|---|
|
Crea un nuovo oggetto FileReferenceList.
| FileReferenceList | ||
![]() |
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 | |
|
Visualizza una finestra di dialogo per l'individuazione dei file che consente all'utente di selezionare uno o più file locali da caricare.
| FileReferenceList | ||
![]() |
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 | |
![]() |
Indica se la proprietà specificata esiste ed è enumerabile.
| Object | |
![]() |
Rimuove un listener dall'oggetto EventDispatcher.
| EventDispatcher | |
![]() |
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
| 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 | ||
|---|---|---|---|---|
![]() | Inviato quando Flash Player riceve lo stato di attivazione del sistema operativo e diventa attivo. | EventDispatcher | ||
| Inviato quando l'utente chiude la finestra di dialogo per l'individuazione dei file. | FileReferenceList | |||
![]() | Inviato quando Flash Player perde lo stato di attivazione del sistema operativo e sta per diventare inattivo. | EventDispatcher | ||
| Inviato quando l'utente seleziona uno o più file da caricare dalla finestra di dialogo per l'individuazione dei file. | FileReferenceList | |||
| fileList | proprietà |
fileList:Array [sola lettura]
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Un array di oggetti FileReference.
Quando viene chiamato il metodo FileReferenceList.browse() e l'utente ha selezionato uno o più file nella finestra di dialogo visualizzata dal metodo browse(), questa proprietà viene compilata con un array di oggetti FileReference, ciascuno dei quali rappresenta i file selezionati dall'utente. A questo punto è possibile utilizzare questo array per caricare ogni file con il metodo FileReference.upload(). È necessario caricare un file alla volta.
La proprietà fileList viene nuovamente compilata ogni volta che si chiama browse() su tale oggetto FileReferenceList.
Le proprietà degli oggetti FileReference sono descritte nella documentazione relativa alla classe FileReference.
public function get fileList():Array
Vedere anche
| FileReferenceList | () | Funzione di costruzione |
public function FileReferenceList()
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Crea un nuovo oggetto FileReferenceList. Un oggetto FileReferenceList non contiene nulla fino a quando non si chiama il metodo browse() su di esso e l'utente seleziona uno o più file. Quando si chiama browse() sull'oggetto FileReference, la proprietà fileList dell'oggetto viene compilata con un array di oggetti FileReference.
Vedere anche
| browse | () | metodo |
public function browse(typeFilter:Array = null):Boolean
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Visualizza una finestra di dialogo per l'individuazione dei file che consente all'utente di selezionare uno o più file locali da caricare. La finestra di dialogo è nativa del sistema operativo dell'utente. Quando si chiama questo metodo e l'utente seleziona correttamente i file, la proprietà fileList di questo oggetto FileReferenceList viene compilata con un array di oggetti FileReference, uno per ogni file selezionato dall'utente. A ogni chiamata successiva del metodo FileReferenceList.browse(), la proprietà FileReferenceList.fileList viene ripristinata in base al file selezionato dall'utente nella finestra di dialogo.
Il parametro typeFilter consente di determinare quali file vengono visualizzati nella finestra di dialogo.
È possibile eseguire una sola sessione FileReference.browse(), FileReference.download() o FileReferenceList.browse() alla volta su un oggetto FileReferenceList (poiché è possibile aprire una sola finestra di dialogo per volta).
Parametri
typeFilter:Array (default = null) — Un array di istanze di FileFilter utilizzate per filtrare i file visualizzati nella finestra di dialogo. Se si omette questo parametro, vengono visualizzati tutti i file. Per ulteriori informazioni, vedere la classe FileFilter.
|
Boolean — Restituisce true se i parametri sono validi e viene visualizzata la finestra di dialogo per l'individuazione dei file.
|
select: — Inviato quando l'utente ha selezionato correttamente un elemento da caricare dalla finestra di dialogo. |
|
cancel: — Richiamato quando l'utente esce dalla finestra di dialogo facendo clic su Annulla o chiudendola. |
IllegalOperationError — Generato per i motivi seguenti: 1) Un'altra sessione FileReference o FileReferenceList è in corso; è possibile eseguire una sola sessione di individuazione dei file per volta. 2) Un'impostazione nel file mms.cfg dell'utente proibisce questa operazione.
|
|
ArgumentError — Se l'array typeFilter non contiene oggetti FileFilter formattati in modo corretto, viene generata un'eccezione. Per informazioni dettagliate sulla corretta formattazione dei filtri, vedere la documentazione di FileFilter.
|
Vedere anche
| cancel | Evento |
flash.events.Event
flash.events.Event.CANCEL
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Inviato quando l'utente chiude la finestra di dialogo per l'individuazione dei file. (Questa finestra di dialogo viene visualizzata quando si chiama il metodo FileReferenceList.browse(), FileReference.browse() o FileReference.download()).
type di un oggetto evento cancel.
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 | Un riferimento all'oggetto sul quale viene annullata l'operazione. |
Vedere anche
| select | Evento |
flash.events.Event
flash.events.Event.SELECT
| Versione linguaggio: | ActionScript 3.0 |
| Versione lettore: | Flash Player 9 |
Inviato quando l'utente seleziona uno o più file da caricare dalla finestra di dialogo per l'individuazione dei file. (Questa finestra di dialogo viene visualizzata quando si chiama il metodo FileReferenceList.browse(), FileReference.browse() o FileReference.download()). Quando l'utente seleziona un file e conferma l'operazione (ad esempio, facendo clic su Salva), l'oggetto FileReferenceList viene compilato dagli oggetti FileReference che rappresentano i file selezionati dall'utente.
type di un oggetto evento select.
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 FileReference su cui è stata selezionata una voce. |
Vedere anche
complete inviato, Flash Player può leggere tutte le altre proprietà dell'oggetto FileReference. L'evento LIST_COMPLETE nella classe FileReferenceListExample viene inviato quando tutti i file nell'oggetto FileReferenceList sono stati caricati.
Per provare questo esempio, inserire uno script che sia scritto in modo da accettare un caricamento di file all'indirizzo http://www.[yourDomain].com/yourUploadHandlerScript.cfm. A seconda della posizione del file SWF e di dove si caricano i file, è possibile che sia anche necessario compilare il file SWF con l'opzione Sicurezza riproduzione locale impostata su Accedi solo alla rete o aggiornare le impostazioni di sicurezza di Flash ® Player consentire al file l'accesso alla rete. Se il server di caricamento è remoto e si prova questo esempio da un computer desktop, sul server deve essere presente un file 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());
}
}
Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti
Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/net/FileReferenceList.html