org.fife.ui.rsyntaxtextarea
Class WrappedSyntaxView

java.lang.Object
  extended by javax.swing.text.View
      extended by javax.swing.text.CompositeView
          extended by javax.swing.text.BoxView
              extended by org.fife.ui.rsyntaxtextarea.WrappedSyntaxView
All Implemented Interfaces:
SwingConstants, TabExpander

public class WrappedSyntaxView
extends BoxView
implements TabExpander

The view used by RSyntaxTextArea when word wrap is enabled.

This class is a work-in-progress and will eventually replace WrappedSyntaxView (which works, but ignores token styles).

Version:
0.2
Author:
Robert Futrell

Field Summary
 
Fields inherited from class javax.swing.text.View
BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS
 
Fields inherited from interface javax.swing.SwingConstants
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
 
Constructor Summary
WrappedSyntaxView(Element elem)
          Creates a new WrappedSyntaxView.
 
Method Summary
protected  int calculateBreakPosition(int p0, Token tokenList, float x0)
          This is called by the nested wrapped line views to determine the break location.
 void changedUpdate(DocumentEvent e, Shape a, ViewFactory f)
          Gives notification from the document that attributes were changed in a location that this view is responsible for.
protected  void drawView(Graphics2D g, Rectangle r, View view, int fontHeight, int y)
          Draws a single view (i.e., a line of text for a wrapped view), wrapping the text onto multiple lines if necessary.
 float getMaximumSpan(int axis)
          Determines the maximum span for this view along an axis.
 float getMinimumSpan(int axis)
          Determines the minimum span for this view along an axis.
 float getPreferredSpan(int axis)
          Determines the preferred span for this view along an axis.
protected  int getTabSize()
          Returns the tab size set for the document, defaulting to 5.
 void insertUpdate(DocumentEvent changes, Shape a, ViewFactory f)
          Gives notification that something was inserted into the document in a location that this view is responsible for.
protected  void loadChildren(ViewFactory f)
          Loads all of the children to initialize the view.
 Shape modelToView(int p0, Position.Bias b0, int p1, Position.Bias b1, Shape a)
          Provides a mapping, for a given region, from the document model coordinate space to the view coordinate space.
 float nextTabStop(float x, int tabOffset)
          Returns the next tab stop position after a given reference position.
 void paint(Graphics g, Shape a)
          Paints the word-wrapped text.
 void removeUpdate(DocumentEvent changes, Shape a, ViewFactory f)
          Gives notification that something was removed from the document in a location that this view is responsible for.
 void setSize(float width, float height)
          Sets the size of the view.
 int yForLineContaining(Rectangle alloc, int offs)
          Returns the y-coordinate of the line containing a specified offset.
 
Methods inherited from class javax.swing.text.BoxView
baselineLayout, baselineRequirements, calculateMajorAxisRequirements, calculateMinorAxisRequirements, childAllocation, flipEastAndWestAtEnds, forwardUpdate, getAlignment, getAxis, getChildAllocation, getHeight, getOffset, getResizeWeight, getSpan, getViewAtPoint, getWidth, isAfter, isAllocationValid, isBefore, isLayoutValid, layout, layoutChanged, layoutMajorAxis, layoutMinorAxis, modelToView, paintChild, preferenceChanged, replace, setAxis, viewToModel
 
Methods inherited from class javax.swing.text.CompositeView
getBottomInset, getInsideAllocation, getLeftInset, getNextEastWestVisualPositionFrom, getNextNorthSouthVisualPositionFrom, getNextVisualPositionFrom, getRightInset, getTopInset, getView, getViewAtPosition, getViewCount, getViewIndex, getViewIndexAtPosition, setInsets, setParagraphInsets, setParent
 
Methods inherited from class javax.swing.text.View
append, breakView, createFragment, forwardUpdateToView, getAttributes, getBreakWeight, getContainer, getDocument, getElement, getEndOffset, getGraphics, getParent, getStartOffset, getToolTipText, getViewFactory, getViewIndex, insert, isVisible, modelToView, remove, removeAll, updateChildren, updateLayout, viewToModel
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

WrappedSyntaxView

public WrappedSyntaxView(Element elem)
Creates a new WrappedSyntaxView. Lines will be wrapped on character boundaries.

Parameters:
elem - the element underlying the view
Method Detail

calculateBreakPosition

protected int calculateBreakPosition(int p0,
                                     Token tokenList,
                                     float x0)
This is called by the nested wrapped line views to determine the break location. This can be reimplemented to alter the breaking behavior. It will either break at word or character boundaries depending upon the break argument given at construction.


changedUpdate

public void changedUpdate(DocumentEvent e,
                          Shape a,
                          ViewFactory f)
Gives notification from the document that attributes were changed in a location that this view is responsible for.

Overrides:
changedUpdate in class View
Parameters:
e - the change information from the associated document
a - the current allocation of the view
f - the factory to use to rebuild if the view has children
See Also:
View.changedUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)

drawView

protected void drawView(Graphics2D g,
                        Rectangle r,
                        View view,
                        int fontHeight,
                        int y)
Draws a single view (i.e., a line of text for a wrapped view), wrapping the text onto multiple lines if necessary.

Parameters:
g - The graphics context in which to paint.
r - The rectangle in which to paint.
view - The View to paint.
fontHeight - The height of the font being used.
y - The y-coordinate at which to begin painting.

getMaximumSpan

public float getMaximumSpan(int axis)
Determines the maximum span for this view along an axis. This is implemented to provide the superclass behavior after first making sure that the current font metrics are cached (for the nested lines which use the metrics to determine the height of the potentially wrapped lines).

