Package org.eclipse.jface.text.source
Class ChangeRulerColumn
java.lang.Object
org.eclipse.jface.text.source.ChangeRulerColumn
- All Implemented Interfaces:
IRevisionRulerColumn
,IChangeRulerColumn
,IVerticalRulerColumn
,IVerticalRulerInfo
,IVerticalRulerInfoExtension
public final class ChangeRulerColumn
extends Object
implements IChangeRulerColumn, IRevisionRulerColumn
A vertical ruler column displaying line numbers and serving as a UI for quick diff.
Clients instantiate and configure object of this class.
- Since:
- 3.0
-
Field Summary
Fields inherited from interface org.eclipse.jface.text.source.IChangeRulerColumn
QUICK_DIFF_MODEL_ID
-
Constructor Summary
ConstructorDescriptionDeprecated.ChangeRulerColumn
(ISharedTextColors sharedColors) Creates a new revision ruler column. -
Method Summary
Modifier and TypeMethodDescriptionvoid
Registers a vertical ruler listener to be informed if an annotation gets selected on the vertical ruler.createControl
(CompositeRuler parentRuler, Composite parentControl) Creates the column's SWT control.Returns the column's SWT control.getHover()
Returns the hover for this vertical ruler (column).int
Returns the line number of the last mouse button activity.getModel()
Returns the model currently used by the receiver.Returns the revision selection provider.protected int
Deprecated.as of 3.2 the number of lines in the viewport cannot be computed because StyledText supports variable line heightsint
getWidth()
Returns the width of this column's control.protected void
Disposes the column's resources.protected final boolean
Returnstrue
if the viewport displays the entire viewer contents, i.e. the viewer is not vertically scrollable.protected final void
Triggers a redraw in the display thread.void
redraw()
Redraws this column.void
Removes a previously registered listener.void
setAddedColor
(Color addedColor) Sets the background color for added lines.void
setBackground
(Color background) Sets the background color for normal lines.void
setChangedColor
(Color changedColor) Sets the background color for changed lines.void
setDeletedColor
(Color deletedColor) Sets the color for the deleted lines indicator.void
Sets the font of this ruler column.void
setHover
(IAnnotationHover hover) Sets the hover of this ruler column.void
setModel
(IAnnotationModel model) Associates an annotation model with this ruler column.void
Sets the revision information.int
toDocumentLineNumber
(int y_coordinate) Translates a y-coordinate of the ruler's SWT control into the according line number of the document of the connected text viewer.
-
Constructor Details
-
ChangeRulerColumn
Deprecated.since 3.2 useChangeRulerColumn(ISharedTextColors)
insteadCreates a new ruler column.
-
-
Method Details
-
createControl
Description copied from interface:IVerticalRulerColumn
Creates the column's SWT control.- Specified by:
createControl
in interfaceIVerticalRulerColumn
- Parameters:
parentRuler
- the parent ruler of this columnparentControl
- the control of the parent ruler- Returns:
- the column's SWT control
-
handleDispose
protected void handleDispose()Disposes the column's resources. -
getVisibleLinesInViewport
Deprecated.as of 3.2 the number of lines in the viewport cannot be computed because StyledText supports variable line heightsReturns the view port height in lines.- Returns:
- the view port height in lines
-
isViewerCompletelyShown
protected final boolean isViewerCompletelyShown()Returnstrue
if the viewport displays the entire viewer contents, i.e. the viewer is not vertically scrollable.- Returns:
true
if the viewport displays the entire contents,false
otherwise- Since:
- 3.2
-
redraw
public void redraw()Description copied from interface:IVerticalRulerColumn
Redraws this column.- Specified by:
redraw
in interfaceIVerticalRulerColumn
-
setFont
Description copied from interface:IVerticalRulerColumn
Sets the font of this ruler column.- Specified by:
setFont
in interfaceIVerticalRulerColumn
- Parameters:
font
- the new font of the ruler column
-
getLineOfLastMouseButtonActivity
public int getLineOfLastMouseButtonActivity()Description copied from interface:IVerticalRulerInfo
Returns the line number of the last mouse button activity. Based on the input document of the connected text viewer.- Specified by:
getLineOfLastMouseButtonActivity
in interfaceIVerticalRulerInfo
- Returns:
- the line number of the last mouse button activity or
-1
if the last mouse activity does not correspond to a valid document line
-
toDocumentLineNumber
public int toDocumentLineNumber(int y_coordinate) Description copied from interface:IVerticalRulerInfo
Translates a y-coordinate of the ruler's SWT control into the according line number of the document of the connected text viewer.- Specified by:
toDocumentLineNumber
in interfaceIVerticalRulerInfo
- Parameters:
y_coordinate
- a y-coordinate of the ruler's SWT control- Returns:
- the line number of that coordinate or
-1
if that coordinate does not correspond to a valid document line
-
getHover
Description copied from interface:IVerticalRulerInfoExtension
Returns the hover for this vertical ruler (column).- Specified by:
getHover
in interfaceIVerticalRulerInfoExtension
- Returns:
- the hover for this column
-
setHover
Description copied from interface:IChangeRulerColumn
Sets the hover of this ruler column.- Specified by:
setHover
in interfaceIChangeRulerColumn
- Parameters:
hover
- the hover that will produce hover information text for this ruler column
-
setModel
Description copied from interface:IVerticalRulerColumn
Associates an annotation model with this ruler column. A valuenull
is acceptable and clears the ruler.- Specified by:
setModel
in interfaceIVerticalRulerColumn
- Parameters:
model
- the new annotation model, may benull
-
setBackground
Description copied from interface:IChangeRulerColumn
Sets the background color for normal lines. The color has to be disposed of by the caller when the receiver is no longer used.- Specified by:
setBackground
in interfaceIChangeRulerColumn
- Parameters:
background
- the new color to be used as standard line background
-
setAddedColor
Description copied from interface:IChangeRulerColumn
Sets the background color for added lines. The color has to be disposed of by the caller when the receiver is no longer used.- Specified by:
setAddedColor
in interfaceIChangeRulerColumn
- Parameters:
addedColor
- the new color to be used for the added lines background
-
setChangedColor
Description copied from interface:IChangeRulerColumn
Sets the background color for changed lines. The color has to be disposed of by the caller when the receiver is no longer used.- Specified by:
setChangedColor
in interfaceIChangeRulerColumn
- Parameters:
changedColor
- the new color to be used for the changed lines background
-
setDeletedColor
Description copied from interface:IChangeRulerColumn
Sets the color for the deleted lines indicator. The color has to be disposed of by the caller when the receiver is no longer used.- Specified by:
setDeletedColor
in interfaceIChangeRulerColumn
- Parameters:
deletedColor
- the new color to be used for the deleted lines indicator.
-
getModel
Description copied from interface:IVerticalRulerInfoExtension
Returns the model currently used by the receiver.- Specified by:
getModel
in interfaceIVerticalRulerInfoExtension
- Returns:
- the model of the receiver, or
null
if no model is installed.
-
getControl
Description copied from interface:IVerticalRulerColumn
Returns the column's SWT control.- Specified by:
getControl
in interfaceIVerticalRulerColumn
- Specified by:
getControl
in interfaceIVerticalRulerInfo
- Returns:
- the column's SWT control
-
getWidth
public int getWidth()Description copied from interface:IVerticalRulerColumn
Returns the width of this column's control.- Specified by:
getWidth
in interfaceIVerticalRulerColumn
- Specified by:
getWidth
in interfaceIVerticalRulerInfo
- Returns:
- the width of this column's control
-
postRedraw
protected final void postRedraw()Triggers a redraw in the display thread. -
addVerticalRulerListener
Description copied from interface:IVerticalRulerInfoExtension
Registers a vertical ruler listener to be informed if an annotation gets selected on the vertical ruler.- Specified by:
addVerticalRulerListener
in interfaceIVerticalRulerInfoExtension
- Parameters:
listener
- the listener to be informed
-
removeVerticalRulerListener
Description copied from interface:IVerticalRulerInfoExtension
Removes a previously registered listener. Iflistener
is not registered with the receiver, calling this method has no effect.- Specified by:
removeVerticalRulerListener
in interfaceIVerticalRulerInfoExtension
- Parameters:
listener
- the listener to be removed
-
setRevisionInformation
Description copied from interface:IRevisionRulerColumn
Sets the revision information.- Specified by:
setRevisionInformation
in interfaceIRevisionRulerColumn
- Parameters:
info
- the new revision information, ornull
to reset the ruler
-
getRevisionSelectionProvider
Returns the revision selection provider.- Returns:
- the revision selection provider
- Since:
- 3.2
-
ChangeRulerColumn(ISharedTextColors)
instead