| Paquete | flash.net |
| Clase | public final class FileFilter |
| Herencia | FileFilter  Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
FileReference.browse(), FileReferenceList.browse() o si se llama a un método browse de objetos File, FileReference o FileReferenceList. Las instancias de FileFilter se transfieren al método como un valor del parámetro opcional typeFilter. 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. Si no se transfiere ningún objeto FileFilter, se muestran 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
- Una descripción sólo con extensiones de archivo de y tipos de archivo de Macintosh.
Los dos formatos no se pueden intercambiar en una sola llamada al método browse. Deberá utilizar uno u otro.
Es posible transferir una o varias instancias de FileFilter al método browse, tal como se muestra a continuación:
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]);
O en una aplicación de 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 lista de extensiones de la propiedad FileFilter.extension se utiliza para filtrar los archivos que aparecen en el diálogo de búsqueda. 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 se muestra en el cuadro de diálogo en Windows y en Linux. (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, se utiliza la lista de extensiones de archivo.
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| 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 | ||
| Método | Definido por | ||
|---|---|---|---|
Crea una nueva instancia de FileFilter. | FileFilter | ||
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
|
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | |
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
|
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | |
|
Devuelve la representación de cadena del objeto especificado. | Object | |
|
Devuelve el valor simple del objeto especificado. | Object | |
description | propiedad |
description:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, 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):voidextension | propiedad |
extension:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, 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 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):voidmacType | propiedad |
macType:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, 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):voidFileFilter | () | Información sobre |
public function FileFilter(description:String, extension:String, macType:String = null)| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Crea una nueva instancia de FileFilter.
Parámetrosdescription: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 son visibles para los usuarios cuando seleccionan archivos y los cargan.
| |
macType:String (default = null)null.
|
Ejemplo ( Cómo utilizar este ejemplo )
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, 02:12 PM Z