nsINavHistoryResultObserver 编辑

toolkit/components/places/nsINavHistoryService.idlScriptable Lets clients observe changes to a result as the result updates itself according to bookmark and history system events. 1.0 66 Introduced Gecko 2.0 Inherits from: nsISupports Last changed in Gecko 11.0 (Firefox 11.0 / Thunderbird 11.0 / SeaMonkey 2.8) Note: In Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1), this interface replaced the older nsINavHistoryResultViewer interface, which only allowed one client at a time.

Method overview

void batching(in boolean aToggleMode);

void containerClosed(in nsINavHistoryContainerResultNode aContainerNode); Deprecated since Gecko 2.0 Obsolete since Gecko 11.0

void containerOpened(in nsINavHistoryContainerResultNode aContainerNode); Deprecated since Gecko 2.0 Obsolete since Gecko 11.0

void containerStateChanged(in nsINavHistoryContainerResultNode aContainerNode, in unsigned long aOldState, in unsigned long aNewState);

void invalidateContainer(in nsINavHistoryContainerResultNode aContainerNode);

void nodeAnnotationChanged(in nsINavHistoryResultNode aNode, in AUTF8String aAnnoName);

void nodeDateAddedChanged(in nsINavHistoryResultNode aNode, in PRTime aNewValue);

void nodeHistoryDetailsChanged(in nsINavHistoryResultNode aNode, in PRTime aNewVisitDate, in unsigned long aNewAccessCount);

void nodeIconChanged(in nsINavHistoryResultNode aNode);

void nodeInserted(in nsINavHistoryContainerResultNode aParent, in nsINavHistoryResultNode aNode, in unsigned long aNewIndex);

void nodeKeywordChanged(in nsINavHistoryResultNode aNode, in AUTF8String aNewKeyword);

void nodeLastModifiedChanged(in nsINavHistoryResultNode aNode, in PRTime aNewValue);

void nodeMoved(in nsINavHistoryResultNode aNode, in nsINavHistoryContainerResultNode aOldParent, in unsigned long aOldIndex, in nsINavHistoryContainerResultNode aNewParent, in unsigned long aNewIndex);

void nodeRemoved(in nsINavHistoryContainerResultNode aParent, in nsINavHistoryResultNode aItem, in unsigned long aOldIndex);

void nodeReplaced(in nsINavHistoryContainerResultNode aParentNode, in nsINavHistoryResultNode aOldNode, in nsINavHistoryResultNode aNewNode, in unsigned long aIndex);

void nodeTagsChanged(in nsINavHistoryResultNode aNode);

void nodeTitleChanged(in nsINavHistoryResultNode aNode, in AUTF8String aNewTitle);

void nodeURIChanged(in nsINavHistoryResultNode aNode, in AUTF8String aNewURI);

void sortingChanged(in unsigned short sortingMode);

Attributes

Attribute	Type	Description
result	nsINavHistoryResult	The nsINavHistoryResult this observer monitors. Although this attribute is read-write, you should not alter it directly; instead, call nsINavHistoryResult.addObserver() to add an observer to a result.

Methods

batching()

Lets the observer know when a batch operation in Places is about to start or end. The observer can then pause updates or events until the batch is completed, so that it won't handle the large number of updates that are about to be notified. This is especially useful when updating user interfaces, to avoid flicker or continuous selection changes, which may result in performance degradation (for example, if updating a view for each update).

void batching(
  in boolean aToggleMode
);

Parameters

aToggleMode

Specify true to start batch mode or false to finish the batch.

containerClosed()

Obsolete since Gecko 11.0 (Firefox 11.0 / Thunderbird 11.0 / SeaMonkey 2.8)

Called when a container node's state changes from opened to closed.

Note: This method was deprecated in Gecko 2.0 and removed in Gecko 11.0 (Firefox 11.0 / Thunderbird 11.0 / SeaMonkey 2.8). Implement the containerStateChanged() method instead.

 void containerClosed(
   in nsINavHistoryContainerResultNode aContainerNode
 );

Parameters

aContainerNode

The container node which was closed.

containerOpened()

Obsolete since Gecko 11.0 (Firefox 11.0 / Thunderbird 11.0 / SeaMonkey 2.8)

Called when a container node's state changes from closed to opened.

Note: This method was deprecated in Gecko 2.0 and removed in Gecko 11.0 (Firefox 11.0 / Thunderbird 11.0 / SeaMonkey 2.8). Implement the containerStateChanged() method instead.

 void containerOpened(
   in nsINavHistoryContainerResultNode aContainerNode
 );

Parameters

aContainerNode

The container node which was opened.

containerStateChanged()

Called when a container node's state changes.

void containerStateChanged(
  in nsINavHistoryContainerResultNode aContainerNode,
  in unsigned long aOldState,
  in unsigned long aNewState
);

Parameters

aContainerNode

The container node whose state changed.

aOldState

The prior state of the node; this will be one of the nsINavHistoryContainerResultNode.State constants.

aNewState

The new state of the node; this is one of the nsINavHistoryContainerResultNode.State constants.

invalidateContainer()

Called when something has happened that requires that the contents of a container be rebuilt.

void invalidateContainer(
  in nsINavHistoryContainerResultNode aContainerNode
);

Parameters

aContainerNode

The container that should be rebuilt.

