WARNING: Most of this content (with the exception of the Mozilla 1.9 XPCOM reference) is very old, and can be expected to be out of date and possibly obsolete. For better XUL documentation, please visit the XUL hub at the Mozilla Developer Center.

nsITaggingService

IID:e39cea60-7e6d-4c8b-80a3-997af1c2cbcb
Inherits From:nsISupports

This interface is implemented by the following components:

Properties

readonly nsIVariant allTags

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

Methods

void getTagsForURI ( nsIURI URI , out PRUint32 length , out arrayof PRUnichar* tags ) nsIVariant getURIsForTag ( AString tag ) void tagURI ( nsIURI URI , nsIVariant tags ) void untagURI ( nsIURI URI , nsIVariant tags )

void getTagsForURI ( nsIURI URI , out PRUint32 length , out arrayof PRUnichar* tags )

Retrieves all tags set for the given URL.

Arguments:
URI: a URL.
length
tags

nsIVariant getURIsForTag ( AString tag )

Retrieves all URLs tagged with the given tag.

Arguments:
tag: tag name

void tagURI ( nsIURI URI , nsIVariant tags )

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

Arguments:
URI: the URL to tag.
tags: Array of tags to set for the given URL.

void untagURI ( nsIURI URI , nsIVariant tags )

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

Arguments:
URI: the URL to un-tag.
tags: Array of tags to unset. pass null to remove all tags from the given url.

Reference documentation is generated from Mozilla's source.