Add support for bookmark separators (bug 320261). r=brettw, ben.

Original committer: bryner%brianryner.com
Original revision: 1.18
Original date: 2006/02/08 01:10:03

toolkit/components/places/public/nsINavBookmarksService.idl

@@ -162,6 +162,20 @@ interface nsINavBookmarkObserver : nsISupports
    *  @param property   The property that was changed.
    */
   void onFolderChanged(in PRInt64 folder, in ACString property);
+
+  /**
+   * Notify this observer that a separator has been added.
+   *  @param parent     The id of the separator's parent.
+   *  @param index      The separator's index inside its parent.
+   */
+  void onSeparatorAdded(in PRInt64 parent, in PRInt32 index);
+
+  /**
+   * Notify this observer that a separator has been removed.
+   *  @param parent     The id of the separator's parent.
+   *  @param index      The separator's old index in its parent.
+   */
+  void onSeparatorRemoved(in PRInt64 parent, in PRInt32 index);
 };
 
 /**
@@ -263,6 +277,21 @@ interface nsINavBookmarksService : nsISupports
    */
   PRInt64 getChildFolder(in PRInt64 folder, in AString subFolder);
 
+  /**
+   * Inserts a bookmark separator into the given folder at the given index.
+   * The separator can be removed using removeChildAt().
+   *  @param folder    Parent folder of the separator
+   *  @param index     The separator's index under folder, or -1 to append
+   */
+  void insertSeparator(in PRInt64 folder, in PRInt32 index);
+
+  /**
+   * Removes any type of child (item, folder, or separator) at the given index.
+   *  @param folder    The folder to remove a child from
+   *  @param index     The index of the child to remove
+   */
+  void removeChildAt(in PRInt64 folder, in PRInt32 index);
+
   /**
    * Set the history/bookmark title for a URI.  The new title will be used
    * anywhere the URI is shown in bookmarks or history.