nodeAnnotationChanged()

Called right after the annotation on a node has changed. This is called when the annotation is changed, set, or unset.

void nodeAnnotationChanged(
  in nsINavHistoryResultNode aNode,
  in AUTF8String aAnnoName
);

Parameters

aNode

The node whose title has changed.

aAnnoName

The name of the annotation that changed.

nodeDateAddedChanged()

Called right after the dateAdded property property of a node has changed.

void nodeDateAddedChanged(
  in nsINavHistoryResultNode aNode,
  in PRTime aNewValue
);

Parameters

aNode

The node whose dateAdded property has changed.

aNewValue

The new value of the dateAdded property.

nodeHistoryDetailsChanged()

Called right after a node's time property or accessCount property, or both, have changed.

void nodeHistoryDetailsChanged(
  in nsINavHistoryResultNode aNode,
  in PRTime aNewVisitDate,
  in unsigned long aNewAccessCount
);

Parameters

aNode

The node whose details have changed.

aNewVisitDate

The new value for the last visit date and time for the node.

aNewAccessCount

The new access count value for the node.

nodeIconChanged()

Called right after a node's icon property has changed.

void nodeIconChanged(
  in nsINavHistoryResultNode aNode
);

Parameters

aNode

The node whose icon has changed.

nodeInserted()

Called when an item is inserted into a container. The item previously at the specified index (if any) and everything below it is shifted down by one.

 void nodeInserted(
   in nsINavHistoryContainerResultNode aParent,
   in nsINavHistoryResultNode aNode,
   in unsigned long aNewIndex
 );

Parameters

aParent

The container into which to insert the item.

aNode

The node to insert into the container; it may be either a leaf or another container.

aNewIndex

The index at which to insert the item.

nodeKeywordChanged()

Called right after the a node's keyword property has changed.

void nodeKeywordChanged(
  in nsINavHistoryResultNode aNode,
  in AUTF8String aNewKeyword
);

Parameters

aNode

The node whose keyword property has changed.

aNewKeyword

The new value for the node's keyword property.

nodeLastModifiedChanged()

Called right after a node's dateModified property has changed.

void nodeLastModifiedChanged(
  in nsINavHistoryResultNode aNode,
  in PRTime aNewValue
);

Parameters

aNode

The node whose last modified property has changed.

aNewValue

The new value for the node's last modified property.

nodeMoved()

Called when a node is moved from aOldParent at aOldIndex to aNewParent at aNewIndex. The item may be a container or a leaf.

At the moment, this method is called only when an item is moved within the same container. When an item is moved between containers, a new node is created for the item, and the itemRemoved/itemAdded methods are used.

void nodeMoved(
  in nsINavHistoryResultNode aNode,
  in nsINavHistoryContainerResultNode aOldParent,
  in unsigned long aOldIndex,
  in nsINavHistoryContainerResultNode aNewParent,
  in unsigned long aNewIndex
);

Parameters

aNode

The moved node.

aOldParent

The node's old parent.

aOldIndex

The node's index in the old parent.

aNewParent

The node's new parent.

aNewIndex

The node's index in the new parent.

nodeRemoved()

Called when a item is removed from a container. The item may be a container or a leaf.

This method is called after the item has been removed from the parent, but before any other action is taken (including zeroing out the item's parent reference).

void nodeRemoved(
   in nsINavHistoryContainerResultNode aParent,
  in nsINavHistoryResultNode aItem,
   in unsigned long aOldIndex
 );

Parameters

aParent

The container from which the item was removed.

aItem

The item that was removed from the container. It may be either a container or a leaf.

aOldIndex

The index from which the item was removed.

nodeReplaced()

Called when a node is being replaced with another node at the same location.

void nodeReplaced(
  in nsINavHistoryContainerResultNode aParentNode,
   in nsINavHistoryResultNode aOldNode,
   in nsINavHistoryResultNode aNewNode,
   in unsigned long aIndex
 );

Parameters

aParentNode

The container (parent node) in which the item is being replaced.

aOldNode

The node which is being replaced.

aNewNode

The node replacing the aOldNode.

aIndex

The index at which the node is located in the container.

nodeTagsChanged()

Called right after a node's tags have changed.

void nodeTagsChanged(
  in nsINavHistoryResultNode aNode
);

Parameters

aNode

The node whose tags have changed.

nodeTitleChanged()

Called right after a node's title has changed.

void nodeTitleChanged(
  in nsINavHistoryResultNode aNode,
  in AUTF8String aNewTitle
);

Parameters

aNode

The node whose title has changed.

aNewTitle

The new title of the node.

nodeURIChanged()

Called right after the URI of a node has changed.

void nodeURIChanged(
  in nsINavHistoryResultNode aNode,
  in AUTF8String aNewURI
);

Parameters

aNode

The node whose URI has changed.

aNewURI

The node's new URI.

sortingChanged()

This is called to indicate to the UI that the sort has changed to the given mode. For trees, for example, this would update the column headers to reflect the sorting. For many other types of views, this will not be applicable.

 void sortingChanged(
   in unsigned short sortingMode
 );

Parameters

sortingMode

One of the nsINavHistoryQueryOptions.Sorting methods, indicating the new sorting mode.

See also

• nsINavHistoryResult
• nsITreeView
• Displaying Places information using views