javax.swing.plaf

Class TextUI

java.lang.Object

javax.swing.plaf.ComponentUI

javax.swing.plaf.TextUI

Direct Known Subclasses:

BasicTextUI, MultiTextUI

public abstract class TextUI
extends ComponentUI

An abstract base class for delegates that provide the user interface for text editors.

See Also:

JTextComponent

Constructor Summary

Constructors

Constructor and Description
TextUI() Constructs a new TextUI.

Method Summary

Methods

Modifier and Type	Method and Description
abstract void	damageRange(JTextComponent tc, int start, int end) Repaints a range of characters.
abstract void	damageRange(JTextComponent tc, int start, int end, Position.Bias startBias, Position.Bias endBias) Repaints a range of characters, also specifying the bias for the start and end of the range.
abstract EditorKit	getEditorKit(JTextComponent tc) Retrieves the EditorKit managing policies and persistent state.
abstract int	getNextVisualPositionFrom(JTextComponent tc, int pos, Position.Bias bias, int direction, Position.Bias[] outBias) Calculates the caret position that is visually next to the given position.
abstract View	getRootView(JTextComponent tc) Retrieves the root of the view tree that visually presents the text.
String	getToolTipText(JTextComponent tc, Point loc) Returns a String for presenting a tool tip at the specified location.
abstract Rectangle	modelToView(JTextComponent tc, int pos) Calculates the geometric extent of the character at the given offset.
abstract Rectangle	modelToView(JTextComponent tc, int pos, Position.Bias bias) Calculates the geometric extent of the character at the given offset.
abstract int	viewToModel(JTextComponent t, Point pt) Finds the caret position which is closest to the specified visual location.
abstract int	viewToModel(JTextComponent tc, Point loc, Position.Bias[] outBias) Finds the caret position which is closest to the specified visual location.

Methods inherited from class javax.swing.plaf.ComponentUI

contains, createUI, getAccessibleChild, getAccessibleChildrenCount, getMaximumSize, getMinimumSize, getPreferredSize, installUI, paint, uninstallUI, update

Methods inherited from class java.lang.Object

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

Constructor Detail

TextUI

public TextUI()

Constructs a new TextUI.

Method Detail

modelToView

public abstract Rectangle modelToView(JTextComponent tc,
                    int pos)
                               throws BadLocationException

Calculates the geometric extent of the character at the given offset.

Parameters:

tc - the JTextComponent for which this delegate object provides the user interface.

pos - the zero-based index of the character into the document model.

Returns:

the bounding box of the character at index pos, in view coordinates.

Throws:

BadLocationException - if pos does not designate a valid position in the document model.

See Also:

ComponentView.modelToView(int, Shape, Position.Bias)

modelToView

public abstract Rectangle modelToView(JTextComponent tc,
                    int pos,
                    Position.Bias bias)
                               throws BadLocationException

Calculates the geometric extent of the character at the given offset.

Parameters:

tc - the JTextComponent for which this delegate object provides the user interface.

pos - the zero-based index of the character into the document model.

bias - whether to take the character before or after the caret position indicated by pos. The value must be either Position.Bias.Backward or Position.Bias.Forward.

Returns:

the bounding box of the character at index pos, in view coordinates.

Throws:

BadLocationException - if pos does not designate a valid position in the document model.

See Also:

ComponentView.modelToView(int, Shape, Position.Bias)

viewToModel

public abstract int viewToModel(JTextComponent t,
              Point pt)

Finds the caret position which is closest to the specified visual location.

Parameters:

t - the JTextComponent for which this delegate object provides the user interface.

pt - the position in view coordinates.

Returns:

the caret position which is closest to loc.

See Also:

viewToModel(JTextComponent, Point, Position.Bias[])

viewToModel

public abstract int viewToModel(JTextComponent tc,
              Point loc,
              Position.Bias[] outBias)

Finds the caret position which is closest to the specified visual location.

Parameters:

tc - the JTextComponent for which this delegate object provides the user interface.

loc - the position in view coordinates.

outBias - an array whose size must be at least one. After the call, outBias[0] will indicate whether loc is in the glyph before (Position.Bias.Backward) or after (Position.Bias.Forward) the returned caret position.

Returns:

the caret position which is closest to loc.

getNextVisualPositionFrom

public abstract int getNextVisualPositionFrom(JTextComponent tc,
                            int pos,
                            Position.Bias bias,
                            int direction,
                            Position.Bias[] outBias)
                                       throws BadLocationException

Calculates the caret position that is visually next to the given position. This is useful to determine where to move the caret after the user has pressed an arrow key.

Parameters:

tc - the JTextComponent for which this delegate object provides the user interface.

pos - the current caret position, a zero-based index into the document model.

bias - whether to take the character before or after the caret position indicated by pos. The value must be either Position.Bias.Backward or Position.Bias.Forward.

direction - the visual direction. Pass SwingConstants.WEST for the left arrow key, SwingConstants.EAST for the right arrow key, SwingConstants.NORTH for the up arrow key, or SwingConstants.SOUTH for the down arrow key.

Throws:

BadLocationException - if pos does not designate a valid position in the document model.

IllegalArgumentException - if direction is not one of Position.Bias.Forward or Position.Bias.Backward.

damageRange

public abstract void damageRange(JTextComponent tc,
               int start,
               int end)

Repaints a range of characters.

Parameters:

tc - the JTextComponent for which this delegate object provides the user interface.

start - the first character in the range that needs painting, indicated as an index into the document model.

end - the last character in the range that needs painting, indicated as an index into the document model. end must be greater than or equal to start.

damageRange

public abstract void damageRange(JTextComponent tc,
               int start,
               int end,
               Position.Bias startBias,
               Position.Bias endBias)

Repaints a range of characters, also specifying the bias for the start and end of the range.

Parameters:

tc - the JTextComponent for which this delegate object provides the user interface.

start - the first character in the range that needs painting, indicated as an index into the document model.

end - the last character in the range that needs painting, indicated as an index into the document model. end must be greater than or equal to start.

getEditorKit

public abstract EditorKit getEditorKit(JTextComponent tc)

Retrieves the EditorKit managing policies and persistent state.

Parameters:

tc - the JTextComponent for which this delegate object provides the user interface.

Returns:

the EditorKit used by tc.

getRootView

public abstract View getRootView(JTextComponent tc)

Retrieves the root of the view tree that visually presents the text.

Parameters:

tc - the JTextComponent for which this delegate object provides the user interface.

Returns:

the root View used by tc.

getToolTipText

public String getToolTipText(JTextComponent tc,
                    Point loc)

Returns a String for presenting a tool tip at the specified location.

Parameters:

tc - the JTextComponent for which this delegate object provides the user interface.

loc - the location for which the tool tip is requested.

Returns:

the text for the tool tip, or null to display no tool tip.

Since:

1.4