Overrides:
getMaximumSpan in class BoxView
Parameters:
axis - may be either View.X_AXIS or View.Y_AXIS
Returns:
the span the view would like to be rendered into. Typically the view is told to render into the span that is returned, although there is no guarantee. The parent may choose to resize or break the view.
See Also:
View.getMaximumSpan(int)

getMinimumSpan

public float getMinimumSpan(int axis)
Determines the minimum span for this view along an axis. This is implemented to provide the superclass behavior after first making sure that the current font metrics are cached (for the nested lines which use the metrics to determine the height of the potentially wrapped lines).

Overrides:
getMinimumSpan in class BoxView
Parameters:
axis - may be either View.X_AXIS or View.Y_AXIS
Returns:
the span the view would like to be rendered into. Typically the view is told to render into the span that is returned, although there is no guarantee. The parent may choose to resize or break the view.
See Also:
View.getMinimumSpan(int)

getPreferredSpan

public float getPreferredSpan(int axis)
Determines the preferred span for this view along an axis. This is implemented to provide the superclass behavior after first making sure that the current font metrics are cached (for the nested lines which use the metrics to determine the height of the potentially wrapped lines).

Overrides:
getPreferredSpan in class BoxView
Parameters:
axis - may be either View.X_AXIS or View.Y_AXIS
Returns:
the span the view would like to be rendered into. Typically the view is told to render into the span that is returned, although there is no guarantee. The parent may choose to resize or break the view.
See Also:
View.getPreferredSpan(int)

getTabSize

protected int getTabSize()
Returns the tab size set for the document, defaulting to 5.

Returns:
the tab size

insertUpdate

public void insertUpdate(DocumentEvent changes,
                         Shape a,
                         ViewFactory f)
Gives notification that something was inserted into the document in a location that this view is responsible for. This is implemented to simply update the children.

Overrides:
insertUpdate in class View
Parameters:
changes - The change information from the associated document.
a - the current allocation of the view
f - the factory to use to rebuild if the view has children
See Also:
View.insertUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)

loadChildren

protected void loadChildren(ViewFactory f)
Loads all of the children to initialize the view. This is called by the setParent method. Subclasses can re-implement this to initialize their child views in a different manner. The default implementation creates a child view for each child element.

Overrides:
loadChildren in class CompositeView
Parameters:
f - the view factory

modelToView

public Shape modelToView(int p0,
                         Position.Bias b0,
                         int p1,
                         Position.Bias b1,
                         Shape a)
                  throws BadLocationException
Provides a mapping, for a given region, from the document model coordinate space to the view coordinate space. The specified region is created as a union of the first and last character positions.

This is implemented to subtract the width of the second character, as this view's modelToView actually returns the width of the character instead of "1" or "0" like the View implementations in javax.swing.text. Thus, if we don't override this method, the View implementation will return one character's width too much for its consumers (implementations of javax.swing.text.Highlighter).

Overrides:
modelToView in class CompositeView
Parameters:
p0 - the position of the first character (>=0)
b0 - The bias of the first character position, toward the previous character or the next character represented by the offset, in case the position is a boundary of two views; b0 will have one of these values:
  • Position.Bias.Forward
  • Position.Bias.Backward
p1 - the position of the last character (>=0)
b1 - the bias for the second character position, defined one of the legal values shown above
a - the area of the view, which encompasses the requested region
Returns:
the bounding box which is a union of the region specified by the first and last character positions
Throws:
BadLocationException - if the given position does not represent a valid location in the associated document
IllegalArgumentException - if b0 or b1 are not one of the legal Position.Bias values listed above
See Also:
View.viewToModel(float, float, java.awt.Shape, javax.swing.text.Position.Bias[])

nextTabStop

public float nextTabStop(float x,
                         int tabOffset)
Returns the next tab stop position after a given reference position. This implementation does not support things like centering so it ignores the tabOffset argument.

Specified by:
nextTabStop in interface TabExpander
Parameters:
x - the current position >= 0
tabOffset - the position within the text stream that the tab occurred at >= 0.
Returns:
the tab stop, measured in points >= 0

paint

public void paint(Graphics g,
                  Shape a)
Paints the word-wrapped text.

Overrides:
paint in class BoxView
Parameters:
g - The graphics context in which to paint.
a - The shape (usually a rectangle) in which to paint.

removeUpdate

public void removeUpdate(DocumentEvent changes,
                         Shape a,
                         ViewFactory f)
Gives notification that something was removed from the document in a location that this view is responsible for. This is implemented to simply update the children.

Overrides:
removeUpdate in class View
Parameters:
changes - The change information from the associated document.
a - the current allocation of the view
f - the factory to use to rebuild if the view has children
See Also:
View.removeUpdate(javax.swing.event.DocumentEvent, java.awt.Shape, javax.swing.text.ViewFactory)

setSize

public void setSize(float width,
                    float height)
Sets the size of the view. This should cause layout of the view along the given axis, if it has any layout duties.

Overrides:
setSize in class BoxView
Parameters:
width - the width >= 0
height - the height >= 0

yForLineContaining

public int yForLineContaining(Rectangle alloc,
                              int offs)
                       throws BadLocationException
Returns the y-coordinate of the line containing a specified offset.

This method is quicker than using traditional modelToView(int) calls, as the entire bounding box isn't computed.

Parameters:
alloc - The area the text area can render into.
offs - The offset info the document.
Returns:
The y-coordinate of the top of the offset, or -1 if this text area doesn't yet have a positive size.
Throws:
BadLocationException - If offs isn't a valid offset into the document.