Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep
Overview  Package   Class  Use  Deprecated  Index 
Home >> All >> org >> eclipse >> jface >> [ text overview ]  PREV CLASS  NEXT CLASS
SUMMARY: JavaDoc of org.eclipse.jface.text.ITextViewer JAVADOC | Sourc code of org.eclipse.jface.text.ITextViewer SOURCE | Download org.eclipse.jface.text.ITextViewer DOWNLOAD | NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

org.eclipse.jface.text
Interface ITextViewer  view ITextViewer download ITextViewer.java

All Known Implementing Classes:
TextViewer
public interface ITextViewer

A text viewer connects a text widget with an IDocument. The document is used as the widget's text model.

It supports the following kinds of listeners:

A text viewer supports a set of configuration options and plug-ins defining its behavior: Installed plug-ins are not automatically activated. Plug-ins must be activated with the activatePlugins call. Most plug-ins can be defined per content type. Content types are derived from a partitioning of the text viewer's input document. In case of documents that support multiple partitionings, the implementer is responsible for determining the partitioning to use.

A text viewer also provides the concept of event consumption. Events handled by the viewer can be filtered and processed by a dynamic event consumer. With ITextViewerExtensionthis mechanism has been replaced with the support for org.eclipse.swt.custom.VerifyKeyListener.

A text viewer provides several text editing functions, some of them are configurable, through a text operation target interface. It also supports a presentation mode in which it only shows a specified section of its document. By calling setVisibleRegion clients define which section is visible. Clients can get access to this section by calling getVisibleRegion. The viewer's presentation mode does not affect any client of the viewer other than text listeners. With ITextViewerExtension5the visible region support has been reworked. With that extension interface, text viewers are allowed to show fractions of their input document. I.e. a widget selection of two visually neighboring characters is no longer guaranteed to be two neighboring characters in the viewer's input document. Thus, viewers implementing ITextViewerExtension5are potentially forced to change the fractions of the input document that are shown when clients ask for the visible region.

In order to provide backward compatibility for clients of ITextViewer, extension interfaces are used as a means of evolution. The following extension interfaces exist:

Clients may implement this interface and its extension interfaces or use the standard implementation TextViewer.

