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を行う処理に備えて存在します。このメソッドはコンテナが移動された後に呼ばれます。