Package org.eclipse.jface.text.revisions
Class Revision
java.lang.Object
org.eclipse.jface.text.revisions.Revision
Describes a revision of a document. A revision consists of one ore more
ILineRange
s.
Clients may subclass.
- Since:
- 3.2
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionfinal void
addRange
(ILineRange range) Adds a line range to this revision.Returns the display string for the author of this revision.abstract RGB
getColor()
Returns the author color for this revision.abstract Date
getDate()
Returns the modification date of this revision.abstract Object
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.final List<RevisionRange>
Returns the containedRevisionRange
s adapted to the current diff state.toString()
-
Constructor Details
-
Revision
protected Revision()Creates a new revision.
-
-
Method Details
-
addRange
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
Returns the containedRevisionRange
s 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
-
getHoverInfo
Returns the hover information that will be shown when the user hovers over the a change region of this revision.Note: The hover information control which is used to display the information must be able process the given object. If the default information control creator is used the supported format is simple text, full HTML or an HTML fragment.
- Returns:
- the hover information for this revision or
null
for no hover - See Also:
-
getColor
Returns the author color for this revision. This color can be used to visually distinguish one revision from another, for example as background color.Revisions from the same author must return the same color and revisions from different authors must return distinct colors.
- Returns:
- the RGB color for this revision's author
-
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
Returns the modification date of this revision.- Returns:
- the modification date of this revision
-
toString
-
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
-