Recursos de Flash CS4

Objeto FLfile

Disponibilidad

Flash MX 2004 7.2.

Descripción

El objeto FLfile permite escribir extensiones de Flash que pueden acceder, modificar y eliminar archivos y carpetas en el sistema local de archivos. La API FLfile se proporciona en forma de una extensión en la API JavaScript. Esta extensión se denomina shared library (biblioteca compartida) y se ubica en la siguiente carpeta:

Windows Vista:

unidad de arranque\Users\nombre de usuario\Local Settings\Application Data\Adobe\Flash CS3\idioma\Configuration\External Libraries\FLfile.dll
Windows XP:

unidad de arranque\Documents and Settings\nombre de usuario\Local Settings\Application Data\Adobe\Flash CS3\idioma\Configuration\External Libraries\FLfile.dll
Mac OS X:

Macintosh HD/Usuarios/nombre de usuario /Librería/Application Support/Adobe/Flash CS3/idioma /Configuration/External Libraries/FLfile.dll

Nota: no confunda las bibliotecas compartidas que contienen símbolos en los documentos de Flash con las bibliotecas compartidas de la API JavaScript. Se trata de dos cosas diferentes.

Los métodos FLfile trabajan con archivos o carpetas (directorios) en disco. Por lo tanto, cada método adopta uno o varios parámetros para especificar la ubicación de un archivo o carpeta. La ubicación del archivo o carpeta se expresa como una cadena de forma muy similar a una dirección URL de un sitio Web. Se denomina un URI (Identificador uniforme de recursos) de archivo y se le aplica formato tal y como se muestra a continuación (incluyendo las comillas):

"file:///drive|/folder 1/folder 2/.../filename"

Por ejemplo, si desea crear una carpeta en la unidad C denominada config y situarla en la carpeta Program Files/MyApp, utilice el siguiente comando:

FLfile.createFolder("file:///C|/Program Files/MyApp/config");

Si desea ubicar un archivo llamado config.ini en esa carpeta, utilice el siguiente comando:

FLfile.write("file:///C|/Program Files/MyApp/config/config.ini", "");

Para crear una carpeta en Macintosh, puede utilizar el siguiente comando:

FLfile.createFolder("file:///Macintosh/MyApp/config");

Resumen de métodos

Se pueden emplear los siguientes métodos con el objeto FLfile:

Método	Descripción
`FLfile.copy()`	Copia un archivo.
`FLfile.createFolder()`	Crea una o varias carpetas.
`FLfile.exists()`	Determina la existencia de un archivo o carpeta.
`FLfile.getAttributes()`	Averigua si un archivo se puede modificar, es de sólo lectura, está oculto o visible o está en una carpeta del sistema.
`FLfile.getCreationDate()`	Especifica cuántos segundos han transcurrido entre el 1 de enero de 1970 y la hora de creación del archivo o carpeta.
`FLfile.getCreationDateObj()`	Obtiene la fecha de creación de un archivo o carpeta.
`FLfile.getModificationDate()`	Especifica cuántos segundos han transcurrido entre el 1 de enero de 1970 y la hora de modificación del archivo o carpeta.
`FLfile.getModificationDateObj()`	Obtiene la fecha en la que se modificó un archivo o carpeta por última vez.
`FLfile.getSize()`	Obtiene el tamaño de un archivo.
`FLfile.listFolder()`	Enumera el contenido de una carpeta.
`FLfile.platformPathToURI()`	Convierte un nombre de archivo en un formato específico de plataforma en una URI file:///.
`FLfile.read()`	Lee el contenido de un archivo.
`FLfile.remove()`	Elimina un archivo o carpeta.
`FLfile.setAttributes()`	Hace que un archivo o carpeta se pueda modificar, que sea de sólo lectura o se encuentre oculto o visible.
`FLfile.uriToPlatformPath()`	Convierte un nombre de archivo expresado como URI file:/// en un formato concreto de la plataforma.
`FLfile.write()`	Crea, se añade o escribe en un archivo.