Class LineNumberRulerColumn

java.lang.Object
org.eclipse.jface.text.source.LineNumberRulerColumn
All Implemented Interfaces:
IVerticalRulerColumn
Direct Known Subclasses:
LineNumberChangeRulerColumn

public class LineNumberRulerColumn extends Object implements IVerticalRulerColumn
A vertical ruler column displaying line numbers. Clients usually instantiate and configure object of this class.
Since:
2.0
  • Constructor Details

    • LineNumberRulerColumn

      public LineNumberRulerColumn()
      Constructs a new vertical ruler column.
  • Method Details

    • setForeground

      public void setForeground(Color foreground)
      Sets the foreground color of this column.
      Parameters:
      foreground - the foreground color
    • getForeground

      protected Color getForeground()
      Returns the foreground color being used to print the line numbers.
      Returns:
      the configured foreground color
      Since:
      3.0
    • setBackground

      public void setBackground(Color background)
      Sets the background color of this column.
      Parameters:
      background - the background color
    • getBackground

      protected Color getBackground(Display display)
      Returns the System background color for list widgets.
      Parameters:
      display - the display
      Returns:
      the System background color for list widgets
    • getControl

      public Control getControl()
      Description copied from interface: IVerticalRulerColumn
      Returns the column's SWT control.
      Specified by:
      getControl in interface IVerticalRulerColumn
      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 interface IVerticalRulerColumn
      Returns:
      the width of this column's control
    • updateNumberOfDigits

      protected boolean updateNumberOfDigits()
      Computes the number of digits to be displayed. Returns true if the number of digits changed compared to the previous call of this method. If the method is called for the first time, the return value is also true.
      Returns:
      whether the number of digits has been changed
      Since:
      3.0
    • computeNumberOfDigits

      protected int computeNumberOfDigits()
      Does the real computation of the number of digits. Subclasses may override this method if they need extra space on the line number ruler.
      Returns:
      the number of digits to be displayed on the line number ruler.
    • layout

      protected void layout(boolean redraw)
      Layouts the enclosing viewer to adapt the layout to changes of the size of the individual components.
      Parameters:
      redraw - true if this column can be redrawn
    • computeIndentations

      protected void computeIndentations()
      Computes the indentations for the given font and stores them in fIndentation.
    • createControl

      public Control createControl(CompositeRuler parentRuler, Composite parentControl)
      Description copied from interface: IVerticalRulerColumn
      Creates the column's SWT control.
      Specified by:
      createControl in interface IVerticalRulerColumn
      Parameters:
      parentRuler - the parent ruler of this column
      parentControl - the control of the parent ruler
      Returns:
      the column's SWT control
    • handleDispose

      protected void handleDispose()
      Disposes the column's resources.
    • getVisibleLinesInViewport

      @Deprecated protected int getVisibleLinesInViewport()
      Deprecated.
      as of 3.2 the number of lines in the viewport cannot be computed because StyledText supports variable line heights
      Returns the view port height in lines.
      Returns:
      the view port height in lines
    • isViewerCompletelyShown

      protected final boolean isViewerCompletelyShown()
      Returns true 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
    • createDisplayString

      protected String createDisplayString(int line)
      Computes the string to be printed for line. The default implementation returns Integer.toString(line + 1).
      Parameters:
      line - the line number for which the line number string is generated
      Returns:
      the string to be printed on the line number bar for line
      Since:
      3.0
    • paintLine

      protected void paintLine(int line, int y, int lineheight, GC gc, Display display)
      Paints the line. After this method is called the line numbers are painted on top of the result of this method.
      Parameters:
      line - the line of the document which the ruler is painted for
      y - the y-coordinate of the box being painted for line, relative to gc
      lineheight - the height of one line (and therefore of the box being painted)
      gc - the drawing context the client may choose to draw on.
      display - the display the drawing occurs on
      Since:
      3.0
    • postRedraw

      protected final void postRedraw()
      Triggers a redraw in the display thread.
      Since:
      3.0
    • redraw

      public void redraw()
      Description copied from interface: IVerticalRulerColumn
      Redraws this column.
      Specified by:
      redraw in interface IVerticalRulerColumn
    • setModel

      public void setModel(IAnnotationModel model)
      Description copied from interface: IVerticalRulerColumn
      Associates an annotation model with this ruler column. A value null is acceptable and clears the ruler.
      Specified by:
      setModel in interface IVerticalRulerColumn
      Parameters:
      model - the new annotation model, may be null
    • setFont

      public void setFont(Font font)
      Description copied from interface: IVerticalRulerColumn
      Sets the font of this ruler column.
      Specified by:
      setFont in interface IVerticalRulerColumn
      Parameters:
      font - the new font of the ruler column
    • getParentRuler

      protected CompositeRuler getParentRuler()
      Returns the parent (composite) ruler of this ruler column.
      Returns:
      the parent ruler
      Since:
      3.0