--- title: fuelIAnnotations slug: Toolkit_API/FUEL/fuelIAnnotations tags: - FUEL - Firefox - Interfaces - XPCOM - XPCOM API Reference translation_of: Mozilla/Tech/Toolkit_API/FUEL/fuelIAnnotations ---
{{ Fx_minversion_header(3) }} 注釈サービスは Firefox 3 にて Web ページに関する任意のデータを保存するために設計されました。

メソッドの概要

boolean has(in AString aName)
nsIVariant get(in AString aName)
void set(in AString aName, in nsIVariant aValue, in PRInt32 aExpiration)
void remove(in AString aName)

プロパティ

プロパティ名 型 説明
names 読取専用属性 nsIVariant この注釈オブジェクトを所有するブックマークアイテムに関連付けられたすべての注釈の名前の配列

メソッド

has()

指定した名前の注釈が存在するかどうかを調べる。

boolean has(in AString aName)

引数

aName
注釈の名前。

戻り値

指定した名前の注釈が存在すれば true、さもなくば false。

get()

指定した名前の注釈の値を取得する。

nsIVariant get(in AString aName)

引数

aName
注釈の名前。

戻り値

注釈の値を含む変数。文字列、真偽値、数値をサポートする。

set()

指定した名前の注釈へ値をセットする。

void set(in AString aName, in nsIVariant aValue, in PRInt32 aExpiration)

引数

aName
注釈の名前。
aValue
注釈の値。文字列、真偽値、数値をサポートする。
aExpiration
注釈の有効期限ポリシー。 nsIAnnotationService 参照。

戻り値

remove()

この注釈オブジェクトを所有するブックマークアイテムから、指定した名前の注釈を削除する。

void remove(in AString aName)

引数

aName
注釈の名前。

戻り値

例

const NEVER_EXPIRE = 0;

function url(spec) {
  var ios = Cc["@mozilla.org/network/io-service;1"].getService(Ci.nsIIOService);
  return ios.newURI(spec, null, null);
}

var bookmark = Application.bookmarks.menu.addBookmark("Mozilla", url("http://www.mozilla.com/"));
bookmark.annotations.set("mystuff/public", true, NEVER_EXPIRE);
bookmark.annotations.set("mystuff/rating", 5, NEVER_EXPIRE);

alert(bookmark.annotations.get("mystuff/rating"));

bookmark.annotations.remove("mystuff/rating");

参照