The service can fill result nodes directly into the container when it is opened. It can use the property bag on every result node to store data associated with each item, such as a full path on disk. It can also create additional containers for each container, registered to its service.

Method overview

Methods

onContainerMoved()

This method is called when the given container has just been moved, in case the service needs to do any bookkeeping. It is called after the container has been moved.

void onContainerMoved(
  in long long aItemId,
  in long long aNewParent,
  in long aNewIndex
);

Parameters

aItemId

The item-id of the container item.

aNewParent

The item of the new parent folder for the container.

aNewIndex

The index at which the container will be inserted, or "-1" to append to the end of the list.

onContainerNodeClosed()

This method is called when the given container has just been collapsed so that the service can do any necessary cleanup. This is not guaranteed to get called. In particular, if the query just goes away, you will not get this call. This only happens when the container itself goes from the open state to the closed state. A service with large numbers of dynamically populated items might use this to do some cleanup so those items don't hang around.

void onContainerNodeClosed(
  in nsINavHistoryContainerResultNode aContainer
);

Parameters

aContainer

The container node of the container being closed. The service need not worry about removing any created nodes, they will be automatically removed when this call completes.

onContainerNodeOpening()

This method is called when the given container node is about to be populated so that the service can populate the container if necessary.

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

Parameters

aContainer

The container node for the container being opened.

aOptions

The options used to generate this query. Containers should follow these when possible, for example, whether to expand queries, etc. Implementations should use this when possible if adding query and folder nodes to the container. Do not modify this value.

onContainerRemoving()

This method is called when the given container is about to be deleted from the bookmarks table, so that the service can do any necessary cleanup. It is called before the container is deleted, so that the service can still reference it.

void onContainerRemoving(
  in long long aItemId
);

Parameters

aItemId

The item-id of the container item.

See also

• Places
• nsINavHistoryContainerResultNode
• nsINavHistoryQueryOptions
• nsINavBookmarksService.createDynamicContainer()