- java.lang.Object
-
- javax.swing.plaf.ComponentUI
-
- javax.swing.plaf.TextUI
-
- Direct Known Subclasses:
- BasicTextUI, MultiTextUI
public abstract class TextUI extends ComponentUI
Text editor user interface
-
-
Constructor Summary
Constructors Constructor and Description TextUI()
-
Method Summary
Methods Modifier and Type Method and Description abstract void
damageRange(JTextComponent t, int p0, int p1)
Causes the portion of the view responsible for the given part of the model to be repainted.abstract void
damageRange(JTextComponent t, int p0, int p1, Position.Bias firstBias, Position.Bias secondBias)
Causes the portion of the view responsible for the given part of the model to be repainted.abstract EditorKit
getEditorKit(JTextComponent t)
Fetches the binding of services that set a policy for the type of document being edited.abstract int
getNextVisualPositionFrom(JTextComponent t, int pos, Position.Bias b, int direction, Position.Bias[] biasRet)
Provides a way to determine the next visually represented model location that one might place a caret.abstract View
getRootView(JTextComponent t)
Fetches a View with the allocation of the associated text component (i.e.String
getToolTipText(JTextComponent t, Point pt)
Returns the string to be used as the tooltip at the passed in location.abstract Rectangle
modelToView(JTextComponent t, int pos)
Converts the given location in the model to a place in the view coordinate system.abstract Rectangle
modelToView(JTextComponent t, int pos, Position.Bias bias)
Converts the given location in the model to a place in the view coordinate system.abstract int
viewToModel(JTextComponent t, Point pt)
Converts the given place in the view coordinate system to the nearest representative location in the model.abstract int
viewToModel(JTextComponent t, Point pt, Position.Bias[] biasReturn)
Provides a mapping from the view coordinate space to the logical coordinate space of the model.-
Methods inherited from class javax.swing.plaf.ComponentUI
contains, createUI, getAccessibleChild, getAccessibleChildrenCount, getBaseline, getBaselineResizeBehavior, getMaximumSize, getMinimumSize, getPreferredSize, installUI, paint, uninstallUI, update
-
-
-
-
Method Detail
-
modelToView
public abstract Rectangle modelToView(JTextComponent t, int pos) throws BadLocationException
Converts the given location in the model to a place in the view coordinate system.- Parameters:
pos
- the local location in the model to translate >= 0- Returns:
- the coordinates as a rectangle
- Throws:
BadLocationException
- if the given position does not represent a valid location in the associated document
-
modelToView
public abstract Rectangle modelToView(JTextComponent t, int pos, Position.Bias bias) throws BadLocationException
Converts the given location in the model to a place in the view coordinate system.- Parameters:
pos
- the local location in the model to translate >= 0- Returns:
- the coordinates as a rectangle
- Throws:
BadLocationException
- if the given position does not represent a valid location in the associated document
-
viewToModel
public abstract int viewToModel(JTextComponent t, Point pt)
Converts the given place in the view coordinate system to the nearest representative location in the model.- Parameters:
pt
- the location in the view to translate. This should be in the same coordinate system as the mouse events.- Returns:
- the offset from the start of the document >= 0
-
viewToModel
public abstract int viewToModel(JTextComponent t, Point pt, Position.Bias[] biasReturn)
Provides a mapping from the view coordinate space to the logical coordinate space of the model.- Parameters:
pt
- the location in the view to translate. This should be in the same coordinate system as the mouse events.biasReturn
- filled in by this method to indicate whether the point given is closer to the previous or the next character in the model- Returns:
- the location within the model that best represents the given point in the view >= 0
-
getNextVisualPositionFrom
public abstract int getNextVisualPositionFrom(JTextComponent t, int pos, Position.Bias b, int direction, Position.Bias[] biasRet) throws BadLocationException
Provides a way to determine the next visually represented model location that one might place a caret. Some views may not be visible, they might not be in the same order found in the model, or they just might not allow access to some of the locations in the model.- Parameters:
t
- the text component for which this UI is installedpos
- the position to convert >= 0b
- the bias for the positiondirection
- the direction from the current position that can be thought of as the arrow keys typically found on a keyboard. This may be SwingConstants.WEST, SwingConstants.EAST, SwingConstants.NORTH, or SwingConstants.SOUTHbiasRet
- an array to contain the bias for the returned position- Returns:
- the location within the model that best represents the next location visual position
- Throws:
BadLocationException
IllegalArgumentException
- for an invalid direction
-
damageRange
public abstract void damageRange(JTextComponent t, int p0, int p1)
Causes the portion of the view responsible for the given part of the model to be repainted.- Parameters:
p0
- the beginning of the range >= 0p1
- the end of the range >= p0
-
damageRange
public abstract void damageRange(JTextComponent t, int p0, int p1, Position.Bias firstBias, Position.Bias secondBias)
Causes the portion of the view responsible for the given part of the model to be repainted.- Parameters:
p0
- the beginning of the range >= 0p1
- the end of the range >= p0
-
getEditorKit
public abstract EditorKit getEditorKit(JTextComponent t)
Fetches the binding of services that set a policy for the type of document being edited. This contains things like the commands available, stream readers and writers, etc.- Returns:
- the editor kit binding
-
getRootView
public abstract View getRootView(JTextComponent t)
Fetches a View with the allocation of the associated text component (i.e. the root of the hierarchy) that can be traversed to determine how the model is being represented spatially.- Returns:
- the view
-
getToolTipText
public String getToolTipText(JTextComponent t, Point pt)
Returns the string to be used as the tooltip at the passed in location.- Since:
- 1.4
- See Also:
JTextComponent.getToolTipText(java.awt.event.MouseEvent)
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-javax/swing/plaf/textui.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.