nsILocalFile

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 67001 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: http://mxr.mozilla.org/seamonkey/sou...t/downloads.js

Historia

Este interfaz fue congelado por Mozilla 1.0. Ver bug 129279 para más detalles.