Allows clients to observe what is happening to a result as it updates itself
according to history and bookmark system events. Register this observer on a
result using nsINavHistoryResult::addObserver.
Called when ‘aItem’ is inserted into ‘aParent’ at index ‘aNewIndex’.
The item previously at index (if any) and everything below it will have
been shifted down by one. The item may be a container or a leaf.
Called whan ‘aItem’ is removed from ‘aParent’ at ‘aOldIndex’. The item
may be a container or a leaf. This function will be called after the item
has been removed from its parent list, but before anything else (including
NULLing out the item’s parent) has happened.
Called whan ‘aItem’ is moved from ‘aOldParent’ at ‘aOldIndex’ to
aNewParent at aNewIndex. The item may be a container or a leaf.
XXX: 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.
Called right after aNode’s title has changed.
| aNode | a result node |
| aNewTitle | the new title |
Called right after aNode’s uri property has changed.
| aNode | a result node |
| aNewURI | the new uri |
Called right after aNode’s icon property has changed.
@note: The new icon is accessible through aNode.icon.
| aNode | a result node |
Called right after aNode’s time property or accessCount property, or both,
have changed.
| aNode | a uri result node |
| aNewVisitDate | the new visit date |
| aNewAccessCount | the new access-count |
Called when the tags set on the uri represented by aNode have changed.
@note: The new tags list is accessible through aNode.tags.
| aNode | a uri result node |
Called right after the aNode’s keyword property has changed.
| aNode | a uri result node |
| aNewKeyword | the new keyword |
Called right after an annotation of aNode’s has changed (set, altered, or
unset).
| aNode | a result node |
| aAnnoName | the name of the annotation that changed |
Called right after aNode’s dateAdded property has changed.
| aNode | a result node |
| aNewValue | the new value of the dateAdded property |
Called right after aNode’s dateModified property has changed.
| aNode | a result node |
| aNewValue | the new value of the dateModified property |
Called after a container changes state.
| aContainerNode | The container that has changed state. |
| aOldState | The state that aContainerNode has transitioned out of. |
| aNewState | The state that aContainerNode has transitioned into. |
Called when something significant has happened within the container. The
contents of the container should be re-built.
| aContainerNode | the container node to invalidate |
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 won’t be
applicable.
This only is expected to update the sorting UI. invalidateAll() will also
get called if the sorting changes to update everything.
| sortingMode | One of nsINavHistoryQueryOptions.SORT_BY_* that indicates the new sorting mode. |
This is called to indicate that a batch operation is about to start or end.
The observer could want to disable some events or updates during batches,
since multiple operations are packed in a short time.
For example treeviews could temporarily suppress select notifications.
| aToggleMode | true if a batch is starting, false if it's ending. |
Called by the result when this observer is added.