Pacchettoflash.net
Classepublic final class FileFilter
EreditarietàFileFilter Inheritance Object

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

La classe FileFilter viene utilizzata per indicare quali file presenti nel sistema dell'utente vengono visualizzati nella finestra di dialogo di selezione dei file che viene visualizzata quando si effettua la chiamata a FileReference.browse() o FileReferenceList.browse(). Le istanze di FileFilter vengono passate a una funzione browse(). Se si utilizza 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 e caricati. Se a browse() 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:

I due formati non sono intercambiabili nell'ambito della stessa chiamata a browse(). È possibile utilizzarne uno solo alla volta.

È possibile passare una o più istanze di eFilter a FileReference.browse() o FileReferenceList.browse(). Gli esempi seguenti illustrano diversi modi per creare e passare istanze di eFilter a una chiamata a browse() (solo per Windows). Il primo esempio crea delle istanze di FileFilterr al di fuori della chiamata a browse():

 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]);
 

Il secondo esempio crea delle istanze di FileFilter all'interno della chiamata a browse():

 myFileReference.browse( [ new FileFilter("Images", "*.jpg;*.gif;*.png"), new FileFilter("Flash Movies", "*.swf") ] );
 

L'elenco delle estensioni nella proprietà FileFilter.extension viene utilizzato per filtrare i file in Windows, a seconda del file selezionato dall'utente. 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 (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 di estensioni Windows.



Proprietà pubbliche
 ProprietàDefinito da
 Inheritedconstructor: 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
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
Metodi pubblici
 MetodoDefinito da
  
FileFilter(description:String, extension:String, macType:String = null)
Crea una nuova istanza FileFilter.
FileFilter
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione delle proprietà
descriptionproprietà
description:String  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: 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
extensionproprietà 
extension:String  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: 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 Windows, 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
macTypeproprietà 
macType:String  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: 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
Descrizione della funzione di costruzione
FileFilter()Funzione di costruzione
public function FileFilter(description:String, extension:String, macType:String = null)

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Crea una nuova istanza FileFilter.

Parametri
description: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 Windows 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.




 

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/FileFilter.html