| 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):voidextension | 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):voidmacType | 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):voidFileFilter | () | 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
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate