Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Programming
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Databases
Mail Systems
openSolaris
Eclipse Documentation
Techotopia.com
Virtuatopia.com

How To Guides
Virtualization
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Windows
Problem Solutions
Privacy Policy

  




 

 


Eclipse Platform
Release 3.5

org.eclipse.jface.text.source
Interface ISourceViewer

All Superinterfaces:
ITextViewer
All Known Implementing Classes:
ProjectionViewer, SourceViewer, TextConsoleViewer

public interface ISourceViewer
extends ITextViewer

In addition to the text viewer functionality a source viewer supports:

  • visual annotations based on an annotation model
  • visual range indication
  • management of text viewer add-ons
  • explicit configuration
It is assumed that range indication and visual annotations are shown inside the same presentation area. There are no assumptions about whether this area is different from the viewer's text widget.

As the visibility of visual annotations can dynamically be changed, it is assumed that the annotation presentation area can dynamically be hidden if it is different from the text widget.

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

  • ISourceViewerExtension since version 2.1 introducing the concept of an annotation overview.
  • ISourceViewerExtension2 since version 3.0 allowing source viewers to roll back a previously performed configuration and allows access to the viewer's visual annotation model.
  • ISourceViewerExtension3 since version 3.2 introducing the concept of a quick assist assistant and providing access to the quick assist invocation context as well as the current annotation hover.
  • ISourceViewerExtension4 since version 3.4 introducing API to access a minimal set of content assistant APIs.

Clients may implement this interface and its extension interfaces or use the default implementation provided by SourceViewer.

See Also:
ISourceViewerExtension, ISourceViewerExtension2, ISourceViewerExtension3, ISourceViewerExtension4

Field Summary
static int CONTENTASSIST_CONTEXT_INFORMATION
          Text operation code for requesting content assist to show the content information for the current insert position.
static int CONTENTASSIST_PROPOSALS
          Text operation code for requesting content assist to show completion proposals for the current insert position.
static int FORMAT
          Text operation code for formatting the selected text or complete document of this viewer if the selection is empty.
static int INFORMATION
          Text operation code for requesting information at the current insertion position.
static int QUICK_ASSIST
          Text operation code for requesting quick assist.
 
Method Summary
 void configure ( SourceViewerConfiguration configuration)
          Configures the source viewer using the given configuration.
  IAnnotationModel getAnnotationModel ()
          Returns this viewer's annotation model.
  IRegion getRangeIndication ()
          Returns the viewer's range indication.
 void removeRangeIndication ()
          Removes the viewer's range indication.
 void setAnnotationHover ( IAnnotationHover annotationHover)
          Sets the annotation hover of this source viewer.
 void setDocument ( IDocument document, IAnnotationModel annotationModel)
          Sets the given document as this viewer's text model and the given annotation model as the model for this viewer's visual annotations.
 void setDocument ( IDocument document, IAnnotationModel annotationModel, int modelRangeOffset, int modelRangeLength)
          Sets the given document as this viewer's text model and the given annotation model as the model for this viewer's visual annotations.
 void setRangeIndication (int offset, int length, boolean moveCursor)
          Sets the viewers's range indication to the specified range.
 void setRangeIndicator ( Annotation rangeIndicator)
          Sets the annotation used by this viewer as range indicator.
 void showAnnotations (boolean show)
          Controls the visibility of annotations and in the case of separate presentation areas of text and annotations, the visibility of the annotation's presentation area.
 
Methods inherited from interface org.eclipse.jface.text. ITextViewer
activatePlugins, addTextInputListener, addTextListener, addViewportListener, changeTextPresentation, getBottomIndex, getBottomIndexEndOffset, getDocument, getFindReplaceTarget, getSelectedRange, getSelectionProvider, getTextOperationTarget, getTextWidget, getTopIndex, getTopIndexStartOffset, getTopInset, getVisibleRegion, invalidateTextPresentation, isEditable, overlapsWithVisibleRegion, removeTextInputListener, removeTextListener, removeViewportListener, resetPlugins, resetVisibleRegion, revealRange, setAutoIndentStrategy, setDefaultPrefixes, setDocument, setDocument, setEditable, setEventConsumer, setIndentPrefixes, setSelectedRange, setTextColor, setTextColor, setTextDoubleClickStrategy, setTextHover, setTopIndex, setUndoManager, setVisibleRegion
 

