flash.net.FileFilter (ActionScript 3.0)

Package	flash.net
Classe	public final class FileFilter
Héritage	FileFilter Object

Version du langage :

ActionScript 3.0

Version du lecteur :

Flash Player 9

La classe FileFilter permet d’indiquer quels fichiers du système de l’utilisateur sont répertoriés dans la boîte de dialogue de recherche de fichiers qui s’affiche lors de l’appel de FileReference.browse() ou FileReferenceList.browse(). Les occurrences de FileFilter sont transmises à une fonction browse(). S 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, ils ne sont pas proposés à l'utilisateur lorsqu'il sélectionne les fichiers à charger. Si aucun objet FileFilter n’est transmis à browse(), tous les fichiers sont répertoriés dans la boîte de dialogue.

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

Une description avec les extensions de fichier Windows uniquement.
Une description avec les extensions de fichier Windows et les types de fichiers Macintosh.

Les deux formats ne sont pas interchangeables dans le même appel de browse(). Vous devez utiliser l'un ou l'autre.

Vous pouvez transmettre plusieurs occurrences de FileFilter à FileReference.browse() ou FileReferenceList.browse(). Les exemples suivants illustrent différentes façons de créer et de transmettre des occurrences de FileFilter à un appel de browse() (pour Windows seulement). Le premier exemple crée des occurrences de FileFilter en dehors de l’appel de 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]);

Le second exemple crée des occurrences de FileFilter au sein de l’appel de browse() :

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

La liste des extensions de la propriété FileFilter.extension est utilisée pour filtrer les fichiers sous Windows, selon le type de fichier sélectionné par l'utilisateur. Elle 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, 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 Windows est utilisée par défaut.

	Propriété	Défini par
		constructor : 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
		prototype : Object [static] Référence à l’objet prototype d’un objet de classe ou fonction.	Object

	Méthode	Défini par
		FileFilter(description:String, extension:String, macType:String = null) Crée une occurrence de FileFilter.	FileFilter
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d'un objet est définie.	Object
		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
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l'objet spécifié.	Object
		valueOf():Object Renvoie la valeur primitive de l'objet spécifié.	Object

Détails des propriétés

description

propriété

description:String [lecture-écriture]

Version du langage :

ActionScript 3.0

Version du lecteur :

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

extension

propriété

extension:String [lecture-écriture]

Version du langage :

ActionScript 3.0

Version du lecteur :

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 Windows 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

macType

propriété

macType:String [lecture-écriture]

Version du langage :

ActionScript 3.0

Version du lecteur :

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

Version du lecteur :

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 Windows 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`.

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/flash/net/FileFilter.html

Guide de référence du langage et des composants ActionScript 3.0		Tous les packages \| Toutes les classes \| Eléments du langage \| Index \| Annexes \| Conventions \| Cadres Aucune image
FileFilter	Propriétés \| Méthodes