flash.net.FileFilter (ActionScript 3.0)

Paquete	flash.net
Clase	public final class FileFilter
Herencia	FileFilter Object

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9

La clase FileFilter se utiliza para indicar qué archivos del sistema del usuario se muestran en el cuadro de diálogo de búsqueda de archivos que aparece al realizar una llamada a FileReference.browse() o a FileReferenceList.browse(). Las instancias de FileFilter se transfieren a la función browse(). Si utiliza una instancia de FileFilter, las extensiones y los tipos de archivos no especificados en dicha instancia se filtrarán; es decir, no se pondrán a disposición del usuario para que pueda seleccionarlos y cargarlos. Si no se transfiere ningún objeto FileFilter a browse(), se mostrarán todos los archivos en el cuadro de diálogo.

Las instancias de FileFilter se pueden utilizar de una de estas maneras:

Una descripción sólo con extensiones de archivo de Windows.
Una descripción sólo con extensiones de archivo de Windows y tipos de archivo de Macintosh.

Los dos formatos no son intercambiables en una sola llamada a browse(). Deberá utilizar uno u otro.

Se puede transferir una o varias instancias de FileFilter a FileReference.browse() o FileReferenceList.browse(). Los siguientes ejemplos muestran las formas distintas de crear y transferir instancias de FileFilter a una llamada browse() (sólo para Windows). El primer ejemplo crea instancias de FileFilter fuera de la llamada 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]);

El segundo ejemplo crea instancias de FileFilter dentro de la llamada browse():

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

La lista de extensiones de la propiedad FileFilter.extension se emplea para filtrar los archivos en Windows, de acuerdo con el archivo seleccionado por el usuario. En realidad, no se muestra en el cuadro de diálogo; para que los usuarios vean los tipos de archivos, debe mostrar los tipos de archivo en la cadena de descripción, así como la lista de extensiones. La cadena de descripción aparece en el cuadro de diálogo en Windows. (No se utiliza en Macintosh.) En Macintosh, si se suministra una lista de tipos de archivos de Macintosh, se utiliza ésta para filtrar los archivos. Si no es así, se utiliza la lista de extensiones de Windows.

	Propiedad	Definido por
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object
		description : String La cadena de descripción para el filtro.	FileFilter
		extension : String Una lista de extensiones de archivo.	FileFilter
		macType : String Una lista de tipos de archivo de Macintosh.	FileFilter
		prototype : Object [static] Una referencia al objeto prototipo de una clase u objeto de función.	Object

	Método	Definido por
		FileFilter(description:String, extension:String, macType:String = null) Crea una nueva instancia de FileFilter.	FileFilter
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		toString():String Devuelve la representación de cadena del objeto especificado.	Object
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object

Información sobre propiedades

description

propiedad

description:String [read-write]

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9

La cadena de descripción para el filtro. La descripción es visible para el usuario en el cuadro de diálogo que se abre al realizar una llamada a FileReference.browse() o a FileReferenceList.browse(). La cadena de descripción contiene una cadena (por ejemplo, "Images (*.gif, *.jpg, *.png)") que puede ayudar al usuario en la elección de los tipos de archivo que se pueden cargar o descargar. Tenga en cuenta que los verdaderos tipos de archivo admitidos por el objeto FileReference se almacenan en la propiedad extension.

Implementación
public function get description():String
public function set description(value:String):void

extension

propiedad

extension:String [read-write]

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9

Una lista de extensiones de archivo. La lista indica los tipos de archivo que se quieren mostrar en el cuadro de diálogo de búsqueda de archivos. (La lista no es visible para el usuario; éste solamente puede ver el valor de la propiedad description). La propiedad extension contiene una lista de extensiones de archivo de Windows delimitadas por punto y coma, con un comodín (*) delante de cada extensión, como se puede ver en la siguiente cadena: "*.jpg;*.gif;*.png".

Implementación
public function get extension():String
public function set extension(value:String):void

macType

propiedad

macType:String [read-write]

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9

Una lista de tipos de archivo de Macintosh. La lista indica los tipos de archivo que se quieren mostrar en el cuadro de diálogo de búsqueda de archivos. (Esta lista no es visible para el usuario; éste solamente puede ver el valor de la propiedad description). La propiedad macType contiene una lista de tipos de archivo de Macintosh delimitados por punto y coma, como se puede ver en la cadena siguiente: "JPEG;jp2_;GIFF".

Implementación
public function get macType():String
public function set macType(value:String):void

Información sobre constructores

FileFilter

()

constructor

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

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9

Crea una nueva instancia de FileFilter.

Parámetros

	`description:String` — La cadena de descripción visible a los usuarios cuando seleccionan archivos y los cargan.

	`extension:String` — Una lista de extensiones de archivo que indica qué formatos de archivo de Windows son visibles para los usuarios cuando seleccionan archivos y los cargan.

	`macType:String` (default = `null`) — Una lista de tipos de archivo de Macintosh que indica qué tipos de archivo son visibles para los usuarios cuando seleccionan archivos y los cargan. Si no se transfiere ningún valor, el parámetro se establece como `null`.

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/net/FileFilter.html

Referencia del lenguaje y componentes ActionScript 3.0		Todos los paquetes \| Todas las clases \| Elementos del lenguaje \| Índice \| Apéndices \| Convenciones \| Marcos Quitar marcos
FileFilter	Propiedades \| Métodos