Method Summary
 void activatePlugins()
          Activates the installed plug-ins.
 void addTextInputListener(ITextInputListener listener)
          Adds a text input listener to this viewer.
 void addTextListener(ITextListener listener)
          Adds a text listener to this viewer.
 void addViewportListener(IViewportListener listener)
          Adds the given view port listener to this viewer.
 void changeTextPresentation(TextPresentation presentation, boolean controlRedraw)
          Applies the color information encoded in the given text presentation.
 int getBottomIndex()
          Returns the visible line with the highest line number.
 int getBottomIndexEndOffset()
          Returns the document offset of the lower right corner of this viewer's view port.
 IDocument getDocument()
          Returns the text viewer's input document.
 IFindReplaceTarget getFindReplaceTarget()
          Returns the find/replace operation target of this viewer.
 org.eclipse.swt.graphics.Point getSelectedRange()
          Returns the range of the current selection in coordinates of this viewer's document.
 org.eclipse.jface.viewers.ISelectionProvider getSelectionProvider()
          Returns a selection provider dedicated to this viewer.
 ITextOperationTarget getTextOperationTarget()
          Returns the text operation target of this viewer.
 org.eclipse.swt.custom.StyledText getTextWidget()
          Returns this viewer's SWT control, null if the control is disposed.
 int getTopIndex()
          Returns the visible line with the smallest line number.
 int getTopIndexStartOffset()
          Returns the document offset of the upper left corner of this viewer's view port.
 int getTopInset()
          Returns the vertical offset of the first visible line.
 IRegion getVisibleRegion()
          Returns the current visible region of this viewer's document.
 void invalidateTextPresentation()
          Marks the currently applied text presentation as invalid.
 boolean isEditable()
          Returns whether the shown text can be manipulated.
 boolean overlapsWithVisibleRegion(int offset, int length)
          Returns whether a given range overlaps with the visible region of this viewer's document.
 void removeTextInputListener(ITextInputListener listener)
          Removes the given listener from this viewer's set of text input listeners.
 void removeTextListener(ITextListener listener)
          Removes the given listener from this viewer's set of text listeners.
 void removeViewportListener(IViewportListener listener)
          Removes the given listener from this viewer's set of view port listeners.
 void resetPlugins()
          Resets the installed plug-ins.
 void resetVisibleRegion()
          Resets the region of this viewer's document which is visible in the presentation.
 void revealRange(int offset, int length)
          Ensures that the given range is visible.
 void setAutoIndentStrategy(IAutoIndentStrategy strategy, java.lang.String contentType)
          Sets this viewer's auto indent strategy for the given content type.
 void setDefaultPrefixes(java.lang.String[] defaultPrefixes, java.lang.String contentType)
          Sets the string that is used as prefix when lines of the given content type are prefixed by the prefix text operation.
 void setDocument(IDocument document)
          Sets the given document as the text viewer's model and updates the presentation accordingly.
 void setDocument(IDocument document, int modelRangeOffset, int modelRangeLength)
          Sets the given document as this viewer's model and exposes the specified region.
 void setEditable(boolean editable)
          Sets the editable state.
 void setEventConsumer(IEventConsumer consumer)
          Registers an event consumer with this viewer.
 void setIndentPrefixes(java.lang.String[] indentPrefixes, java.lang.String contentType)
          Sets the strings that are used as prefixes when lines of the given content type are shifted using the shift text operation.
 void setSelectedRange(int offset, int length)
          Sets the selection to the specified range.
 void setTextColor(org.eclipse.swt.graphics.Color color)
          Applies the given color as text foreground color to this viewer's selection.
 void setTextColor(org.eclipse.swt.graphics.Color color, int offset, int length, boolean controlRedraw)
          Applies the given color as text foreground color to the specified section of this viewer.
 void setTextDoubleClickStrategy(ITextDoubleClickStrategy strategy, java.lang.String contentType)
          Sets this viewer's text double click strategy for the given content type.
 void setTextHover(ITextHover textViewerHover, java.lang.String contentType)
          Sets this viewer's text hover for the given content type.
 void setTopIndex(int index)
          Scrolls the widget so the the given index is the line with the smallest line number of all visible lines.
 void setUndoManager(IUndoManager undoManager)
          Sets this viewer's undo manager.
 void setVisibleRegion(int offset, int length)
          Defines and sets the region of this viewer's document which will be visible in the presentation.
 

Method Detail

getTextWidget

public org.eclipse.swt.custom.StyledText getTextWidget()
Returns this viewer's SWT control, null if the control is disposed.

setUndoManager

public void setUndoManager(IUndoManager undoManager)
Sets this viewer's undo manager.

setTextDoubleClickStrategy

public void setTextDoubleClickStrategy(ITextDoubleClickStrategy strategy,
                                       java.lang.String contentType)
Sets this viewer's text double click strategy for the given content type.

setAutoIndentStrategy

public void setAutoIndentStrategy(IAutoIndentStrategy strategy,
                                  java.lang.String contentType)
Sets this viewer's auto indent strategy for the given content type. If the given strategy is null any installed strategy for the content type is removed. This method has been replaced by ITextViewerExtension2.prependAutoEditStrategy(IAutoEditStrategy, String) 55 and ITextViewerExtension2.removeAutoEditStrategy(IAutoEditStrategy, String) 55 . It is now equivalent to 
    ITextViewerExtension2 extension= (ITextViewerExtension2) viewer;
    extension.removeAutoEditStrategy(oldStrategy, contentType);
    extension.prependAutoEditStrategy(strategy, contentType);

setTextHover

public void setTextHover(ITextHover textViewerHover,
                         java.lang.String contentType)
