nsITaggingService in Firefox 3.6a1pre

Implemented by

@mozilla.org/browser/tagging-service;1

[scriptable, uuid(e39cea60-7e6d-4c8b-80a3-997af1c2cbcb)]

Attributes

 Retrieves all tags used to tag URIs in the data-base (sorted by name).

readonly attribute nsIVariant allTags

Methods

 Retrieves all tags set for the given URL.

 @param aURI
        a URL.
 @returns array of tags (sorted by name).

void getTagsForURI(in nsIURI aURI, out unsigned long length, [array, size_is(length), retval] out wstring aTags)

 Retrieves all URLs tagged with the given tag.

 @param aTag
        tag name
 @returns Array of uris tagged with aTag.

nsIVariant getURIsForTag(in AString aTag)

 Tags a URL with the given set of tags. Current tags set for the URL
 persist. Tags in aTags which are already set for the given URL are
 ignored.

 @param aURI
        the URL to tag.
 @param aTags
        Array of tags to set for the given URL. Each element within the
        array can be either a tag name or a concrete itemId of a tag
        container.

void tagURI(in nsIURI aURI, in nsIVariant aTags)

 Removes tags from a URL. Tags from aTags which are not set for the
 given URL are ignored.

 @param aURI
        the URL to un-tag.
 @param aTags
        Array of tags to unset. pass null to remove all tags from the given
        url. Each element within the array can be either a tag name or a
        concrete itemId of a tag container.

void untagURI(in nsIURI aURI, in nsIVariant aTags)