Paquete | flash.net |
Clase | public class FileReferenceList |
Herencia | FileReferenceList EventDispatcher Object |
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Para trabajar con la clase FileReferenceList:
- Cree una instancia de la clase:
var myFileRef = new FileReferenceList();
- Llama al método
FileReferenceList.browse()
, que abre un cuadro de diálogo en el que el usuario puede seleccionar uno o varios archivos para la carga:myFileRef.browse();
- Después de llamar correctamente al método
browse()
, la propiedadfileList
del objeto FileReferenceList se llena con un conjunto de objetos FileReference. - Llame a
FileReference.upload()
en cada elemento del conjuntofileList
.
La clase FileReferenceList incluye un método browse()
y una propiedad fileList
para trabajar con varios archivos. Mientras se ejecuta una llamada a FileReferenceList.browse()
, la reproducción del archivo SWF se detiene en las versiones autónomas y externas de Flash Player y en AIR para Linux y Mac OS X 10.1 y versiones anteriores.
Elementos de API relacionados
Propiedad | Definido por | ||
---|---|---|---|
constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | ||
fileList : Array [solo lectura]
Conjunto de objetos FileReference. | FileReferenceList |
Método | Definido por | ||
---|---|---|---|
Crea un nuevo objeto FileReferenceList. | FileReferenceList | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento. | EventDispatcher | ||
Muestra un cuadro de diálogo de búsqueda de archivos en el que el usuario puede seleccionar uno o varios archivos locales para la carga. | FileReferenceList | ||
Distribuye un evento en el flujo del evento. | EventDispatcher | ||
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | EventDispatcher | ||
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 | ||
Elimina un detector del objeto EventDispatcher. | EventDispatcher | ||
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 | ||
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. | EventDispatcher |
Evento | Resumen | Definido por | ||
---|---|---|---|---|
[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos. | EventDispatcher | |||
Se distribuye cuando el usuario cierra el cuadro de diálogo de búsqueda de archivos. | FileReferenceList | |||
[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos. | EventDispatcher | |||
Se distribuye cuando el usuario selecciona uno o varios archivos para la carga en el cuadro de diálogo de búsqueda de archivos. | FileReferenceList |
fileList | propiedad |
fileList:Array
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Un conjunto de objetos FileReference
.
Cuando se ha llamado al método FileReferenceList.browse()
y el usuario ha seleccionado uno o varios archivos del cuadro de diálogo que ha abierto el método browse()
, esta propiedad se llena con un conjunto de objetos FileReference. Cada uno representa un archivo seleccionado por el usuario. A continuación puede utilizar este conjunto para cargar cada archivo con el método FileReference.upload()
. Debe cargar los archivos de uno en uno.
La propiedad fileList
se llena cada vez que se llama a browse() en ese objeto FileReferenceList.
Las propiedades de los objetos FileReference
se describen en la documentación de la clase FileReference.
Implementación
public function get fileList():Array
Elementos de API relacionados
FileReferenceList | () | Información sobre |
public function FileReferenceList()
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Crea un nuevo objeto FileReferenceList. Un objeto FileReferenceList no contiene nada si no se llama al método browse()
y si el usuario no selecciona uno o varios archivos. Cuando llama a browse()
en el objeto FileReference, la propiedad fileList
del objeto se llena con un conjunto de objetos FileReference
.
Elementos de API relacionados
browse | () | método |
public function browse(typeFilter:Array = null):Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Muestra un cuadro de diálogo de búsqueda de archivos en el que el usuario puede seleccionar uno o varios archivos locales para la carga. El cuadro de diálogo depende del sistema operativo del usuario.
En Flash Player 10 y versiones posteriores, es posible llamar correctamente a este método sólo como respuesta a un evento de usuario (por ejemplo, en un controlador de eventos de clic de ratón o de pulsación de tecla). En caso contrario, al llamar a este método Flash Player emite un error.
Cuando se llama a este método y el usuario selecciona archivos correctamente, la propiedad fileList
de este objeto FileReferenceList se llena con un conjunto de objetos FileReference, uno para cada archivo seleccionado por el usuario. Posteriormente, cada vez que se llama a al método FileReferenceList.browse() la propiedad del objeto FileReferenceList.fileList
se restablece según el archivo seleccionado por el usuario en el cuadro de diálogo.
Con el parámetro typeFilter
, se puede determinar qué archivos se mostrarán en el cuadro de diálogo.
Sólo se puede realizar una sesión FileReference.browse()
, FileReference.download()
o FileReferenceList.browse()
cada vez en un objeto FileReferenceList (porque no se puede abrir más de un cuadro de diálogo de forma simultánea).
Parámetros
typeFilter:Array (default = null ) — Un conjunto de instancias de FileFilter para filtrar los archivos que se muestran en el cuadro de diálogo. Si omite este parámetro, se mostrarán todos los archivos. Para más información, consulte la clase FileFilter.
|
Boolean — Devuelve true si los parámetros son válidos y abre el cuadro de diálogo de búsqueda de archivos.
|
Eventos
select: — Se invoca cuando el usuario selecciona correctamente en el cuadro de diálogo un elemento para la carga.
| |
cancel: — Se invoca cuando el usuario cancela el cuadro de diálogo haciendo clic en Cancelar o cerrándolo.
|
Emite
IllegalOperationError — Se emite por los motivos siguientes: 1) Hay otra sesión e búsqueda de FileReference o FileReferenceList en curso; sólo se puede realizar una sesión de búsqueda de archivos cada vez. 2) Un ajuste del archivo mms.cfg del usuario prohíbe esta operación.
| |
ArgumentError — Si el conjunto typeFilter no contiene objetos FileFilter con el formato correcto, se emitirá una excepción. Para más información sobre el formato de los filtros, consulte la documentación de FileFilter.
| |
Error — Si no se llama al método como respuesta a la acción de un usuario, como un evento de ratón o de pulsación de tecla.
|
Elementos de API relacionados
cancel | Evento |
flash.events.Event
propiedad Event.type =
flash.events.Event.CANCEL
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Se distribuye cuando el usuario cierra el cuadro de diálogo de búsqueda de archivos. (Este cuadro de diálogo se abre cuando llama a los métodos FileReferenceList.browse()
, FileReference.browse()
o FileReference.download()
).
Event.CANCEL
define el valor de la propiedad type
de un objeto de evento cancel
.
Este evento tiene las propiedades siguientes:
Propiedad | Valor |
---|---|
bubbles | false |
cancelable | false ; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Referencia al objeto en el que se cancela la operación. |
Elementos de API relacionados
select | Evento |
flash.events.Event
propiedad Event.type =
flash.events.Event.SELECT
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Se distribuye cuando el usuario selecciona uno o varios archivos para la carga en el cuadro de diálogo de búsqueda de archivos. (Este cuadro de diálogo se abre cuando llama a los métodos FileReferenceList.browse()
, FileReference.browse()
o FileReference.download()
). Cuando un usuario selecciona un archivo y confirma la operación (por ejemplo, haciendo clic en Guardar), el objeto FileReferenceList
se llena con objetos FileReference que representan los archivos seleccionados por el usuario.
Event.SELECT
define el valor de la propiedad type
de un objeto de evento select
.
Este evento tiene las propiedades siguientes:
Propiedad | Valor |
---|---|
bubbles | false |
cancelable | false ; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto en el que se ha seleccionado un elemento. |
Elementos de API relacionados
complete
, que se distribuye al cargar cada archivo individual en el objeto FileReferenceList. El evento LIST_COMPLETE
de la clase FileReferenceListExample se distribuye cuando todos los archivos del objeto FileReferenceList se han cargado.
Para ejecutar este ejemplo, coloque un script creado para aceptar la carga de archivos en http://www.[yourDomain].com/yourUploadHandlerScript.cfm. En función de la ubicación del archivo SWF y el destino de la carga, también podría ser necesario compilar el archivo SWF con la opción Seguridad de reproducción local establecida como Acceder sólo a la red o actualizar la configuración de seguridad de Flash ® Player para que permita el acceso de este archivo a la red. Si el servidor de carga es remoto y ejecuta este ejemplo en el equipo de escritorio, el servidor debe contener un archivo crossdomain.xml.
package { import flash.display.Sprite; import flash.events.*; import flash.net.FileReference; import flash.net.FileReferenceList; public class FileReferenceListExample extends Sprite { public static var LIST_COMPLETE:String = "listComplete"; public function FileReferenceListExample() { initiateFileUpload(); } private function initiateFileUpload():void { var fileRef:CustomFileReferenceList = new CustomFileReferenceList(); fileRef.addEventListener(FileReferenceListExample.LIST_COMPLETE, listCompleteHandler); fileRef.browse(fileRef.getTypes()); } private function listCompleteHandler(event:Event):void { trace("listCompleteHandler"); } } } import flash.events.*; import flash.net.FileReference; import flash.net.FileReferenceList; import flash.net.FileFilter; import flash.net.URLRequest; class CustomFileReferenceList extends FileReferenceList { private var uploadURL:URLRequest; private var pendingFiles:Array; public function CustomFileReferenceList() { uploadURL = new URLRequest(); uploadURL.url = "http://www.[yourDomain].com/yourUploadHandlerScript.cfm"; initializeListListeners(); } private function initializeListListeners():void { addEventListener(Event.SELECT, selectHandler); addEventListener(Event.CANCEL, cancelHandler); } public function getTypes():Array { var allTypes:Array = new Array(); allTypes.push(getImageTypeFilter()); allTypes.push(getTextTypeFilter()); return allTypes; } private function getImageTypeFilter():FileFilter { return new FileFilter("Images (*.jpg, *.jpeg, *.gif, *.png)", "*.jpg;*.jpeg;*.gif;*.png"); } private function getTextTypeFilter():FileFilter { return new FileFilter("Text Files (*.txt, *.rtf)", "*.txt;*.rtf"); } private function doOnComplete():void { var event:Event = new Event(FileReferenceListExample.LIST_COMPLETE); dispatchEvent(event); } private function addPendingFile(file:FileReference):void { trace("addPendingFile: name=" + file.name); pendingFiles.push(file); file.addEventListener(Event.OPEN, openHandler); file.addEventListener(Event.COMPLETE, completeHandler); file.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler); file.addEventListener(ProgressEvent.PROGRESS, progressHandler); file.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); file.upload(uploadURL); } private function removePendingFile(file:FileReference):void { for (var i:uint; i < pendingFiles.length; i++) { if (pendingFiles[i].name == file.name) { pendingFiles.splice(i, 1); if (pendingFiles.length == 0) { doOnComplete(); } return; } } } private function selectHandler(event:Event):void { trace("selectHandler: " + fileList.length + " files"); pendingFiles = new Array(); var file:FileReference; for (var i:uint = 0; i < fileList.length; i++) { file = FileReference(fileList[i]); addPendingFile(file); } } private function cancelHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("cancelHandler: name=" + file.name); } private function openHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("openHandler: name=" + file.name); } private function progressHandler(event:ProgressEvent):void { var file:FileReference = FileReference(event.target); trace("progressHandler: name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal); } private function completeHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("completeHandler: name=" + file.name); removePendingFile(file); } private function httpErrorHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("httpErrorHandler: name=" + file.name); } private function ioErrorHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("ioErrorHandler: name=" + file.name); } private function securityErrorHandler(event:Event):void { var file:FileReference = FileReference(event.target); trace("securityErrorHandler: name=" + file.name + " event=" + event.toString()); } }
Tue Jun 12 2018, 02:12 PM Z