Paket | flash.net |
Klasse | public final class FileFilter |
Vererbung | FileFilter Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
FileReference.browse()
-Methode oder der FileReferenceList.browse()
-Methode angezeigt oder wenn eine browse-Methode eines File-, FileReference- oder FileReferenceList-Objekts aufgerufen wird. FileFilter-Instanzen werden als Wert für den optionalen typeFilter
-Parameter an die Methode übergeben. Bei Verwendung einer FileFilter-Instanz werden nicht in der FileFilter-Instanz angegebene Erweiterungen und Dateitypen herausgefiltert, d. h., der Benutzer kann diese Dateien nicht auswählen. Wenn kein FileFilter-Objekt an die Methode übergeben wird, werden alle Dateien im Dialogfeld angezeigt.
Es gibt zwei Möglichkeiten zur Verwendung von FileFilter-Instanzen:
- Eine Beschreibung mit Dateierweiterungen
- Eine Beschreibung mit Dateierweiterungen und Macintosh-Dateitypen
Die beiden Formate können in einem Aufruf der browse-Methode nicht gleichzeitig verwendet werden. Sie können immer nur ein Format verwenden.
Sie können eine oder mehrere FileFilter-Instanzen an die browse-Methode übergeben, wie im folgenden Beispiel gezeigt:
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]);
Oder in einer AIR-Anwendung:
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]);
Die Liste der Erweiterungen in der FileFilter.extension
-Eigenschaft wird verwendet, um die Dateien zu filtern, die im Dialogfeld zum Suchen nach Dateien angezeigt werden. Die eigentliche Liste wird nicht im Dialogfeld angezeigt. Um die Dateitypen für Benutzer anzuzeigen, müssen Sie die Dateitypen im Beschreibungsstring und in der Erweiterungsliste auflisten. Der Beschreibungsstring wird im Dialogfeld in Windows und Linux angezeigt. (Auf dem Macintosh®wird er nicht verwendet.) Wenn Sie auf einem Macintosh-System eine Liste der Macintosh-Dateitypen bereitstellen, so wird dies ebenfalls zum Filtern der Dateianzeige verwendet. Andernfalls wird die Liste der Dateierweiterungen verwendet.
Eigenschaft | Definiert von | ||
---|---|---|---|
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
description : String
Der Beschreibungsstring für den Filter. | FileFilter | ||
extension : String
Eine Liste mit Dateierweiterungen. | FileFilter | ||
macType : String
Eine Liste mit Macintosh-Dateitypen. | FileFilter |
Methode | Definiert von | ||
---|---|---|---|
Erstellt eine neue FileFilter-Instanz. | FileFilter | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
description | Eigenschaft |
description:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Der Beschreibungsstring für den Filter. Die Beschreibung ist für den Benutzer in dem Dialogfeld sichtbar, das beim Aufruf von FileReference.browse()
oder FileReferenceList.browse()
geöffnet wird. Der Beschreibungsstring enthält einen String (z. B. "Images (*.gif, *.jpg, *.png)"
) mit Informationen darüber, welche Dateitypen hoch- bzw. heruntergeladen werden können. Beachten Sie, dass die von diesem FileReference-Objekt unterstützten Dateitypen in der Eigenschaft extension
gespeichert sind.
Implementierung
public function get description():String
public function set description(value:String):void
extension | Eigenschaft |
extension:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Eine Liste mit Dateierweiterungen. Diese Liste enthält die Dateitypen, die im Dialogfeld zum Suchen von Dateien angezeigt werden sollen. (Diese Liste ist für den Benutzer nicht sichtbar. Der Benutzer sieht lediglich den Wert der Eigenschaft description
.) Die extension
-Eigenschaft enthält eine durch Semikola getrennte Liste mit Dateierweiterungen, in der vor jede Erweiterung ein Platzhalterzeichen (*) gesetzt wurde, wie im folgenden String zu sehen: "*.jpg;*.gif;*.png"
.
Implementierung
public function get extension():String
public function set extension(value:String):void
macType | Eigenschaft |
macType:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Eine Liste mit Macintosh-Dateitypen. Diese Liste enthält die Dateitypen, die im Dialogfeld zum Suchen von Dateien angezeigt werden sollen. (Diese Liste ist für den Benutzer nicht sichtbar. Der Benutzer sieht lediglich den Wert der Eigenschaft description
.) Die Eigenschaft macType
enthält eine Liste mit Macintosh-Dateitypen und Semikola als Trennzeichen wie im folgenden String gezeigt: "JPEG;jp2_;GIFF"
.
Implementierung
public function get macType():String
public function set macType(value:String):void
FileFilter | () | Konstruktor |
public function FileFilter(description:String, extension:String, macType:String = null)
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Erstellt eine neue FileFilter-Instanz.
Parameterdescription:String — Der für Benutzer beim Auswählen von Dateien zum Upload sichtbare Beschreibungsstring.
| |
extension:String — Eine Liste der Dateierweiterung, die angibt, welche Dateiformate für Benutzer sichtbar sind, wenn sie Dateien auswählen, die hochgeladen werden sollen.
| |
macType:String (default = null ) — Eine Liste der Macintosh-Dateitypen, die angibt, welche Dateitypen für Benutzer sichtbar sind, wenn sie Dateien auswählen, die hochgeladen werden sollen. Dieser Parameter wird auf null gesetzt, wenn kein Wert übergeben wird.
|
Beispiel ( Verwendung dieses Beispiels )
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, 10:04 AM Z