Eclipse Platform
Release 3.3

org.eclipse.jface.text.revisions
Class Revision

java.lang.Object
  extended byorg.eclipse.jface.text.revisions.Revision

public abstract class Revision
extends Object

Describes a revision of a document. A revision consists of one ore more ILineRanges.

Clients may subclass.

Since:
3.2

Constructor Summary
protected Revision()
          Creates a new revision.
 
Method Summary
 void addRange(ILineRange range)
          Adds a line range to this revision.
 String getAuthor()
          Returns the display string for the author of this revision.
abstract  RGB getColor()
          Returns the color definition to be used for this revision.
abstract  Date getDate()
          Returns the modification date of this revision.
abstract  Object getHoverInfo()
          Returns the hover information that will be shown when the user hovers over the a change region of this revision.
abstract  String getId()
          Returns the unique (within the document) id of this revision.
 List getRegions()
          Returns the contained RevisionRanges adapted to the current diff state.
 String toString()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

Revision

protected Revision()
Creates a new revision.

Method Detail

addRange

public final void addRange(ILineRange range)
                    throws IndexOutOfBoundsException
Adds a line range to this revision. The range must be non-empty and have a legal start line (not -1).

Parameters:
range - a line range that was changed with this revision
Throws:
IndexOutOfBoundsException - if the line range is empty or has a negative start line

getRegions

public final List getRegions()
Returns the contained RevisionRanges adapted to the current diff state. The returned information is only valid at the moment it is returned, and may change as the annotated document is modified.

Returns:
an unmodifiable view of the contained ranges (element type: RevisionRange)

getHoverInfo

public abstract Object getHoverInfo()
Returns the hover information that will be shown when the user hovers over the a change region of this revision.

Returns:
the hover information for this revision or null for no hover

getColor

public abstract RGB getColor()
Returns the color definition to be used for this revision. The color may be used to visually distinguish one revision from another, for example as background color. The colors of any two revisions should be as distinct as possible.

Returns:
the RGB color description for this revision

getId

public abstract String getId()
Returns the unique (within the document) id of this revision. This may be the version string or a different identifier.

Returns:
the id of this revision

getDate

public abstract Date getDate()
Returns the modification date of this revision.

Returns:
the modification date of this revision

toString

public String toString()

getAuthor

public String getAuthor()
Returns the display string for the author of this revision.

Subclasses should replace - the default implementation returns the empty string.

Returns:
the author name
Since:
3.3

Eclipse Platform
Release 3.3

Guidelines for using Eclipse APIs.

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