Uploadify - Eventos, Métodos y Propiedades
Propiedades
 
  • Input
    • Multi
      Indica si permite o no la selección múltiple (Falso por defecto).
    • AutomaticUpload
      De manera automática carga los archivos que son adicionados a la cola. Si está en falso es necesario llamar al método Start para iniciar la carga (Verdadero por defecto).
    • ButtonText
      El texto que aparece en el botón.
    • ButtonImage
      La URL de la imagen que se utilizará como el botón de búsqueda.
    • SizeLimit
      El tamaño límite en kilobytes para cada archivo a cargar (por defecto 5120 kB).
      Esta validación es realizada en el lado del cliente antes de enviar los datos al servidor.
    • SimultaneousUploadLimit
      Límite de cargas que pueden ejecutarse de manera simultánea por cada instancia de Uploadify (por defecto 1).
    • File-type filtering
      Las siguientes propiedades son utilizadas en conjunto. Las propiedades "FileDescription" y "FileExtension" indican si se desea filtrar por un determinado tipo de archivo, por ejemplo, documento Excel, imágenes, etc.
      En este ejemplo la propiedad "FileDescription" tiene el valor "Images" y la propiedad "FileExtension" el valor "*.jpg" (soporta además una colección de tipos, en la versión flash: *.jpg;*.png;*.jpeg;*.gif;*.bmp y en la versión Html5: *.jpg,*.png,*.jpeg,*.gif,*.bmp.  A partir de la version 3.5.0 se asignan a la variable &fileExtensionList, asociada a la propiedad FileExtension del control: 
      Event Start 
	FileExtensionList.Add("*.jpg") 
	FileExtensionList.Add("*.png") 
	FileExtensionList.Add("*.jpeg") 
	FileExtensionList.Add("*.gif") 
	FileExtensionList.Add("*.bmp") 
EndEvent
      • FileExtension
        Una lista de extensiones de archivo que son permitidas para la carga. 
      • FileDescription (solamente versión Flash)
        El texto que aparecerá en el menú desplegable de la caja de diálogo que se abre al buscar los archivos para la carga.
    • UploadScript(avanzado)
      El camino al script del back-end que procesará la carga de archivos. No necesariamente incluye un valor en esta propiedad. Útil para el uso de otro servidor como manipulador de cargas o si es requerida una URL especial para acceder al recurso upload.aspx/upload servlet.
    • Media Capture (Solo para navegadores mobile - Solo Uploadify HTML5)
      • Allow Capture Camera
      • Allow Capture Video
      • Allow Capture Audio
      • Allow Image Selection
      • Allow Video Selection
      • Allow Audio Selection
    • Output
      • UploadedFiles
        En esta propiedad se tiene la información de cada archivo cargado, si se carga un archivo solamente habrá un registro.
      • QueuedFiles
        Muestra la información de cada archivo seleccionado y que aun no se ha cargado. Tan pronto como se termine la carga de un archivo es eliminado de esta lista.
      • Error (solamente en tiempo de ejecución)
        Al ocurrir un error en esta propiedad se podrá encontrar un texto explicando lo ocurrido.
      • File (solamente en tiempo de ejecución)
        Es un archivo temporal, cuando una carga dispara un error en esta propiedad se encuentra el archivo que lo causó. Además, al seleccionar un archivo (al dispararse OnSelect), cuando el usuario cancela la carga de un archivo..
        Esta propiedad retorna un UploadifyOutput (se incluye el SDT).
 
Eventos
 
  • OnComplete
    Se dispara una vez por cada archivo al completar su carga.
  • OnAllComplete
    Se dispara una vez cuando todos los archivos terminaron de ser cargados.
  • OnError
    Se dispara al ocurrir algún error al cargar los archivos.
    En la propiedad "Error" se podrá encontrar un texto explicando lo ocurrido y en la propiedad "File" se encontrará información sobre el archivo que lo causó.
  • OnCancel
    Se dispara una vez por cada archivo cancelado por el usuario (por cada archivo eliminado de la lista que se encuentra en la propiedad "QueuedFiles").
  • OnSelect
    Se dispara una vez por cada archivo seleccionado por el usuario (por cada archivo añadido a la lista de archivos a cargar).
    En la propiedad "File" se encontrará información acerca del archivo a cargar.
    En la propiedad "QueuedFiles" encontrará todos los elementos seleccionados para la carga y que aun no se han cargado.
  • OnSelectOnce
    Se dispara cada vez que un archivo o grupo de estos es añadido a la lista de carga (útil cuando la selección múltiple está activada).
 
Métodos
 
  • Refresh
    Actualiza los valores de una instancia de Uploadify, útil al cambiar la propiedad "SizeLimit" en tiempo de ejecución o la imagen del botón.
  • Start
    Inicia la carga de archivos. Al utilizar "AutomaticUpload" en falso este método es el responsable de comenzar la carga de archivos.
  • Clean
    Este método limpia los valores de las propiedades QueuedFiles, UploadedFiles, Error y File.
 
 
Notas:
  • Al seleccionar un nuevo archivo para la carga, la propiedad UploadedFiles se vacía de forma automática.
  • Ninguno de los eventos que son disparados por el control son requeridos de forma obligatoria, utilice solamente aquellos que se ajusten a sus necesidades.
  • La variable "File" se crea de forma automática una vez que el control es arrastrado a la forma.
  • El tipo de dato File (llamado UploadifyOutput) tiene los siguientes miembros:
    • OriginalFileName
      El nombre original del archivo cargado.
    • TemporalFileName
      El nombre temporal completo (con camino) del archivo cargado.
    • FileSize
      El tamaño del archivo en bytes.
    • FileType
      El MIME type del archivo.
    • CreationDate
      La fecha cuando se creó el archivo.
    • ModificationDate
      La última fecha en la que el archivo fue modificado.
Páginas relacionadas: