org.eclipse.jface.text
Interface ITextViewerExtension

All Known Implementing Classes:

TextViewer

public interface ITextViewerExtension

Extension interface for ITextViewer. Extends ITextViewer with

• a replacement of the event consumer mechanism (methods dealing with VerifyKeyListener)
• access to the control of this viewer
• marked region support a la emacs
• control of the viewer's redraw behavior (@see #setRedraw)
• access to the viewer's rewrite target

Since:

2.0

Method Summary

void	appendVerifyKeyListener(VerifyKeyListener listener) Appends a verify key listener to the viewer's list of verify key listeners.
Control	getControl() Returns the control of this viewer.
int	getMark() Returns the mark position, -1 if mark is not set.
IRewriteTarget	getRewriteTarget() Returns the viewer's rewrite target.
void	prependVerifyKeyListener(VerifyKeyListener listener) Inserts the verify key listener at the beginning of the viewer's list of verify key listeners.
void	removeVerifyKeyListener(VerifyKeyListener listener) Removes the verify key listener from the viewer's list of verify key listeners.
void	setMark(int offset) Sets or clears the mark.
void	setRedraw(boolean redraw) Enables/disables the redrawing of this text viewer.

Method Detail

prependVerifyKeyListener

public void prependVerifyKeyListener(VerifyKeyListener listener)

Inserts the verify key listener at the beginning of the viewer's list of verify key listeners. If the listener is already registered with the viewer this call moves the listener to the beginnng of the list.

Parameters:

listener - the listener to be inserted

appendVerifyKeyListener

public void appendVerifyKeyListener(VerifyKeyListener listener)

Appends a verify key listener to the viewer's list of verify key listeners. If the listener is already registered with the viewer this call moves the listener to the end of the list.

Parameters:

listener - the listener to be added

removeVerifyKeyListener

public void removeVerifyKeyListener(VerifyKeyListener listener)

Removes the verify key listener from the viewer's list of verify key listeners. If the listener is not registered with this viewer, this call has no effect.

Parameters:

listener - the listener to be removed

getControl

public Control getControl()

Returns the control of this viewer.

Returns:

the control of this viewer

setMark

public void setMark(int offset)

Sets or clears the mark. If offset is -1, the mark is cleared. If a mark is set and the selection is empty, cut and copy actions performed on this text viewer peform on the region limited by the positions of the mark and the cursor.

Parameters:

offset - the offset of the mark

getMark

public int getMark()

Returns the mark position, -1 if mark is not set.

Returns:

the mark position or -1 if no mark is set

setRedraw

public void setRedraw(boolean redraw)

Enables/disables the redrawing of this text viewer. This temporarily disconnects the viewer from its underlying StyledText widget. While being disconnected only the viewer's selection may be changed using setSelectedRange. Any direct manipulation of the widget as well as calls to methods that change the viewer's presentation state (such as enabling the segmented view) are not allowed. When redrawing is disabled the viewer does not send out any selection or view port change notification. When redrawing is enabled again, a selection change notification is sent out for the selected range and this range is revealed.

getRewriteTarget

public IRewriteTarget getRewriteTarget()

Returns the viewer's rewrite target.

Returns:

the viewer's rewrite target