mozilla
Your Search Results

    nsIProperties

    This interface provides methods to access a map of named XPCOM object values.
    Inherits from: nsISupports Last changed in Gecko 1.2

    Implemented by: @mozilla.org/file/directory_service;1. To get an instance, use:

    var properties = Components.classes["@mozilla.org/file/directory_service;1"]
                     .getService(Components.interfaces.nsIProperties);
    

    Method overview

    void get(in string prop, in nsIIDRef iid, [iid_is(iid),retval] out nsQIResult result);
    void getKeys(out PRUint32 count, [array, size_is(count), retval] out string keys);
    boolean has(in string prop);
    void set(in string prop, in nsISupports value);
    void undefine(in string prop);

    Methods

    get()

    Gets the XPCOM object associated with a particular name.

    void get(
      in string prop,
      in nsIIDRef iid,
      [iid_is(iid),retval] out nsQIResult result
    );
    
    Parameters
    prop
    The property name.
    iid
    The desired interface.
    result
    The resulting object instance.
    Exceptions thrown
    NS_ERROR_FAILURE
    If the property does not exist.
    NS_ERROR_NO_INTERFACE
    If the property exists, but does not support the requested interface.

    getKeys()

    Returns an array of property names.

    nsMemory.h defines the macro NS_FREE_XPCOM_ALLOCATED_POINTER_ARRAY, which can be used to free aKeys when it is no longer needed.

    void getKeys(
      out PRUint32 count,
      [array, size_is(count), retval] out string keys
    );
    
    Parameters
    count
    The length of the result array.
    keys
    The resulting array of keys.

    has()

    Tests if a property exists.

    boolean has(
      in string prop
    );
    
    Parameters
    prop
    The property name.
    Return value

    true if the property exists, false if the property does not exist.

    set()

    Sets the XPCOM object associated with a particular name.

    void set(
      in string prop,
      in nsISupports value
    );
    
    Parameters
    prop
    The property name.
    value
    The XPCOM object value to associate with prop.

    undefine()

    Undefines a property.

    void undefine(
      in string prop
    );
    
    Parameters
    prop
    The property name.

    Remarks

    This interface was frozen for Gecko 1.2. See bug 162114 for details. From Gecko 2.0 interfaces are no longer frozen.

    Document Tags and Contributors

    Contributors to this page: Sheppy, Jiaofeng, Nickolay, trevorh, Ted_Mielczarek, Pmash, Dria
    Last updated by: Sheppy,