nsINavHistoryResultViewer 编辑

toolkit/components/places/public/nsINavHistoryService.idlScriptable Lets nsINavHistoryResult instances notify Places views of changes in the results. Removed in Gecko 2.0 and replaced with the nsINavHistoryResultObserver interface, which is similar but allows multiple clients to observe the result at once. 1.0 66 Introduced Gecko 1.9 Obsolete Gecko 2.0 Inherits from: nsISupports Last changed in Gecko 1.9.2 (Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)

Obsolete since Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)
This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.

Note: Most methods in this interface were renamed in Gecko 1.9.2, and others have slightly different parameter lists.

Method overview

void containerClosed(in nsINavHistoryContainerResultNode aContainerNode);

void containerOpened(in nsINavHistoryContainerResultNode aContainerNode);

void invalidateContainer(in nsINavHistoryContainerResultNode aContainerNode);

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

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

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

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

void nodeIconChanged(in nsINavHistoryResultNode aNode);

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

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

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

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

void nodeTagsChanged(in nsINavHistoryResultNode aNode);

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

void nodeReplaced(in nsINavHistoryContainerResultNode parent, in nsINavHistoryResultNode oldItem, in nsINavHistoryResultNode newItem, in unsigned long index);

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

void sortingChanged(in unsigned short sortingMode);

Attributes

Attribute	Type	Description
result	nsINavHistoryResult	The nsINavHistoryResult this viewer monitors. Although this attribute is read-write, you should not alter it directly; instead, use the nsINavHistoryResult.viewer attribute to set the viewer.

Methods

containerClosed()

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

 void containerClosed(
   in nsINavHistoryContainerResultNode aContainerNode
 );

Parameters

aContainerNode

The container node whose state changed.

containerOpened()

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

 void containerOpened(
   in nsINavHistoryContainerResultNode aContainerNode
 );

Parameters

aContainerNode

The container node whose state changed.

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 hanged.

nodeDateAddedChanged()

Called right after the date added property of a node has changed.

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

Parameters

aNode

The node whose title has changed.

aNewValue

The new value for the node's date added property.

nodeLastModifiedChanged()

Called right after the last modified date property of a node has changed.

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

Parameters

aNode

The node whose title has changed.

aNewValue

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

nodeHistoryDetailsChanged()

Called right after a node's last access time or access count has 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 the icon of a node has changed.

void nodeIconChanged(
  in nsINavHistoryResultNode aNode
);

Parameters

aNode

The node whose icon has changed.

nodeKeywordChanged()

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

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

Parameters

aNode

The node whose title has changed.

aNewTitle

The new value for the node's keyword 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.

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

Parameters

aNode

The moved item.

aOldParent

The item's old parent.

aOldIndex

The item's index in the old parent.

aNewParent

The item's new parent.

aNewIndex

The item's index in the new parent.

Remarks

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.

nodeTitleChanged()

Called right after the title of a node 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 title has changed.

aNewURI

The node's new URI.

nodeRemoved()

Called when a node is removed from a container.

 void itemRemoved(
   in nsINavHistoryContainerResultNode aParent,
   in nsINavHistoryResultNode aNode,
   in unsigned long aOldIndex
 );

Parameters

parent

The container from which the item was removed.

item

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

oldIndex

The index from which the item was removed.

Remarks

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).

nodeTagsChanged()

Called right after a node's tags have changed.

void nodeTagsChanged(
  in nsINavHistoryResultNode aNode
);

Parameters

aNode

The node whose tags have changed.

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 in which the item is being replaced.

aOldNode

The item being replaced.

aNewNode

The node replacing the aOldNode.

aIndex

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

nodeInserted()

Called when an item is inserted into a container.

 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.

Remarks

The item previously at the specified index (if any) as well as everything below it, is shifted down by one.

sortingChanged()

Called when the sorting order is changed to a particular mode. For trees, this would update the column headers to reflect the altered sorting.

 void sortingChanged(
   in unsigned short sortingMode
 );

Parameters

sortingMode

One of the nsINavHistoryQueryOptions.SORT_BY_* constants, indicating the softing mode.

Remarks

This method is only called to update the sorting user interface. invalidateAll() is called as well if the sorting changes, in order to cause the contents to update properly.

See also

nsINavHistoryResult, nsITreeView, Displaying Places information using views