Package | flash.net |
Classe | public final class FileFilter |
Héritage | FileFilter Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
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 :
- Une description avec les extensions de fichier uniquement.
- Une description avec les extensions de fichier et les types de fichiers Macintosh.
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é | 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 |
Méthode | Défini par | ||
---|---|---|---|
Crée une occurrence de FileFilter. | FileFilter | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
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 | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
description | propriété |
description:String
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
extension | propriété |
extension:String
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
macType | propriété |
macType:String
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
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ètresdescription: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 .
|
Exemple ( Comment utiliser cet exemple )
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, 09:30 AM Z