Field Detail

CONTENTASSIST_PROPOSALS

static final int CONTENTASSIST_PROPOSALS
Text operation code for requesting content assist to show completion proposals for the current insert position.

See Also:
Constant Field Values

CONTENTASSIST_CONTEXT_INFORMATION

static final int CONTENTASSIST_CONTEXT_INFORMATION
Text operation code for requesting content assist to show the content information for the current insert position.

See Also:
Constant Field Values

FORMAT

static final int FORMAT
Text operation code for formatting the selected text or complete document of this viewer if the selection is empty.

See Also:
Constant Field Values

INFORMATION

static final int INFORMATION
Text operation code for requesting information at the current insertion position.

Since:
2.0
See Also:
Constant Field Values

QUICK_ASSIST

static final int QUICK_ASSIST
Text operation code for requesting quick assist. This will normally show quick assist and quick fix proposals for the current position.

Since:
3.2
See Also:
Constant Field Values
Method Detail

configure

void configure(
SourceViewerConfiguration configuration)
Configures the source viewer using the given configuration. Prior to 3.0 this method can only be called once. Since 3.0 this method can be called again after a call to ISourceViewerExtension2.unconfigure().

Parameters:
configuration - the source viewer configuration to be used

setAnnotationHover

void setAnnotationHover(
IAnnotationHover annotationHover)
Sets the annotation hover of this source viewer. The annotation hover provides the information to be displayed in a hover popup window if requested over the annotation presentation area. The annotation hover is assumed to be line oriented.

Parameters:
annotationHover - the hover to be used, null is a valid argument

setDocument

void setDocument(
IDocument document,
                 
IAnnotationModel annotationModel)
Sets the given document as this viewer's text model and the given annotation model as the model for this viewer's visual annotations. The presentation is accordingly updated. An appropriate TextEvent is issued. This text event does not carry a related document event.

Parameters:
document - the viewer's new input document
annotationModel - the model for the viewer's visual annotations
See Also:
ITextViewer.setDocument(IDocument)

setDocument

void setDocument(
IDocument document,
                 
IAnnotationModel annotationModel,
                 int modelRangeOffset,
                 int modelRangeLength)
Sets the given document as this viewer's text model and the given annotation model as the model for this viewer's visual annotations. The presentation is accordingly updated whereby only the specified region is exposed. An appropriate TextEvent is issued. The text event does not carry a related document event. This method is a convenience method for setDocument(document, annotationModel);setVisibleRegion(offset, length).

Parameters:
document - the new input document
annotationModel - the model of the viewer's visual annotations
modelRangeOffset - the offset of the model range
modelRangeLength - the length of the model range
See Also:
ITextViewer.setDocument(IDocument, int, int)

getAnnotationModel

IAnnotationModel getAnnotationModel()
Returns this viewer's annotation model. Use ISourceViewerExtension2.getVisualAnnotationModel()in order to get access to the viewer's visual annotation model.

Returns:
this viewer's annotation model

setRangeIndicator

void setRangeIndicator(
Annotation rangeIndicator)
Sets the annotation used by this viewer as range indicator. The range covered by this annotation is referred to as range indication.

Parameters:
rangeIndicator - the annotation to be used as this viewer's range indicator

setRangeIndication

void setRangeIndication(int offset,
                        int length,
                        boolean moveCursor)
Sets the viewers's range indication to the specified range. Its is indicated whether the cursor should also be moved to the beginning of the specified range.

Parameters:
offset - the offset of the range
length - the length of the range
moveCursor - indicates whether the cursor should be moved to the given offset

getRangeIndication

IRegion getRangeIndication()
Returns the viewer's range indication.

Returns:
the viewer's range indication.

removeRangeIndication

void removeRangeIndication()
Removes the viewer's range indication. There is no visible range indication after this method completed.


showAnnotations

void showAnnotations(boolean show)
Controls the visibility of annotations and in the case of separate presentation areas of text and annotations, the visibility of the annotation's presentation area.

By default, annotations and their presentation area are visible.

Parameters:
show - indicates the visibility of annotations

Eclipse Platform
Release 3.5

Guidelines for using Eclipse APIs.

Copyright (c) Eclipse contributors and others 2000, 2008. All rights reserved.


 
 
  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire