Skip to main content

Visit Mozilla.org

nsIContentPrefService

出典: MDC

この記事は Firefox 3 の新機能について述べています

nsIContentPrefService は、拡張機能やブラウザのコードにおいて、特定の URI のための設定を保存する方法を提供します。設定項目はキーと値のペアで URI ごとに保存されます。使用例は Using content preferences を参照してください。

目次

nsIContentPrefService は toolkit/components/contentprefs/public/nsIContentPrefService.idl で定義されています。これは scriptable で 非凍結です。 (Mozilla 1.9から更新されていません)

継承元: nsISupports

実装: @mozilla.org/content-pref/service;1。インスタンスを作成するには、以下のように記述します。 

var prefService = Components.classes["@mozilla.org/content-pref/service;1"]
                  .getService(Components.interfaces.nsIContentPrefService);

[編集] メソッドの概要

void addObserver(in AString aName, in nsIContentPrefObserver aObserver);
nsIVariant getPref(in nsIURI aURI, in AString aName);
nsIPropertyBag2 getPrefs(in nsIURI aURI);
boolean hasPref(in nsIURI aURI, in AString aName);
void removeObserver(in AString aName, in nsIContentPrefObserver aObserver);
void removePref(in nsIURI aURI, in AString aName);
void setPref(in nsIURI aURI, in AString aName, in nsIVariant aValue);

[編集] 属性

属性 型 説明
grouper nsIContentURIGrouper URI が属するグループを判別するのにサービスが使用するコンポーネント。デフォルトでは、これは完全なホスト名で (つまりサイトごとに) URI をグループ化する「hostname grouper」になります。

[編集] メソッド

[編集] getPref()

特定の URI のために保存された設定の値を返します。 

 nsIVariant getPref(
   in nsIURI aURI,
   in AString aName
 );
[編集] 引数
aURI
設定を取得する URI。グローバル設定空間から設定を取得する場合は null を指定します。グローバル設定はすべての URI に適用されます。
aName
値を取得する設定の名前。
[編集] 戻り値

設定の値が返されます。これには、文字列、整数値、真偽値、あるいはその他の値が含まれる可能性があります。指定された名前で保存されている値がなく、設定の値が null (nsIDataType:VTYPE_EMPTY) もしくは undefined (nsIDataType:VTYPE_VOID) であった場合、結果は null になる場合があります。

[編集] setPref()

特定の URI のために設定の値を設定します。 

 nsIVariant setPref(
   in nsIURI aURI,
   in AString aName,
   in nsIVariant aValue
 );
[編集] 引数
aURI
設定を保存する URI。グローバル設定空間にある設定を設定する場合は null を指定します。グローバル設定はすべての URI に適用されます。
aName
値を設定する設定の名前。
aValue
設定に割り当てる値。

[編集] hasPref()

特定の設定項目が存在するかどうかを判別します。 

 boolean hasPref(
   in nsIURI aURI,
   in AString aName
 );
[編集] 引数
aURI
設定項目が存在するかどうかを判別する URI。グローバル設定空間にある設定を判別する場合は null を指定します。
aName
設定項目が存在するかどうかを判別する設定の名前。
[編集] 戻り値

設定が存在する場合は true、存在しなければ false。

[編集] removePref()

特定の設定項目を削除します。 

 void removePref(
   in nsIURI aURI,
   in AString aName
 );
[編集] 引数
aURI
削除する設定の URI。グローバル設定空間にある設定を削除する場合は null を指定します。
aName
削除する設定の名前。

[編集] getPrefs()

特定の URI のための設定とそれらの値をすべて含んだ nsIPropertyBag2 を返します。 

 nsIPropertyBag2 getPrefs(
   in nsIURI aURI,
 );
[編集] 引数
aURI
取得したい設定の URI。グローバル設定空間にある設定を取得する場合は null を指定します。
[編集] 戻り値

設定とそれらの値をすべて含んだ nsIPropertyBag2。

[編集] addObserver()

特定の設定の変更を監視するオブザーバを追加します。 

 void addObserver(
   in AString aName,
   in nsIContentPrefObserver aObserver
 );
[編集] 引数
aName
監視を行う設定の名前。すべての設定の変更を監視する包括的オブザーバを追加する場合は null を指定します。
aObserver
設定の値が変更された場合に通知を受ける nsIContentPrefObserver を実装したオブジェクトの名前。

[編集] removeObserver()

特定の設定の変更を監視している既存のオブザーバを削除します。 

 void addObserver(
   in AString aName,
   in nsIContentPrefObserver aObserver
 );
[編集] 引数
aName
監視を停止する設定の名前。すべての設定の変更を監視する包括的オブザーバを削除する場合は null を指定します。
aObserver
設定の値が変更された場合に通知を受けるオブザーバの名前。

[編集] 関連記事

nsIContentPrefObserver, Using content preferences

"http://developer.mozilla.org/ja/docs/nsIContentPrefService" より作成