org.eclipse.draw2d.text
Class TextFlow

java.lang.Object
  org.eclipse.draw2d.Figure
      org.eclipse.draw2d.text.FlowFigure
          org.eclipse.draw2d.text.InlineFlow
              org.eclipse.draw2d.text.TextFlow

All Implemented Interfaces:

IFigure

public class TextFlow

extends InlineFlow

An inline flow that renders a sting of text across one or more lines. A TextFlow must not have any children. It does not provide a FlowContext.

WARNING: This class is not intended to be subclassed by clients.

Since:

2.1

Nested Class Summary

Nested classes inherited from class org.eclipse.draw2d.Figure

Figure.FigureIterator, Figure.IdentitySearch

Nested classes inherited from class org.eclipse.draw2d.IFigure

IFigure.NoInsets

Field Summary

Fields inherited from class org.eclipse.draw2d.Figure

bgColor, border, bounds, fgColor, flags, font, MAX_FLAG, maxSize, minSize, NO_MANAGER, prefSize, toolTip

Fields inherited from interface org.eclipse.draw2d.IFigure

MAX_DIMENSION, MIN_DIMENSION, NO_INSETS

Constructor Summary

TextFlow()
Constructs a new TextFlow with the empty String.

TextFlow(String s)
Constructs a new TextFlow with the specified String.

Method Summary

protected FlowFigureLayout	createDefaultFlowLayout() Creates the default layout manager
Rectangle	getCaretPlacement(int offset) Returns the rectangular bounds for placing a Caret at the given offset.
int	getFirstOffsetForLine(int y) Returns the first caret position which occupies the line at the given y location.
int	getLastOffsetForLine(int y) Returns the last caret position which occupies the line at the given y location.
int	getNextOffset(Point p, boolean down) Returns the offset nearest the given point either up or down one line.
int	getOffset(Point p) Returns the textual offset nearest the specified point.
String	getText()
boolean	isTextTruncated() Returns true if a portion if the text is truncated using ellipses ("...").
protected void	paintFigure(Graphics g) Paints this Figure's primary representation, or background.
void	setSelection(int begin, int end) Sets the extent of selection.
void	setText(String s) Sets the string being displayed.

Methods inherited from class org.eclipse.draw2d.text.InlineFlow

containsPoint, getFragments, postValidate

Methods inherited from class org.eclipse.draw2d.text.FlowFigure

add, setBounds, setFlowContext

Methods inherited from class org.eclipse.draw2d.Figure

add, add, add, addAncestorListener, addCoordinateListener, addFigureListener, addFocusListener, addKeyListener, addLayoutListener, addListener, addMouseListener, addMouseMotionListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, containsPoint, erase, findDescendantAtExcluding, findFigureAt, findFigureAt, findFigureAt, findFigureAtExcluding, findMouseEventTargetAt, findMouseEventTargetInDescendantsAt, fireCoordinateSystemChanged, fireFigureMoved, fireMoved, firePropertyChange, firePropertyChange, firePropertyChange, getBackgroundColor, getBorder, getBounds, getChildren, getClientArea, getClientArea, getCursor, getFlag, getFont, getForegroundColor, getInsets, getLayoutManager, getListeners, getLocalBackgroundColor, getLocalForegroundColor, getLocation, getMaximumSize, getMinimumSize, getMinimumSize, getParent, getPreferredSize, getPreferredSize, getSize, getToolTip, getUpdateManager, handleFocusGained, handleFocusLost, handleKeyPressed, handleKeyReleased, handleMouseDoubleClicked, handleMouseDragged, handleMouseEntered, handleMouseExited, handleMouseHover, handleMouseMoved, handleMousePressed, handleMouseReleased, hasFocus, internalGetEventDispatcher, intersects, invalidate, invalidateTree, isCoordinateSystem, isEnabled, isFocusTraversable, isMouseEventTarget, isOpaque, isRequestFocusEnabled, isShowing, isValid, isValidationRoot, isVisible, layout, paint, paintBorder, paintChildren, paintClientArea, primTranslate, remove, removeAll, removeAncestorListener, removeCoordinateListener, removeFigureListener, removeFocusListener, removeKeyListener, removeLayoutListener, removeListener, removeMouseListener, removeMouseMotionListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, revalidate, setBackgroundColor, setBorder, setChildrenDirection, setChildrenEnabled, setChildrenOrientation, setConstraint, setCursor, setEnabled, setFlag, setFocusTraversable, setFont, setForegroundColor, setLayoutManager, setLocation, setMaximumSize, setMinimumSize, setOpaque, setParent, setPreferredSize, setPreferredSize, setRequestFocusEnabled, setSize, setSize, setToolTip, setValid, setVisible, translate, translateFromParent, translateToAbsolute, translateToParent, translateToRelative, useLocalCoordinates, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TextFlow

