Eclipse Platform
Release 3.1

org.eclipse.jface.text.source
Interface IVerticalRulerInfo

All Known Subinterfaces:
IOverviewRuler, IVerticalRuler
All Known Implementing Classes:
AnnotationRulerColumn, ChangeRulerColumn, CompositeRuler, LineNumberChangeRulerColumn, OverviewRuler, VerticalRuler

public interface IVerticalRulerInfo

A vertical ruler is a visual component which may serve text viewers as an annotation presentation area. The vertical ruler info provides interested clients with the mapping and interaction aspect of the vertical ruler. This covers the mapping between coordinates of the ruler's control and line numbers based on the connected text viewer's document. In order to provide backward compatibility for clients of IVerticalRulerInfo, extension interfaces are used as a means of evolution. The following extension interfaces exist:

Since:
2.0
See Also:
IVerticalRulerInfoExtension

Method Summary
 Control getControl()
          Returns the ruler's SWT control.
 int getLineOfLastMouseButtonActivity()
          Returns the line number of the last mouse button activity.
 int getWidth()
          Returns the width of this ruler's control.
 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.
 

Method Detail

getControl

public Control getControl()
Returns the ruler's SWT control.

Returns:
the ruler's SWT control

getLineOfLastMouseButtonActivity

public int getLineOfLastMouseButtonActivity()
Returns the line number of the last mouse button activity. Based on the input document of the connected text viewer. The smallest possible line number is 0.

Returns:
the line number of the last mouse button activity

toDocumentLineNumber

public 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.

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

getWidth

public int getWidth()
Returns the width of this ruler's control.

Returns:
the width of this ruler's control

Eclipse Platform
Release 3.1

Guidelines for using Eclipse APIs.

Copyright (c) IBM Corp. and others 2000, 2005. All rights reserved.