com.aspose.words

Class BookmarkCollection

  • java.lang.Object
    • com.aspose.words.BookmarkCollection
  • All Implemented Interfaces:
    java.lang.Iterable
    public class BookmarkCollection 
    extends java.lang.Object

A collection of Bookmark objects that represent the bookmarks in the specified range.

Example:

Shows how to obtain bookmarks from a bookmark collection.
Document doc = new Document(getMyDir() + "Bookmarks.doc");

// By index.
Bookmark bookmark1 = doc.getRange().getBookmarks().get(0);

// By name.
Bookmark bookmark2 = doc.getRange().getBookmarks().get("Bookmark2");

Property Getters/Setters Summary
intgetCount()
Returns the number of bookmarks in the collection.
Bookmarkget(int index)
Returns a bookmark at the specified index.
Bookmarkget(java.lang.String bookmarkName)
Returns a bookmark by name.
 
Method Summary
voidclear()
Removes all bookmarks from this collection and from the document.
java.util.Iterator<Bookmark>iterator()
Returns an enumerator object.
voidremove(Bookmark bookmark)
Removes the specified bookmark from the document.
voidremove(java.lang.String bookmarkName)
Removes a bookmark with the specified name.
voidremoveAt(int index)
Removes a bookmark at the specified index.
 

    • Property Getters/Setters Detail

      • getCount

        public int getCount()
        
        Returns the number of bookmarks in the collection.

        Example:

        Shows how to count the number of bookmarks in a document.
        Document doc = new Document(getMyDir() + "Bookmark.doc");
        
        int count = doc.getRange().getBookmarks().getCount();
      • get

        public Bookmark get(int index)
        
        Returns a bookmark at the specified index.

        The index is zero-based.

        Negative indexes are allowed and indicate access from the back of the collection. For example -1 means the last item, -2 means the second before last and so on.

        If index is greater than or equal to the number of items in the list, this returns a null reference.

        If index is negative and its absolute value is greater than the number of items in the list, this returns a null reference.

        Parameters:
        index - An index into the collection.

        Example:

        Shows how to obtain bookmarks from a bookmark collection.
        Document doc = new Document(getMyDir() + "Bookmarks.doc");
        
        // By index.
        Bookmark bookmark1 = doc.getRange().getBookmarks().get(0);
        
        // By name.
        Bookmark bookmark2 = doc.getRange().getBookmarks().get("Bookmark2");
      • get

        public Bookmark get(java.lang.String bookmarkName)
        
        Returns a bookmark by name.

        Returns null if the bookmark with the specified name cannot be found.

        Parameters:
        bookmarkName - Case-insensitive name of the bookmark.

        Example:

        Shows how to obtain bookmarks from a bookmark collection.
        Document doc = new Document(getMyDir() + "Bookmarks.doc");
        
        // By index.
        Bookmark bookmark1 = doc.getRange().getBookmarks().get(0);
        
        // By name.
        Bookmark bookmark2 = doc.getRange().getBookmarks().get("Bookmark2");
    • Method Detail

      • clear

        public void clear()
                  throws java.lang.Exception
        Removes all bookmarks from this collection and from the document.

        Example:

        Shows how to remove all bookmarks from a document.
        Document doc = new Document(getMyDir() + "Bookmark.doc");
        doc.getRange().getBookmarks().clear();
      • iterator

        public java.util.Iterator<Bookmark> iterator()
        Returns an enumerator object.
      • remove

        public void remove(Bookmark bookmark)
                   throws java.lang.Exception
        Removes the specified bookmark from the document.
        Parameters:
        bookmark - The bookmark to remove.

        Example:

        Demonstrates different methods of removing bookmarks from a document.
        Document doc = new Document(getMyDir() + "Bookmarks.doc");
        
        // Remove a particular bookmark from the document.
        Bookmark bookmark = doc.getRange().getBookmarks().get(0);
        doc.getRange().getBookmarks().remove(bookmark);
        
        // Remove a bookmark by specified name.
        doc.getRange().getBookmarks().remove("Bookmark2");
        
        // Remove a bookmark at the specified index.
        doc.getRange().getBookmarks().removeAt(0);
      • remove

        public void remove(java.lang.String bookmarkName)
                   throws java.lang.Exception
        Removes a bookmark with the specified name.
        Parameters:
        bookmarkName - The case-insensitive name of the bookmark to remove.

        Example:

        Demonstrates different methods of removing bookmarks from a document.
        Document doc = new Document(getMyDir() + "Bookmarks.doc");
        
        // Remove a particular bookmark from the document.
        Bookmark bookmark = doc.getRange().getBookmarks().get(0);
        doc.getRange().getBookmarks().remove(bookmark);
        
        // Remove a bookmark by specified name.
        doc.getRange().getBookmarks().remove("Bookmark2");
        
        // Remove a bookmark at the specified index.
        doc.getRange().getBookmarks().removeAt(0);
      • removeAt

        public void removeAt(int index)
                     throws java.lang.Exception
        Removes a bookmark at the specified index.
        Parameters:
        index - The zero-based index of the bookmark to remove.

        Example:

        Demonstrates different methods of removing bookmarks from a document.
        Document doc = new Document(getMyDir() + "Bookmarks.doc");
        
        // Remove a particular bookmark from the document.
        Bookmark bookmark = doc.getRange().getBookmarks().get(0);
        doc.getRange().getBookmarks().remove(bookmark);
        
        // Remove a bookmark by specified name.
        doc.getRange().getBookmarks().remove("Bookmark2");
        
        // Remove a bookmark at the specified index.
        doc.getRange().getBookmarks().removeAt(0);