nsIDynamicContainer

nsIDynamicContainerインタフェースは一時的なコンテンツのコンテナを提供するベースクラスを提供します。この機能はコンテナがオープンされたタイミングで、ノードを直接満たすことができます。すべてのリザルトノードのプロパティをそれぞれのアイテムに関連したデータを保存するのに利用できます。（例えばディスク上でのフルパスなど)また、それぞれのコンテナに対してサービスに関連付けられた追加のコンテナを作成することができます。

継承元: nsISupports

メソッドの概要

void onContainerNodeOpening(in nsINavHistoryContainerResultNode aContainer, in nsINavHistoryQueryOptions aOptions);
void onContainerNodeClosed(in nsINavHistoryContainerResultNode aContainer);
void onContainerRemoving(in long long aItemId);
void onContainerMoved(in long long aItemId, in long long aNewParent, in long aNewIndex);

メソッド

onContainerNodeOpening()

与えられたコンテナノードが新たにノードが作成されようとするときに呼ばれます。
必要であればノードの作成を実行することができます。

void onContainerNodeOpening(
  in nsINavHistoryContainerResultNode aContainer,
  in nsINavHistoryQueryOptions aOptions
);

引数

aContainer

これから開かれようとしているコンテナノード

aOptions

このクエリを生成するために使われるオプション。コンテナは可能ならばこれらに従います。もしクエリとフォルダノードをコンテナに追加しようとしている場合、実装は可能ならばこの値を使用しないといけません。この値を変更してはいけません。

onContainerNodeClosed()

与えられたコンテナがなくなるときに呼ばれます。従って、必要なクリーンアップ処理を実行することができます。このメソッドが呼びだされることは保証されていません。具体的にはクエリがどこかへ行ってしまったときには呼ばれません。この現象はコンテナ自身がopen状態からclose状態へ遷移したときにのみ起こります。実際の処理ではかなり大量の動的に生成されたノードがこのメソッドをクリーンアップ処理のために呼び出します。

void onTainerNodeClosed(
  in nsINavHistoryContainerResultNode aContainer
);

引数

aContainer

hoge

onContainerRemoving()

与えられたコンテナがブックマークテーブルから削除されようとするときに呼ばれます。従って、必要なクリーンアップ処理を実行することができます。このメソッドはコンテナが削除される前に呼ばれます、従って処理では依然としてコンテナを参照することができます。

void onContainerRemoving(
  in long long aItemId
);

引数

aItemId

コンテナアイテムのアイテムID。

onContainerMoved()

与えられたコンテナが丁度移動されようとしているときに呼ばれます。bookkeepingを行う処理に備えて存在します。このメソッドはコンテナが移動された後に呼ばれます。

関連記事

• Places
• nsINavHistoryContainerResultNode
• nsINavHistoryQueryOptions