TextViewCursor

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 >

The text controller has a visible cursor that is used in the GUI. Get the com.sun.star.text.TextViewCursor by calling getTextViewCursor() at the com.sun.star.text.XTextViewCursorSupplier interface of the current text document controller.

It supports the following cursor capabilities that depend on having the necessary information about the current layout state, therefore it is not supported by the model cursor.

com.sun.star.text.XPageCursor

 boolean jumpToFirstPage()
 boolean jumpToLastPage()
 boolean jumpToPage( [in] long pageNo)
 long getPage()
 boolean jumpToNextPage()
 boolean jumpToPreviousPage()
 boolean jumpToEndOfPage()
 boolean jumpToStartOfPage()

com.sun.star.view.XScreenCursor

 boolean screenDown()
 boolean screenUp()

com.sun.star.view.XLineCursor

 boolean goDown( [in] long lines, [in] boolean bExpand)
 boolean goUp( [in] long lines, [in] boolean bExpand)
 boolean isAtStartOfLine()
 boolean isAtEndOfLine()
 void gotoEndOfLine( [in] boolean bExpand)
 void gotoStartOfLine( [in] boolean bExpand)

com.sun.star.view.XViewCursor

 boolean goLeft( [in] long characters, [in] boolean bExpand)
 boolean goRight( [in] long characters, [in] boolean bExpand)
 boolean goDown( [in] long characters, [in] boolean bExpand)
 boolean goUp( [in] long characters, [in] boolean bExpand)

Additionally the interface com.sun.star.beans.XPropertySet is supported.

Currently, the view cursor does not have the capabilities as the document cursor does. Therefore, it is necessary to create a document cursor to have access to the full text cursor functionality. The method createTextCursorByRange() is used:

 XText xCrsrText = xViewCursor.getText();
 // Create a TextCursor over the view cursor's contents
 XTextCursor xDocumentCursor = xViewText.createTextCursorByRange(xViewCursor.getStart());
 xDocumentCursor.gotoRange(xViewCursor.getEnd(), true);

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