public TextFlow()

Constructs a new TextFlow with the empty String.

See Also:

Object.Object()

TextFlow

public TextFlow(String s)

Constructs a new TextFlow with the specified String.

Parameters:

s - the string

Method Detail

createDefaultFlowLayout

protected FlowFigureLayout createDefaultFlowLayout()

Description copied from class: FlowFigure

Creates the default layout manager

Overrides:

createDefaultFlowLayout in class InlineFlow

See Also:

InlineFlow.createDefaultFlowLayout()

getNextOffset

public int getNextOffset(Point p,
                         boolean down)

Returns the offset nearest the given point either up or down one line. If no offset is found, -1 is returned.

Parameters:

p - a reference point

down - true if the search is down

Returns:

the next offset or -1

Since:

3.1

getCaretPlacement

public Rectangle getCaretPlacement(int offset)

Returns the rectangular bounds for placing a Caret at the given offset. The offset must be between 0 and the length of the String being displayed.

Parameters:

offset - the location in this figures text

Returns:

the caret bounds relative to this figure

Throws:

IllegalArgumentException - If the offset is not between 0 and the length of the string inclusively

Since:

3.1

getFirstOffsetForLine

public int getFirstOffsetForLine(int y)

Returns the first caret position which occupies the line at the given y location. The y location is relative to this figure. If no fragment occupies that y coordinate, -1 is returned.

Parameters:

y - the baseline's y coordinate

Returns:

-1 of the first offset at the given baseline

Since:

3.1

getLastOffsetForLine

public int getLastOffsetForLine(int y)

Returns the last caret position which occupies the line at the given y location. The y location is relative to this figure. If no fragment occupies that y coordinate, -1 is returned.

Parameters:

y - the baseline's y coordinate

Returns:

-1 of the last offset at the given baseline

Since:

3.1

getOffset

public int getOffset(Point p)

Returns the textual offset nearest the specified point. The must be relative to this figure. If the point is not inside any fragment, -1 is returned. Otherwise the offset will be between 0 and getText().length() inclusively.

Parameters:

p - a point relative to this figure

Returns:

the offset in the string or -1

Since:

3.1

getText

public String getText()

Returns:

the String being displayed

isTextTruncated

public boolean isTextTruncated()

Returns true if a portion if the text is truncated using ellipses ("...").

Returns:

true if the text is truncated with ellipses

paintFigure

protected void paintFigure(Graphics g)

Description copied from class: Figure

Paints this Figure's primary representation, or background. Changes made to the graphics to the graphics current state will not affect the subsequent calls to Figure.paintClientArea(Graphics) and Figure.paintBorder(Graphics). Furthermore, it is safe to call graphics.restoreState() within this method, and doing so will restore the graphics to its original state upon entry.

Overrides:

paintFigure in class FlowFigure

See Also:

Figure.paintFigure(Graphics)

setSelection

public void setSelection(int begin,
                         int end)

Sets the extent of selection. The selection range is inclusive. For example, the range [0, 0] indicates that the first character is selected.

Parameters:

begin - the begin offset

end - the end offset

Since:

3.1

setText

public void setText(String s)

Sets the string being displayed. Causes a revalidate() to occur.

Parameters:

s - The new String. It cannot be null.