Resumen
La interfaz nsILocalFile representa un archivo o un directorio en una manera independiente de la plataforma, que es accesible en el sistema de archivos local. Por ello, incrementa nsIFile.
#include "nsILocalFile.h"
[scriptable, uuid=(aa610f20-a889-11d3-8c81-000064657374)]
interface nsILocalFile : nsIFile { ... };
Métodos
-
initWithPath - Éste método es usado para establecer el path completo a que hace referencia nsILocalFile.
-
initWithNativePath - Éste método es usado para establecer el path completo a que hace referencia nsILocalFile references. [variante con los caractéres especiales locales]
-
initWithFile - Éste método se usa para inicializar un nsILocalFile desde otro nsILocalFile.
-
openNSPRFileDesc - Éste método se usa para abrir el archivo correspondiente a este nsILocalFile.
-
openANSIFileDesc - Éste método se usa para abrir el archivo correspondiente a este nsILocalFile.
-
load - Éste método se usa para abrir la librería (enlazada dinámicamente) correspondiente a nsILocalFile.
-
appendRelativePath - Éste método es usado para agregar un path relativo al nsILocalFile en curso.
-
appendRelativeNativePath - Éste método es usado para agregar un path relativo al nsILocalFile en curso. [variante con los caractéres especiales locales]
-
reveal - Éste método solicita que el sistema operativo revele éste nsILocalFile al usuario. No implementado en algunas plataformas.
-
launch - Éste método solicita que el sistema operativo intente abrir éste nsILocalFile. No implementado en algunas plataformas.
-
getRelativeDescriptor - Éste método devuelve una representación multi-plataforma del path relativo de un archivo.
-
setRelativeDescriptor - Éste método inicializa un nsILocalFile a partir de la descripción relativa obtenida de getRelativeDescriptor.
Atributos
-
followLinks - Éste atributo determina si el nsILocalFile resolverá o no, enlaces simbólicos.
-
diskSpaceAvailable - Éste atributo presenta la cantidad de espacio disponible en el disco que contiene el nsILocalFile.
-
persistentDescriptor - Éste atributo presenta una cadena, dependiente de la plataforma, representando el nsILocalFile.
Observaciones
Los métodos initWithNativePath y appendRelativeNativePath toman parámetros representados por cadenas que son codificados usando el sistema de códigos local. Esto significa que no puedes usar nombres con caracteres fuera de la página de códigos de Windows, aunque Windows 2000 y posteriores no tengan problema en manejarlos. Por tanto, nunca uses funciones a no ser que estés absolutamente seguro de que el path que pasan es siempre ASCII. Ver nsIFile para más información sobre los códigos de caractéres locales.
launch y reveal están sólo implementados en Windows, MacOSX, BeOS y OS/2 (a fecha 2007/03/14, FX3.0, Gecko 1.9). En sistemas *nix-ish tales como Linux, BSDs, Solaris o similares ninguna de estas dos funciones harán nada más que devolver inmediatamente un valor NS_ERROR_FAILURE. Ver bug 391980 para más información.
Para trabajar con esos sistemas también, querrás considerar el atajo de Firefox Download Manager. Para un poco de "inspiración" ver: https://mxr.mozilla.org/seamonkey/sou...t/downloads.js
Historia
Este interfaz fue congelado por Mozilla 1.0. Ver bug 129279 para más detalles.