Packageflash.net
Classepublic final class FileFilter
HéritageFileFilter Inheritance Object

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

La classe FileFilter permet d'indiquer quels fichiers du système utilisateur sont répertoriés dans la boîte de dialogue de recherche de fichiers qui s’affiche lors de l’appel de la méthode FileReference.browse(), de la méthode FileReferenceList.browse(), ou d'une méthode de recherche d'un objet File, FileReference ou FileReferenceList. Les occurrences de FileFilter sont transmises à la méthode comme une valeur du paramètre facultatif typeFilter. Si vous utilisez une occurrence de FileFilter, les extensions et les types de fichiers qu’elle ne spécifie pas sont omis. En d’autres termes, les utilisateurs ne peuvent pas les sélectionner. Si aucun objet FileFilter n’est transmis à la méthode, tous les fichiers sont répertoriés dans la boîte de dialogue.

Vous pouvez utiliser les occurrences de FileFilter de deux façons :

Ces deux formats ne sont pas interchangeables dans le même appel de la méthode browse. Vous devez utiliser l'un ou l'autre.

Vous pouvez transmettre une ou plusieurs occurrences de FileFilter à la méthode browse, comme dans l'exemple suivant :

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

Dans le cas d'une application 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]);

La liste des extensions dans la propriété FileFilter.extension est utilisée pour filtrer les fichiers affichés dans la boîte de dialogue de recherche de fichiers. Cette liste n'est pas réellement affichée dans la boîte de dialogue. Pour afficher les types de fichiers aux utilisateurs, vous devez énumérer les types de fichiers dans la chaîne descriptive, ainsi que dans la liste d'extensions. Sous Windows et Linux, la chaîne descriptive est affichée dans la boîte de dialogue. (Elle n'est pas utilisée sous Macintosh ®.) Sous Macintosh, une liste de types de fichier Macintosh est utilisée pour filtrer les fichiers, si vous la fournissez. Si elle n'est pas fournie, la liste d'extensions de fichier est utilisée par défaut.


Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
  description : String
Chaîne de description du filtre.
FileFilter
  extension : String
Liste d'extensions de fichier.
FileFilter
  macType : String
Liste de types de fichiers Macintosh.
FileFilter
 Inheritedprototype : Object
[statique] Référence à l'objet prototype d'un objet de classe ou fonction.
Object
Méthodes publiques
 MéthodeDéfini par
  
FileFilter(description:String, extension:String, macType:String = null)
Crée une occurrence de FileFilter.
FileFilter
 Inherited
hasOwnProperty(name:String):Boolean
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre.
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 Inherited
toString():String
Renvoie la représentation sous forme de chaîne de l'objet spécifié.
Object
 Inherited
valueOf():Object
Renvoie la valeur primitive de l'objet spécifié.
Object
Détails de la propriété
descriptionpropriété
description:String  [lecture-écriture]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Chaîne de description du filtre. La description apparaît à l'utilisateur dans la boîte de dialogue qui s'affiche lors d'un appel de FileReference.browse() ou FileReferenceList.browse(). Elle contient une chaîne, telle que Images (*.gif, *.jpg, *.png), qui indique à l'utilisateur les types de fichiers qu'il peut charger ou télécharger. Sachez que les types de fichiers qui sont pris en charge par cet objet FileReference sont stockés dans la propriété extension.



Implémentation
    public function get description():String
    public function set description(value:String):void
extensionpropriété 
extension:String  [lecture-écriture]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Liste d'extensions de fichier. Cette liste répertorie les types de fichiers à afficher dans la boîte de dialogue de recherche de fichiers. (La liste n'apparaît pas à l'utilisateur, qui voit uniquement la valeur de la propriété description.) La propriété extension contient une liste d'extensions de fichier délimitées par des points-virgules et précédées d'un caractère générique (*), comme suit : *.jpg;*.gif;*.png.



Implémentation
    public function get extension():String
    public function set extension(value:String):void
macTypepropriété 
macType:String  [lecture-écriture]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Liste de types de fichiers Macintosh. Cette liste répertorie les types de fichiers à afficher dans la boîte de dialogue de recherche de fichiers. (La liste n'apparaît pas à l'utilisateur, qui voit uniquement la valeur de la propriété description.) La propriété macType contient une liste de types de fichiers Macintosh délimités par des points-virgules, comme suit : JPEG;jp2_;GIFF.



Implémentation
    public function get macType():String
    public function set macType(value:String):void
Détails du constructeur
FileFilter()Constructeur
public function FileFilter(description:String, extension:String, macType:String = null)

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Crée une occurrence de FileFilter.

Paramètres
description:String — Chaîne de description qui s'affiche lorsque les utilisateurs sélectionnent des fichiers à charger.
 
extension:String — Liste des extensions indiquant quels formats de fichier s'affichent lorsque les utilisateurs sélectionnent des fichiers à charger.
 
macType:String (default = null) — Liste des types de fichiers Macintosh indiquant ceux qui s'affichent lorsque les utilisateurs sélectionnent des fichiers à charger. Si aucune valeur n'est transmise, ce paramètre est réglé sur null.



© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Thu Jan 8 2009, 03:00 AM -08:00