nsILocalFile

 

 

« XPCOM API Reference

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: 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.

 

Etiquetas y colaboradores del documento

 Colaboradores en esta página: teoli, HenryGR, Mgjbot
 Última actualización por: teoli,