flash.net.FileFilter (ActionScript 3.0)

Paket	flash.net
Klasse	public final class FileFilter
Vererbung	FileFilter Object

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Mit der FileFilter-Klasse wird angegeben, welche Dateien des Benutzersystems im Dialogfeld zum Suchen nach Dateien angezeigt werden. Dieses Dialogfeld wird beim Aufruf von FileReference.browse() oder FileReferenceList.browse() geöffnet. FileFilter-Instanzen werden an eine browse()-Funktion ü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 zum Upload auswählen. Wenn kein FileFilter-Objekt an browse() übergeben wird, werden alle Dateien im Dialogfeld angezeigt.

Es gibt zwei Möglichkeiten zur Verwendung von FileFilter-Instanzen:

Eine Beschreibung nur mit Windows-Dateierweiterungen
Eine Beschreibung mit Windows-Dateierweiterungen und Macintosh-Dateitypen

Die beiden Formate können in einem browse()-Aufruf nicht gleichzeitig verwendet werden. Sie können immer nur ein Format verwenden.

Sie können eine oder mehrere FileFilter-Instanzen an FileReference.browse() oder FileReferenceList.browse() übergeben. In den folgenden Beispielen werden verschiedene Möglichkeiten zur Erstellung und Übergabe von FileFilter-Instanzen an einen browse()-Aufruf gezeigt (nur für Windows). Im ersten Beispiel werden FileFilter-Instanzen außerhalb des browse()-Aufrufs erstellt:

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

Im zweiten Beispiel werden FileFilter-Instanzen innerhalb des browse()-Aufrufs erstellt:

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

Anhand der Liste mit den Erweiterungen in der Eigenschaft FileFilter.extension wird unter Windows je nach Auswahl der Datei durch den Benutzer die Anzeige der Dateien gefiltert. Diese Liste wird im eigentlichen Dialogfeld nicht angezeigt. Wenn Benutzer die Dateitypen sehen möchten, muss die Liste der Dateitypen sowohl in der Beschreibung als auch in der Liste der Dateinamenerweiterungen stehen. Der Beschreibungsstring wird in Windows im Dialogfeld angezeigt. (Diese Option steht bei Macintosh nicht zur Verfügung.) Wenn Sie auf einem Macintosh-System eine Liste der Macintosh-Dateitypen bereitstellen, so wird dies ebenfalls zum Filtern der Dateianzeige verwendet. Falls Sie keine Liste der Macintosh-Dateitypen angeben, wird die Liste der Windows-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
		prototype : Object [static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.	Object

	Methode	Definiert von
		FileFilter(description:String, extension:String, macType:String = null) Erstellt eine neue FileFilter-Instanz.	FileFilter
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Eigenschaftsdetail

description

Eigenschaft

description:String [read-write]

Sprachversion :

ActionScript 3.0

Player-Version :

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 [read-write]

Sprachversion :

ActionScript 3.0

Player-Version :

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 Eigenschaft extension enthält eine Liste mit Windows-Dateierweiterungen. Als Trennzeichen wird das Semikolon verwendet, und jeder Erweiterung ist ein Platzhalterzeichen (*) vorangestellt: "*.jpg;*.gif;*.png".

Implementierung
public function get extension():String
public function set extension(value:String):void

macType

Eigenschaft

macType:String [read-write]

Sprachversion :

ActionScript 3.0

Player-Version :

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

Konstruktordetail

FileFilter

()

Konstruktor

public function FileFilter(description:String, extension:String, macType:String = null)

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Erstellt eine neue FileFilter-Instanz.

Parameter

	`description:String` — Der für Benutzer beim Auswählen von Dateien zum Upload sichtbare Beschreibungsstring.

	`extension:String` — Eine Liste mit Dateierweiterungen, mit der angegeben wird, welche Windows-Dateiformate für Benutzer sichtbar sind, wenn sie Dateien zum Upload auswählen.

	`macType:String` (default = `null`) — Eine Liste mit Macintosh-Dateitypen, mit der angegeben wird, welche Dateitypen für Benutzer sichtbar sind, wenn sie Dateien zum Upload auswählen. Dieser Parameter wird auf `null` gesetzt, wenn kein Wert übergeben wird.

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/net/FileFilter.html

Komponenten-Referenzhandbuch für ActionScript 3.0		Alle Pakete \| Alle Klassen \| Sprachelemente \| Stichwortverzeichnis \| Anhänge \| Konventionen \| Frames Keine Frames
FileFilter	Eigenschaften \| Methoden