Bookmarks

OpenOffice.org Developer's Guide

Text Documents

< Previous Section

Next Section >

• Example: Fields in a Template
• Example: Visible Cursor Position

• Handling Text Document Files

• Saving Text Documents
• Printing Text Documents

• Working with Text Documents

• Editing Text
• Iterating over Text
• Inserting a Paragraph where no Cursor can go
• Sorting Text
• Inserting Text Files
• Auto Text

• Formatting
• Navigating
• Tables

• Named Table Cells in Rows, Columns and the Table Cursor
• Indexed Cells and Cell Ranges
• Table Naming, Sorting, Charting and Autoformatting
• Text Table Properties
• Inserting Tables
• Accessing Existing Tables

• Text Fields
• Bookmarks
• Indexes and Index Marks
• Reference Marks
• Footnotes and Endnotes
• Shape Objects in Text

• Text Frames
• Embedded Objects
• Graphic Objects
• Drawing Shapes

• Redline
• Ruby

• Overall Document Features

• Settings
• Line Numbering and Outline Numbering
• Text Sections
• Page Layout
• Columns
• Link Targets

• Text Document Controller

• TextView
• TextViewCursor

< Previous Page

Next Page >

A Bookmark is a text content that marks a position inside of a paragraph or a text selection that supports the com.sun.star.text.TextContent service. To search for a bookmark, the text document model implements the interface com.sun.star.text.XBookmarksSupplier that supplies a collection of the bookmarks. The collection supports the service com.sun.star.text.Bookmarks which consists of com.sun.star.container.XNameAccess and com.sun.star.container.XIndexAccess.

The bookmark name can be read and changed through its (com.sun.star.container.XNamed) interface.

To insert, remove or change text, or attributes starting from the position of a bookmark, retrieve its com.sun.star.text.XTextRange by calling getAnchor() at its com.sun.star.text.XTextContent interface. Then use getString() or setString() at the XTextRange, or pass this XTextRange to methods expecting a text range, such as com.sun.star.text.XSimpleText:createTextCursorByRange(), com.sun.star.text.XSimpleText:insertString() or com.sun.star.text.XText:insertTextContent().

Use the createInstance method of the com.sun.star.lang.XMultiServiceFactory interface provided by the text document model to insert an new bookmark into the document. The service name is "com.sun.star.text.Bookmark". Then use the bookmark's com.sun.star.container.XNamed interface and call setName(). If no name is set, OpenOffice.org makes up generic names, such as Bookmark1 and Bookmark2. Similarly, if a name is used that is not unique, writer automatically appends a number to the bookmark name. The bookmark object obtained from createInstance() can only be inserted once.

 // inserting and retrieving a bookmark
 Object bookmark = mxDocFactory.createInstance ( "com.sun.star.text.Bookmark" );
 
 // name the bookmark
 XNamed xNamed = (XNamed) UnoRuntime.queryInterface ( 
     XNamed.class, bookmark );
 xNamed.setName("MyUniqueBookmarkName");
 
 // get XTextContent interface 
 XTextContent xTextContent = (XTextContent) UnoRuntime.queryInterface ( 
     XTextContent.class, bookmark );
 
 // insert bookmark at the end of the document
 // instead of mxDocText.getEnd you could use a text cursor's XTextRange interface or any XTextRange
 mxDocText.insertTextContent ( mxDocText.getEnd(), xTextContent, false ); 
 
 // query XBookmarksSupplier from document model and get bookmarks collection
 XBookmarksSupplier xBookmarksSupplier = (XBookmarksSupplier)UnoRuntime.queryInterface(
     XBookmarksSupplier.class, xWriterComponent);
 XNameAccess xNamedBookmarks = xBookmarksSupplier.getBookmarks();
 
 // retrieve bookmark by name
 Object foundBookmark = xNamedBookmarks.getByName("MyUniqueBookmarkName");
 XTextContent xFoundBookmark = (XTextContent)UnoRuntime.queryInterface(
     XTextContent.class, foundBookmark);
 
 // work with bookmark
 XTextRange xFound = xFoundBookmark.getAnchor();
 xFound.setString(" The throat mike, glued to her neck, " 
     + "looked as much as possible like an analgesic dermadisk.");

Content on this page is licensed under the Public Documentation License (PDL).