Pacchetto | flash.net |
Classe | public final class FileFilter |
Ereditarietà | FileFilter Object |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
FileReference.browse()
, il metodo FileReferenceList.browse()
o un metodo browse di un oggetto File, FileReference o FileReferenceList. Le istanze FileFilter vengono passate al metodo sotto forma di un valore per il parametro typeFilter
opzionale. Se utilizzate un'istanza FileFilter, le estensioni e i tipi di file che non sono specificati nell'istanza FileFilter vengono filtrati ed esclusi; in altre parole, non sono disponibili all'utente per essere selezionati. Se al metodo non viene passato alcun oggetto FileFilter, nella finestra di dialogo vengono passati tutti i file.
Le istanze di FileFilter possono essere utilizzate in uno dei due modi seguenti:
- una descrizione solo con estensioni di file;
- una descrizione con estensioni di file e tipi di file Macintosh.
I due formati non sono intercambiabili all'interno di una singola chiamata al metodo browse. È possibile utilizzarne uno solo alla volta.
Potete passare una o più istanze FileFilter al metodo browse, come mostrato di seguito:
var imagesFilter:FileFilter = new FileFilter("Images", "*.jpg;*.gif;*.png"); var docFilter:FileFilter = new FileFilter("Documents", "*.pdf;*.doc;*.txt"); var myFileReference:FileReference = new FileReference(); myFileReference.browse([imagesFilter, docFilter]);
Oppure in un'applicazione AIR:
var imagesFilter:FileFilter = new FileFilter("Images", "*.jpg;*.gif;*.png"); var docFilter:FileFilter = new FileFilter("Documents", "*.pdf;*.doc;*.txt"); var myFile:File = new File(); myFile.browseForOpen("Open", [imagesFilter, docFilter]);
L'elenco delle estensioni della proprietà FileFilter.extension
viene utilizzato come filtro per i file visualizzati nella finestra di dialogo di individuazione dei file. L'elenco non viene effettivamente visualizzato nella finestra di dialogo; per visualizzare i tipi di file agli utenti, elencarli nella stringa di descrizione oltre che nell'elenco delle estensioni. La stringa di descrizione è visualizzata nella finestra di dialogo in Windows e Linux (non viene utilizzata in Macintosh®). Su Macintosh, se viene fornito un elenco di tipi di file Macintosh, l'elenco viene utilizzato per filtrare i file. In caso contrario, viene utilizzato l'elenco delle estensioni di file.
Proprietà | Definito da | ||
---|---|---|---|
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
description : String
La stringa di descrizione del filtro. | FileFilter | ||
extension : String
Un elenco delle estensioni di file. | FileFilter | ||
macType : String
Un elenco dei tipi di file Macintosh. | FileFilter |
Metodo | Definito da | ||
---|---|---|---|
Crea una nuova istanza FileFilter. | FileFilter | ||
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 | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | ||
Restituisce il valore di base dell'oggetto specificato. | Object |
description | proprietà |
description:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
La stringa di descrizione del filtro. La descrizione è visibile all'utente nella finestra di dialogo che viene visualizzata quando si chiama FileReference.browse()
o FileReferenceList.browse()
. La stringa di descrizione contiene una stringa, ad esempio "Images (*.gif, *.jpg, *.png)"
, che aiuta l'utente nella selezione dei tipi di file da caricare o scaricare. Gli effettivi tipi di file supportati da questo oggetto FileReference sono memorizzati nella proprietà extension
.
Implementazione
public function get description():String
public function set description(value:String):void
extension | proprietà |
extension:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Un elenco delle estensioni di file. L'elenco indica i tipi di file che è possibile decidere di visualizzare nella finestra di dialogo per l'individuazione dei file. (L'elenco non è visibile all'utente, il quale visualizza solo il valore della proprietà description
). La proprietà extension
contiene un elenco delimitato da punti e virgola di estensioni di file, con un carattere jolly (*) che precede ogni estensione, come illustrato nella stringa seguente: "*.jpg;*.gif;*.png"
.
Implementazione
public function get extension():String
public function set extension(value:String):void
macType | proprietà |
macType:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Un elenco dei tipi di file Macintosh. L'elenco indica i tipi di file che è possibile decidere di visualizzare nella finestra di dialogo per l'individuazione dei file. (L'elenco non è visibile all'utente, il quale visualizza solo il valore della proprietà description
). La proprietà macType
contiene un elenco delimitato da punti e virgola di tipi di file Macintosh, come illustrato nella stringa seguente: "JPEG;jp2_;GIFF"
.
Implementazione
public function get macType():String
public function set macType(value:String):void
FileFilter | () | Funzione di costruzione |
public function FileFilter(description:String, extension:String, macType:String = null)
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Crea una nuova istanza FileFilter.
Parametridescription:String — La stringa di descrizione che è visibile agli utenti quando selezionano i file per il caricamento.
| |
extension:String — Un elenco di estensioni di file che indica quali formati di file sono visualizzati dagli utenti quando selezionano i file per il caricamento.
| |
macType:String (default = null ) — Un elenco di tipi di file Macintosh che indica quali tipi di file sono visualizzati dagli utenti quando selezionano i file per il caricamento. Se non viene passato alcun valore, questo parametro è impostato su null .
|
Esempio ( Come utilizzare questo esempio )
var buttonShape:Shape = new Shape(); buttonShape.graphics.beginFill(0x336699); buttonShape.graphics.drawCircle(50, 50, 25); var button = new SimpleButton(buttonShape, buttonShape, buttonShape, buttonShape); addChild(button); var fileRef:FileReference= new FileReference(); button.addEventListener(MouseEvent.CLICK, onButtonClick); function onButtonClick(e:MouseEvent):void { fileRef.browse([new FileFilter("Images", "*.jpg;*.gif;*.png")]); fileRef.addEventListener(Event.SELECT, onFileSelected); } function onFileSelected(e:Event):void { fileRef.addEventListener(Event.COMPLETE, onFileLoaded); fileRef.load(); } function onFileLoaded(e:Event):void { var loader:Loader = new Loader(); loader.loadBytes(e.target.data); addChild(loader); }
Tue Jun 12 2018, 02:44 PM Z