nsISupports
Last changed in Gecko 21.0 (Firefox 21.0 / Thunderbird 21.0 / SeaMonkey 2.18)Method overview
void onBeforeItemRemoved(in long long aItemId, in unsigned short aItemType, in long long aParentId, in ACString aGUID, in ACString aParentGUID); Obsolete since Gecko 21.0 |
void onBeginUpdateBatch(); |
void onEndUpdateBatch(); |
void onFolderAdded(in PRInt64 folder, in PRInt64 parent, in PRInt32 index); Obsolete since Gecko 1.9 |
void onFolderChanged(in PRInt64 folder, in ACString property); Obsolete since Gecko 1.9 |
void onFolderMoved(in PRInt64 folder, in PRInt64 oldParent, in PRInt32 oldIndex, in PRInt64 newParent, in PRInt32 newIndex); Obsolete since Gecko 1.9 |
void onFolderRemoved(in PRInt64 folder, in PRInt64 parent, in PRInt32 index); Obsolete since Gecko 1.9 |
void onItemAdded(in long long aItemId, in long long aParentId, in long aIndex, in unsigned short aItemType, in nsIURI aURI, in AUTF8String aTitle, in PRTime aDateAdded, in ACString aGUID, in ACString aParentGUID); |
void onItemChanged(in long long aItemId, in ACString aProperty, in boolean aIsAnnotationProperty, in AUTF8String aNewValue, in PRTime aLastModified, in unsigned short aItemType, in long long aParentId, in ACString aGUID, in ACString aParentGUID); |
void onItemMoved(in long long aItemId, in long long aOldParentId, in long aOldIndex, in long long aNewParentId, in long aNewIndex, in unsigned short aItemType, in ACString aGUID, in ACString aOldParentGUID, in ACString aNewParentGUID); |
void onItemRemoved(in long long aItemId, in long long aParentId, in long aIndex, in unsigned short aItemType, in nsIURI aURI, in ACString aGUID, in ACString aParentGUID); |
void onItemReplaced(in PRInt64 folder, in nsIURI item, in nsIURI newItem); Obsolete since Gecko 1.9 |
void onItemVisited(in long long aItemId, in long long aVisitId, in PRTime aTime, in unsigned long aTransitionType, in nsIURI aURI, in long long aParentId, in ACString aGUID, in ACString aParentGUID); |
void onSeparatorAdded(in PRInt64 parent, in PRInt32 index); Obsolete since Gecko 1.9 |
void onSeparatorRemoved(in PRInt64 parent, in PRInt32 index); Obsolete since Gecko 1.9 |
Methods
onBeforeItemRemoved()
Note: This method was removed in Gecko 21.0 as part of Bug 826409.
This method notifies this observer that an item is about to be removed. It is called before the actual removal takes place.
void onBeforeItemRemoved( in long long aItemId, in unsigned short aItemType, in long long aParentId, in ACString aGUID, in ACString aParentGUID );
Parameters
-
aItemId
- The id of the bookmark that will be removed.
-
aItemType
-
The type of the item that is about to be removed; this is one of the
nsINavBookmarksService.Type constants
. -
aParentId
- The id of the folder containing the item.
-
aGUID
- The unique ID associated with the item.
-
aParentGUID
- The unique ID associated with the item's parent.
onBeginUpdateBatch()
This method notifies this observer that a batch transaction has started. Other notifications will be sent during the batch change, but the observer is guaranteed that onEndUpdateBatch()
will be called at the completion of changes. During a batch the observer should do its best to reduce the work done to handle notifications, since multiple changes are going to happen in a short timeframe.
void onBeginUpdateBatch();
Parameters
None.
onEndUpdateBatch()
This method notifies this observer that a batch transaction has ended.
void onEndUpdateBatch();
Parameters
None.
onFolderAdded()
Notify this observer that a bookmark folder has been added.
void onFolderAdded( in PRInt64 folder, in PRInt64 parent, in PRInt32 index );
Parameters
-
folder
- The id of the folder that was added.
-
parent
- The id of the folder's parent.
-
index
- The folder's index inside its parent.
onFolderChanged()
Notify this observer that a bookmark folder's information has changed. This will be called whenever any attributes like "title" are changed.
void onFolderChanged( in PRInt64 folder, in ACString property );
Parameters
-
folder
- The id of the folder that was changed.
-
property
- The property that was changed.
onFolderMoved()
Notify this observer that a bookmark folder has been moved.
void onFolderMoved( in PRInt64 folder, in PRInt64 oldParent, in PRInt32 oldIndex, in PRInt64 newParent, in PRInt32 newIndex );
Parameters
-
folder
- The id of the folder that was moved.
-
oldParent
- The id of the folder's old parent.
-
oldIndex
- The folder's old index inside oldParent.
-
newParent
- The id of the folder's new parent.
-
newIndex
- The folder's index inside newParent.
onFolderRemoved()
Notify this observer that a bookmark folder has been removed.
void onFolderRemoved( in PRInt64 folder, in PRInt64 parent, in PRInt32 index );
Parameters
-
folder
- The id of the folder that was removed.
-
parent
- The id of the folder's old parent.
-
index
- The folder's old index in its parent.
onItemAdded()
This method notifies this observer that an item was added. It is called after the actual addition took place. When a new item is created, all the items following it in the same folder will have their index shifted down, but no additional notifications will be sent.
void onItemAdded( in long long aItemId, in long long aParentId, in long aIndex, in unsigned short aItemType, in nsIURI aURI, in AUTF8String aTitle, in PRTime aDateAdded, in ACString aGUID, in ACString aParentGUID );
Parameters
-
aItemId
- The id of the item that was added.
-
aParentId
- The id of the folder to which the item was added.
-
aIndex
- The item's index in the folder.
-
aItemType
-
The type of the item that was added. This should be one of the
nsINavBookmarksService.Type constants
. -
aURI
-
The URI of the item that was added when aItemType is
TYPE_BOOKMARK
,null
otherwise. -
aTitle
- The title of the added item.
-
aDateAdded
- The stored date added value, in microseconds from the epoch.
-
aGUID
- The unique ID associated with the item.
-
aParentGUID
- The unique ID associated with the item's parent.
onItemChanged()
This method notifies this observer that an item's information has changed. It is called whenever any attributes like "title" are changed.
void onItemChanged( in long long aItemId, in ACString aProperty, in boolean aIsAnnotationProperty, in AUTF8String aNewValue, in PRTime aLastModified, in unsigned short aItemType, in long long aParentId, in ACString aGUID, in ACString aParentGUID );
Parameters
-
aItemId
- The id of the item that was changed.
-
aProperty
- The property which changed. If this string is empty, all properties have been deleted. In this situation, you should not attempt to get any properties, since this will result in the automatic regeneration of properties that will then be leaked into the database, causing trouble later.
-
aIsAnnotationProperty
-
Indicates whether or not
aProperty
is the name of an item annotation. If this istrue
,aNewValue
is always an empty string. -
aNewValue
-
The items new value, if required by the property specified by
aProperty
. -
aLastModified
- The value to set the items last modified time to, or 0 if the value should remain unchanged.
-
aItemType
-
The type of the item that has been changed. This should be one of the
nsINavBookmarksService.Type constants
. -
aParentId
- The id of the folder containing the item.
-
aGUID
- The unique ID associated with the item.
-
aParentGUID
- The unique ID associated with the item's parent.
Notes
This table indicates what aNewValue
should be depending on property specified by aProperty
:
Property string | Value |
"cleartime" | Empty string; this property means the history was deleted, so there's no last visit date. |
"title" | The new title for the item |
"favicon" | The "moz-anno" URL for the new favicon image. |
"uri" | The new URI for the item. |
"tags" | Empty string; this property indicates that the set of tags for the item have changed. |
"dateAdded" | The PRTime at which the item was first added to the database. |
"lastModified" | The PRTime at which the item was last modified. |
onItemMoved()
This method notifies this observer that an item has been moved.
void onItemMoved( in long long aItemId, in long long aOldParentId, in long aOldIndex, in long long aNewParentId, in long aNewIndex, in unsigned short aItemType, in ACString aGUID, in ACString aOldParentGUID, in ACString aNewParentGUID );
Parameters
-
aItemId
- The id of the item that was moved.
-
aOldParentId
- The id of the old parent.
-
aOldIndex
-
The old index inside
aOldParentId
. -
aNewParentId
- The id of the new parent.
-
aNewIndex
-
The new index inside
aNewParentId
. -
aItemType
-
The type of the item that was moved. This should be one of the
nsINavBookmarksService.Type constants
. -
aGUID
- The unique ID associated with the item.
-
aOldParentGUID
- The unique ID associated with the old item's parent.
-
aNewParentGUID
- The unique ID associated with the new item's parent.
onItemRemoved()
This method notifies that an item was removed. It is called after the actual remove took place. When an item is removed, all the items following it in the same folder will have their index shifted down, but no additional notifications will be sent.
void onItemRemoved( in long long aItemId, in long long aParentId, in long aIndex, in unsigned short aItemType, in nsIURI aURI, in ACString aGUID, in ACString aParentGUID );
Parameters
-
aItemId
- The ID of the item that was removed.
-
aParentId
- The ID of the folder from which the item was removed.
-
aIndex
- The index of the item that was removed from the folder.
-
aItemType
-
The type of the item that was removed. This should be one of the
nsINavBookmarksService.Type constants
. -
aURI
-
The URI of the added item if it was TYPE_BOOKMARK,
null
otherwise. -
aGUID
- The unique ID associated with the item.
-
aParentGUID
- The unique ID associated with the item's parent.
onItemReplaced()
Notify this observer that a bookmark has been replaced.
void onItemReplaced( in PRInt64 folder, in nsIURI item, in nsIURI newItem );
Parameters
-
folder
- The folder in which the bookmark was replaced.
-
item
- The item which was replaced.
-
newItem
- The new item which replaced item.
onItemVisited()
This method notifies that the item was visited. Can be invoked only for TYPE_BOOKMARK
items.
Normally in bookmarks we use the last visit date, and normally the time will be a new visit that will be more recent, but this is not guaranteed. You should check to see if it is actually more recent before using this new time.
See onItemChanged()
method property = "cleartime" for when all visit dates are deleted for the URI.
void onItemVisited( in long long aItemId, in long long aVisitId, in PRTime aTime, in unsigned long aTransitionType, in nsIURI aURI, in long long aParentId, in ACString aGUID, in ACString aParentGUID );
Parameters
-
aItemId
- The id of the bookmark that was visited.
-
aVisitId
- The id of the item visit.
-
aTime
- The time of the visit.
-
aTransitionType
-
The transition for the visit. See
nsINavBookmarksService.Transaction constants
for a list of possible values. -
aURI
-
The
nsIURI
for this bookmark. -
aParentId
- The id of the folder containing the item.
-
aGUID
- The unique ID associated with the item.
-
aParentGUID
- The unique ID associated with the item's parent.
onSeparatorAdded()
Notify this observer that a separator has been added.
void onSeparatorAdded( in PRInt64 parent, in PRInt32 index );
Parameters
-
parent
- The id of the separator's parent.
-
index
- The separator's index inside its parent.
onSeparatorRemoved()
Notify this observer that a separator has been removed.
void onSeparatorRemoved( in PRInt64 parent, in PRInt32 index );
Parameters
-
parent
- The id of the separator's parent.
-
index
- The separator's old index in its parent.
Using onBeforeItemRemoved() in Gecko 1.9.1
If you wish to support onBeforeItemRemoved()
in applications based on Gecko 1.9.1, you must implement your observer's QueryInterface()
method to match on both nsINavBookmarkObserver
and nsINavBookmarkObserver_MOZILLA_1_9_1_ADDITIONS
, as shown below.
QueryInterface: function(iid) { if (iid.equals(Ci.nsINavBookmarkObserver) || iid.equals(Ci.nsINavBookmarkObserver_MOZILLA_1_9_1_ADDITIONS) || iid.equals(Ci.nsISupports)) { return this; } throw Cr.NS_ERROR_NO_INTERFACE; }