Sets this viewer's text hover for the given content type.

This method has been replaced by ITextViewerExtension2.setTextHover(ITextHover, String, int) 55 . It is now equivalent to 

    ITextViewerExtension2 extension= (ITextViewerExtension2) document;
    extension.setTextHover(textViewerHover, contentType, ITextViewerExtension2#DEFAULT_HOVER_STATE_MASK);

activatePlugins

public void activatePlugins()
Activates the installed plug-ins. If the plug-ins are already activated this call has no effect.

resetPlugins

public void resetPlugins()
Resets the installed plug-ins. If plug-ins change their state or behavior over the course of time, this method causes them to be set back to their initial state and behavior. E.g., if an IUndoManager has been installed on this text viewer, the manager's list of remembered text editing operations is removed.

addViewportListener

public void addViewportListener(IViewportListener listener)
Adds the given view port listener to this viewer. The listener is informed about all changes to the visible area of this viewer. If the listener is already registered with this viewer, this call has no effect.

removeViewportListener

public void removeViewportListener(IViewportListener listener)
Removes the given listener from this viewer's set of view port listeners. If the listener is not registered with this viewer, this call has no effect.

addTextListener

public void addTextListener(ITextListener listener)
Adds a text listener to this viewer. If the listener is already registered with this viewer, this call has no effect.

removeTextListener

public void removeTextListener(ITextListener listener)
Removes the given listener from this viewer's set of text listeners. If the listener is not registered with this viewer, this call has no effect.

addTextInputListener

public void addTextInputListener(ITextInputListener listener)
Adds a text input listener to this viewer. If the listener is already registered with this viewer, this call has no effect.

removeTextInputListener

public void removeTextInputListener(ITextInputListener listener)
Removes the given listener from this viewer's set of text input listeners. If the listener is not registered with this viewer, this call has no effect.

setDocument

public void setDocument(IDocument document)
Sets the given document as the text viewer's model and updates the presentation accordingly. An appropriate TextEvent is issued. This text event does not carry a related document event.

getDocument

public IDocument getDocument()
Returns the text viewer's input document.

setEventConsumer

public void setEventConsumer(IEventConsumer consumer)
Registers an event consumer with this viewer. This method has been replaces with the org.eclipse.swt.custom.VerifyKeyListener management methods in ITextViewerExtension.

setEditable

public void setEditable(boolean editable)
Sets the editable state.

isEditable

public boolean isEditable()
Returns whether the shown text can be manipulated.

setDocument

public void setDocument(IDocument document,
                        int modelRangeOffset,
                        int modelRangeLength)
Sets the given document as this viewer's model and exposes the specified region. An appropriate TextEvent is issued. The text event does not carry a related document event. This method is a convenience method for setDocument(document);setVisibleRegion(offset, length).

setVisibleRegion

public void setVisibleRegion(int offset,
                             int length)
Defines and sets the region of this viewer's document which will be visible in the presentation. Every character inside the specified region is supposed to be visible in the viewer's widget after that call.

resetVisibleRegion

public void resetVisibleRegion()
Resets the region of this viewer's document which is visible in the presentation. Afterwards, the whole input document is visible.

getVisibleRegion

public IRegion getVisibleRegion()
Returns the current visible region of this viewer's document. The result may differ from the argument passed to setVisibleRegion if the document has been modified since then. The visible region is supposed to be a consecutive region in viewer's input document and every character inside that region is supposed to visible in the viewer's widget.

Viewers implementing ITextViewerExtension5 may be forced to change the fractions of the input document that are shown, in order to fulfill this contract.

overlapsWithVisibleRegion

public boolean overlapsWithVisibleRegion(int offset,
                                         int length)
Returns whether a given range overlaps with the visible region of this viewer's document.

Viewers implementing ITextViewerExtension5may be forced to change the fractions of the input document that are shown in order to fulfill this request. This is because the overlap is supposed to be without gaps.

changeTextPresentation

public void changeTextPresentation(TextPresentation presentation,
                                   boolean controlRedraw)
Applies the color information encoded in the given text presentation. controlRedraw tells this viewer whether it should take care of redraw management or not. If, e.g., this call is one in a sequence of multiple presentation calls, it is more appropriate to explicitly control redrawing at the beginning and the end of the sequence.

invalidateTextPresentation

public void invalidateTextPresentation()
Marks the currently applied text presentation as invalid. It is the viewer's responsibility to take any action it can to repair the text presentation.

See ITextViewerExtension2.invalidateTextPresentation(int, int) 55 for a way to invalidate specific regions rather than the presentation as a whole.

Since:
2.0

setTextColor

public void setTextColor(org.eclipse.swt.graphics.Color color)
Applies the given color as text foreground color to this viewer's selection.

setTextColor

public void setTextColor(org.eclipse.swt.graphics.Color color,
                         int offset,
                         int length,
                         boolean controlRedraw)
Applies the given color as text foreground color to the specified section of this viewer. controlRedraw tells this viewer whether it should take care of redraw management or not.

getTextOperationTarget

public ITextOperationTarget getTextOperationTarget()
Returns the text operation target of this viewer.

getFindReplaceTarget

public IFindReplaceTarget getFindReplaceTarget()
Returns the find/replace operation target of this viewer.

setDefaultPrefixes

public void setDefaultPrefixes(java.lang.String[] defaultPrefixes,
                               java.lang.String contentType)
Sets the string that is used as prefix when lines of the given content type are prefixed by the prefix text operation. Sets the strings that are used as prefixes when lines of the given content type are prefixed using the prefix text operation. The prefixes are considered equivalent. Inserting a prefix always inserts the defaultPrefixes[0]. Removing a prefix removes all of the specified prefixes.

Since:
2.0

setIndentPrefixes

public void setIndentPrefixes(java.lang.String[] indentPrefixes,
                              java.lang.String contentType)
Sets the strings that are used as prefixes when lines of the given content type are shifted using the shift text operation. The prefixes are considered equivalent. Thus "\t" and " " can both be used as prefix characters. Shift right always inserts the indentPrefixes[0]. Shift left removes all of the specified prefixes.

setSelectedRange

public void setSelectedRange(int offset,
                             int length)
Sets the selection to the specified range.

getSelectedRange

public org.eclipse.swt.graphics.Point getSelectedRange()
Returns the range of the current selection in coordinates of this viewer's document.

getSelectionProvider

public org.eclipse.jface.viewers.ISelectionProvider getSelectionProvider()
Returns a selection provider dedicated to this viewer. Subsequent calls to this method return always the same selection provider.

revealRange

public void revealRange(int offset,
                        int length)
Ensures that the given range is visible.

setTopIndex

public void setTopIndex(int index)
Scrolls the widget so the the given index is the line with the smallest line number of all visible lines.

getTopIndex

public int getTopIndex()
Returns the visible line with the smallest line number.

getTopIndexStartOffset

public int getTopIndexStartOffset()
Returns the document offset of the upper left corner of this viewer's view port.

getBottomIndex

public int getBottomIndex()
Returns the visible line with the highest line number.

getBottomIndexEndOffset

public int getBottomIndexEndOffset()
Returns the document offset of the lower right corner of this viewer's view port. This is the visible character with the highest character position. If the content of this viewer is shorter, the position of the last character of the content is returned.

getTopInset

public int getTopInset()
Returns the vertical offset of the first visible line.

Overview  Package   Class  Use  Deprecated  Index 
Home >> All >> org >> eclipse >> jface >> [ text overview ]  PREV CLASS  NEXT CLASS
SUMMARY: JavaDoc of org.eclipse.jface.text.ITextViewer JAVADOC | Sourc code of org.eclipse.jface.text.ITextViewer SOURCE | Download org.eclipse.jface.text.ITextViewer DOWNLOAD | NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD