nsINavHistoryResultObserver

  • Revision slug: nsINavHistoryResultObserver
  • Revision title: nsINavHistoryResultObserver
  • Revision id: 57245
  • Created:
  • Creator: trevorh
  • Is current revision? Yes
  • Comment 2 words added, 2 words removed

Revision Content

{{ IFSummary("toolkit/components/places/nsINavHistoryService.idl", "nsISupports", "Scriptable", "11.0", "Lets clients observe changes to a result as the result updates itself according to bookmark and history system events.", "2.0") }}

Note: In Gecko 2.0 {{ geckoRelease("2.0") }}, this interface replaced the older {{ interface("nsINavHistoryResultViewer") }} interface, which only allowed one client at a time.

Method overview

void batching(in boolean aToggleMode);
void containerClosed(in nsINavHistoryContainerResultNode aContainerNode); {{ deprecated_inline("2.0") }} {{ obsolete_inline("11.0") }}
void containerOpened(in nsINavHistoryContainerResultNode aContainerNode); {{ deprecated_inline("2.0") }} {{ obsolete_inline("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 {{ Interface("nsINavHistoryResult") }} The {{ Interface("nsINavHistoryResult") }} this observer monitors. Although this attribute is read-write, you should not alter it directly; instead, call {{ ifmethod("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.

{{ method_obsolete_gecko("containerClosed","11.0") }}

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 {{ geckoRelease("11.0") }}. Implement the {{ manch("containerStateChanged") }} method instead.
 void containerClosed(
   in nsINavHistoryContainerResultNode aContainerNode
 );
Parameters
aContainerNode
The container node which was closed.

{{ method_obsolete_gecko("containerOpened","11.0") }}

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 {{ geckoRelease("11.0") }}. Implement the {{ manch("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 {{ interfaceconstants("nsINavHistoryContainerResultNode","State constants") }}.
aNewState
The new state of the node; this is one of the {{ interfaceconstants("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 {{ interfaceconstants("nsINavHistoryQueryOptions","Sorting methods") }}, indicating the new sorting mode.

See also

Revision Source

<p>{{ IFSummary("toolkit/components/places/nsINavHistoryService.idl", "nsISupports", "Scriptable", "11.0", "Lets clients observe changes to a result as the result updates itself according to bookmark and history system events.", "2.0") }}</p>
<div class="note"><strong>Note:</strong> In Gecko 2.0 {{ geckoRelease("2.0") }}, this interface replaced the older {{ interface("nsINavHistoryResultViewer") }} interface, which only allowed one client at a time.</div>
<h2 id="Method_overview" name="Method_overview">Method overview</h2>
<table class="standard-table"> <tbody> <tr> <td><code>void <a href="#batching()">batching</a>(in boolean aToggleMode);</code></td> </tr> <tr> <td><code>void <a href="#containerClosed()">containerClosed</a>(in nsINavHistoryContainerResultNode aContainerNode);</code> {{ deprecated_inline("2.0") }} {{ obsolete_inline("11.0") }}</td> </tr> <tr> <td><code>void <a href="#containerOpened()">containerOpened</a>(in nsINavHistoryContainerResultNode aContainerNode);</code> {{ deprecated_inline("2.0") }} {{ obsolete_inline("11.0") }}</td> </tr> <tr> <td><code>void <a href="#containerStateChanged()">containerStateChanged</a>(in nsINavHistoryContainerResultNode aContainerNode, in unsigned long aOldState, in unsigned long aNewState);</code></td> </tr> <tr> <td><code>void <a href="#invalidateContainer()">invalidateContainer</a>(in nsINavHistoryContainerResultNode aContainerNode);</code></td> </tr> <tr> <td><code>void <a href="#nodeAnnotationChanged()">nodeAnnotationChanged</a>(in nsINavHistoryResultNode aNode, in AUTF8String aAnnoName);</code></td> </tr> <tr> <td><code>void <a href="#nodeDateAddedChanged()">nodeDateAddedChanged</a>(in nsINavHistoryResultNode aNode, in PRTime aNewValue);</code></td> </tr> <tr> <td><code>void <a href="#nodeHistoryDetailsChanged()">nodeHistoryDetailsChanged</a>(in nsINavHistoryResultNode aNode, in PRTime aNewVisitDate, in unsigned long aNewAccessCount);</code></td> </tr> <tr> <td><code>void <a href="#nodeIconChanged()">nodeIconChanged</a>(in nsINavHistoryResultNode aNode);</code></td> </tr> <tr> <td><code>void <a href="#nodeInserted()">nodeInserted</a>(in nsINavHistoryContainerResultNode aParent, in nsINavHistoryResultNode aNode, in unsigned long aNewIndex);</code></td> </tr> <tr> <td><code>void <a href="#nodeKeywordChanged()">nodeKeywordChanged</a>(in nsINavHistoryResultNode aNode, in AUTF8String aNewKeyword);</code></td> </tr> <tr> <td><code>void <a href="#nodeLastModifiedChanged()">nodeLastModifiedChanged</a>(in nsINavHistoryResultNode aNode, in PRTime aNewValue);</code></td> </tr> <tr> <td><code>void <a href="#nodeMoved()">nodeMoved</a>(in nsINavHistoryResultNode aNode, in nsINavHistoryContainerResultNode aOldParent, in unsigned long aOldIndex, in nsINavHistoryContainerResultNode aNewParent, in unsigned long aNewIndex);</code></td> </tr> <tr> <td><code>void <a href="#nodeRemoved()">nodeRemoved</a>(in nsINavHistoryContainerResultNode aParent, in nsINavHistoryResultNode aItem, in unsigned long aOldIndex);</code></td> </tr> <tr> <td><code>void <a href="#nodeReplaced()">nodeReplaced</a>(in nsINavHistoryContainerResultNode aParentNode, in nsINavHistoryResultNode aOldNode, in nsINavHistoryResultNode aNewNode, in unsigned long aIndex);</code></td> </tr> <tr> <td><code>void <a href="#nodeTagsChanged()">nodeTagsChanged</a>(in nsINavHistoryResultNode aNode);</code></td> </tr> <tr> <td><code>void <a href="#nodeTitleChanged()">nodeTitleChanged</a>(in nsINavHistoryResultNode aNode, in AUTF8String aNewTitle);</code></td> </tr> <tr> <td><code>void <a href="#nodeURIChanged()">nodeURIChanged</a>(in nsINavHistoryResultNode aNode, in AUTF8String aNewURI);</code></td> </tr> <tr> <td><code>void <a href="#sortingChanged()">sortingChanged</a>(in unsigned short sortingMode);</code></td> </tr> </tbody>
</table>
<h2 id="Attributes" name="Attributes">Attributes</h2>
<table class="standard-table"> <tbody> <tr> <td class="header">Attribute</td> <td class="header">Type</td> <td class="header">Description</td> </tr> <tr> <td><code>result</code></td> <td>{{ Interface("nsINavHistoryResult") }}</td> <td>The {{ Interface("nsINavHistoryResult") }} this observer monitors. Although this attribute is read-write, you should not alter it directly; instead, call {{ ifmethod("nsINavHistoryResult", "addObserver") }} to add an observer to a result.</td> </tr> </tbody>
</table>
<h2 id="Methods" name="Methods">Methods</h2>
<h3 id="batching()" name="batching()">batching()</h3>
<p>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).</p>
<pre class="eval">void batching(
  in boolean aToggleMode
); 
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>aToggleMode</code></dt> <dd>Specify <code>true</code> to start batch mode or <code>false</code> to finish the batch.</dd>
</dl>
<p>{{ method_obsolete_gecko("containerClosed","11.0") }}</p>
<p>Called when a container node's state changes from opened to closed.</p>
<div class="note"><strong>Note:</strong> This method was deprecated in Gecko 2.0 and removed in Gecko 11.0 {{ geckoRelease("11.0") }}. Implement the {{ manch("containerStateChanged") }} method instead.</div>
<pre class="eval"> void containerClosed(
   in nsINavHistoryContainerResultNode aContainerNode
 );
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>aContainerNode</code></dt> <dd>The container node which was closed.</dd>
</dl>
<p>{{ method_obsolete_gecko("containerOpened","11.0") }}</p>
<p>Called when a container node's state changes from closed to opened.</p>
<div class="note"><strong>Note:</strong> This method was deprecated in Gecko 2.0 and removed in Gecko 11.0 {{ geckoRelease("11.0") }}. Implement the {{ manch("containerStateChanged") }} method instead.</div>
<pre class="eval"> void containerOpened(
   in nsINavHistoryContainerResultNode aContainerNode
 );
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>aContainerNode</code></dt> <dd>The container node which was opened.</dd>
</dl>
<h3 id="containerStateChanged()" name="containerStateChanged()">containerStateChanged()</h3>
<p>Called when a container node's state changes.</p>
<pre class="eval">void containerStateChanged(
  in nsINavHistoryContainerResultNode aContainerNode,
  in unsigned long aOldState,
  in unsigned long aNewState
);
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>aContainerNode</code></dt> <dd>The container node whose state changed.</dd> <dt><code>aOldState</code></dt> <dd>The prior state of the node; this will be one of the {{ interfaceconstants("nsINavHistoryContainerResultNode","State constants") }}.</dd> <dt><code>aNewState</code></dt> <dd>The new state of the node; this is one of the {{ interfaceconstants("nsINavHistoryContainerResultNode","State constants") }}.</dd>
</dl>
<h3 id="invalidateContainer()" name="invalidateContainer()">invalidateContainer()</h3>
<p>Called when something has happened that requires that the contents of a container be rebuilt.</p>
<pre class="eval">void invalidateContainer(
  in nsINavHistoryContainerResultNode aContainerNode
);
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>aContainerNode</code></dt> <dd>The container that should be rebuilt.</dd>
</dl>
<h3 id="nodeAnnotationChanged()" name="nodeAnnotationChanged()">nodeAnnotationChanged()</h3>
<p>Called right after the annotation on a node has changed. This is called when the annotation is changed, set, or unset.</p>
<pre class="eval">void nodeAnnotationChanged(
  in nsINavHistoryResultNode aNode,
  in AUTF8String aAnnoName
);
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>aNode</code></dt> <dd>The node whose title has changed.</dd> <dt><code>aAnnoName</code></dt> <dd>The name of the annotation that changed.</dd>
</dl>
<h3 id="nodeDateAddedChanged()" name="nodeDateAddedChanged()">nodeDateAddedChanged()</h3>
<p>Called right after the dateAdded property property of a node has changed.</p>
<pre class="eval">void nodeDateAddedChanged(
  in nsINavHistoryResultNode aNode,
  in PRTime aNewValue
);
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>aNode</code></dt> <dd>The node whose dateAdded property has changed.</dd> <dt><code>aNewValue</code></dt> <dd>The new value of the dateAdded property.</dd>
</dl>
<h3 id="nodeHistoryDetailsChanged()" name="nodeHistoryDetailsChanged()">nodeHistoryDetailsChanged()</h3>
<p>Called right after a node's time property or accessCount property, or both, have changed.</p>
<pre class="eval">void nodeHistoryDetailsChanged(
  in nsINavHistoryResultNode aNode,
  in PRTime aNewVisitDate,
  in unsigned long aNewAccessCount
);
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>aNode</code></dt> <dd>The node whose details have changed.</dd> <dt><code>aNewVisitDate</code></dt> <dd>The new value for the last visit date and time for the node.</dd> <dt><code>aNewAccessCount</code></dt> <dd>The new access count value for the node.</dd>
</dl>
<h3 id="nodeIconChanged()" name="nodeIconChanged()">nodeIconChanged()</h3>
<p>Called right after a node's icon property has changed.</p>
<pre class="eval">void nodeIconChanged(
  in nsINavHistoryResultNode aNode
);
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>aNode</code></dt> <dd>The node whose icon has changed.</dd>
</dl>
<h3 id="nodeInserted()" name="nodeInserted()">nodeInserted()</h3>
<p>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.</p>
<pre class="eval"> void nodeInserted(
   in nsINavHistoryContainerResultNode aParent,
   in nsINavHistoryResultNode aNode,
   in unsigned long aNewIndex
 );
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>aParent</code></dt> <dd>The container into which to insert the item.</dd> <dt><code>aNode</code></dt> <dd>The node to insert into the container; it may be either a leaf or another container.</dd> <dt><code>aNewIndex</code></dt> <dd>The index at which to insert the item.</dd>
</dl>
<h3 id="nodeKeywordChanged()" name="nodeKeywordChanged()">nodeKeywordChanged()</h3>
<p>Called right after the a node's keyword property has changed.</p>
<pre class="eval">void nodeKeywordChanged(
  in nsINavHistoryResultNode aNode,
  in AUTF8String aNewKeyword
);
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>aNode</code></dt> <dd>The node whose keyword property has changed.</dd> <dt><code>aNewKeyword</code></dt> <dd>The new value for the node's keyword property.</dd>
</dl>
<h3 id="nodeLastModifiedChanged()" name="nodeLastModifiedChanged()">nodeLastModifiedChanged()</h3>
<p>Called right after a node's dateModified property has changed.</p>
<pre class="eval">void nodeLastModifiedChanged(
  in nsINavHistoryResultNode aNode,
  in PRTime aNewValue
);
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>aNode</code></dt> <dd>The node whose last modified property has changed.</dd> <dt><code>aNewValue</code></dt> <dd>The new value for the node's last modified property.</dd>
</dl>
<h3 id="nodeMoved()" name="nodeMoved()">nodeMoved()</h3>
<p>Called when a node is moved from <code>aOldParent</code> at <code>aOldIndex</code> to <code>aNewParent</code> at <code>aNewIndex</code>. The item may be a container or a leaf.</p>
<p>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.</p>
<pre class="eval">void nodeMoved(
  in nsINavHistoryResultNode aNode,
  in nsINavHistoryContainerResultNode aOldParent,
  in unsigned long aOldIndex,
  in nsINavHistoryContainerResultNode aNewParent,
  in unsigned long aNewIndex
);
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>aNode</code></dt> <dd>The moved node.</dd> <dt><code>aOldParent</code></dt> <dd>The node's old parent.</dd> <dt><code>aOldIndex</code></dt> <dd>The node's index in the old parent.</dd> <dt><code>aNewParent</code></dt> <dd>The node's new parent.</dd> <dt><code>aNewIndex</code></dt> <dd>The node's index in the new parent.</dd>
</dl>
<h3 id="nodeRemoved()" name="nodeRemoved()">nodeRemoved()</h3>
<p>Called when a item is removed from a container. The item may be a container or a leaf.</p>
<p>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).</p>
<pre class="eval">void nodeRemoved(
   in nsINavHistoryContainerResultNode aParent,
  in nsINavHistoryResultNode aItem,
   in unsigned long aOldIndex
 );
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>aParent</code></dt> <dd>The container from which the item was removed.</dd> <dt><code>aItem</code></dt> <dd>The item that was removed from the container. It may be either a container or a leaf.</dd> <dt><code>aOldIndex</code></dt> <dd>The index from which the item was removed.</dd>
</dl>
<h3 id="nodeReplaced()" name="nodeReplaced()">nodeReplaced()</h3>
<p>Called when a node is being replaced with another node at the same location.</p>
<pre class="eval">void nodeReplaced(
  in nsINavHistoryContainerResultNode aParentNode,
   in nsINavHistoryResultNode aOldNode,
   in nsINavHistoryResultNode aNewNode,
   in unsigned long aIndex
 );
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>aParentNode</code></dt> <dd>The container (parent node) in which the item is being replaced.</dd> <dt><code>aOldNode</code></dt> <dd>The node which is being replaced.</dd> <dt><code>aNewNode</code></dt> <dd>The node replacing the <code>aOldNode</code>.</dd> <dt><code>aIndex</code></dt> <dd>The index at which the node is located in the container.</dd>
</dl>
<h3 id="nodeTagsChanged()" name="nodeTagsChanged()">nodeTagsChanged()</h3>
<p>Called right after a node's tags have changed.</p>
<pre class="eval">void nodeTagsChanged(
  in nsINavHistoryResultNode aNode
);
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>aNode</code></dt> <dd>The node whose tags have changed.</dd>
</dl>
<h3 id="nodeTitleChanged()" name="nodeTitleChanged()">nodeTitleChanged()</h3>
<p>Called right after a node's title has changed.</p>
<pre class="eval">void nodeTitleChanged(
  in nsINavHistoryResultNode aNode,
  in AUTF8String aNewTitle
);
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>aNode</code></dt> <dd>The node whose title has changed.</dd> <dt><code>aNewTitle</code></dt> <dd>The new title of the node.</dd>
</dl>
<h3 id="nodeURIChanged()" name="nodeURIChanged()">nodeURIChanged()</h3>
<p>Called right after the URI of a node has changed.</p>
<pre class="eval">void nodeURIChanged(
  in nsINavHistoryResultNode aNode,
  in AUTF8String aNewURI
);
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>aNode</code></dt> <dd>The node whose URI has changed.</dd> <dt><code>aNewURI</code></dt> <dd>The node's new URI.</dd>
</dl>
<h3 id="sortingChanged()" name="sortingChanged()">sortingChanged()</h3>
<p>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.</p>
<pre class="eval"> void sortingChanged(
   in unsigned short sortingMode
 );
</pre>
<h6 id="Parameters" name="Parameters">Parameters</h6>
<dl> <dt><code>sortingMode</code></dt> <dd>One of the {{ interfaceconstants("nsINavHistoryQueryOptions","Sorting methods") }}, indicating the new sorting mode.</dd>
</dl>
<h2 id="See_also" name="See_also">See also</h2>
<ul> <li>{{ Interface("nsINavHistoryResult") }}</li> <li>{{ Interface("nsITreeView") }}</li> <li><a class="internal" href="/en/Displaying_Places_information_using_views" title="En/Displaying Places information using views">Displaying Places information using views</a></li>
</ul>
Revert to this revision