Package org.jdesktop.swingx.plaf
Class PromptTextUI
- java.lang.Object
-
- javax.swing.plaf.ComponentUI
-
- javax.swing.plaf.TextUI
-
- org.jdesktop.swingx.plaf.PromptTextUI
-
- Direct Known Subclasses:
PromptTextAreaUI
,PromptTextFieldUI
public abstract class PromptTextUI extends TextUI
Abstract
TextUI
class that delegates most work to anotherTextUI
and additionally renders a prompt text as specified in theJTextComponent
s client properties byPromptSupport
.Subclasses of this class must provide a prompt component used for rendering the prompt text.
- Author:
- Peter Weishapl
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description protected class
PromptTextUI.PainterHighlighter
-
Field Summary
Fields Modifier and Type Field Description protected TextUI
delegate
Delegate the hard work to this object.protected JTextComponent
promptComponent
This component ist painted when rendering the prompt text.
-
Constructor Summary
Constructors Constructor Description PromptTextUI(TextUI delegate)
Creates a newPromptTextUI
which delegates most work to anotherTextUI
.
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description boolean
contains(JComponent c, int x, int y)
protected abstract JTextComponent
createPromptComponent()
Creates a component which should be used to render the prompt text.void
damageRange(JTextComponent t, int p0, int p1)
void
damageRange(JTextComponent t, int p0, int p1, Position.Bias firstBias, Position.Bias secondBias)
boolean
equals(Object obj)
Accessible
getAccessibleChild(JComponent c, int i)
int
getAccessibleChildrenCount(JComponent c)
int
getBaseline(JComponent c, int width, int height)
Tries to callComponentUI#getBaseline(int, int)
on the delegate via Reflection.EditorKit
getEditorKit(JTextComponent t)
Dimension
getMaximumSize(JComponent c)
Dimension
getMinimumSize(JComponent c)
int
getNextVisualPositionFrom(JTextComponent t, int pos, Position.Bias b, int direction, Position.Bias[] biasRet)
Dimension
getPreferredSize(JComponent c)
WhenshouldPaintPrompt(JTextComponent)
returns true, the prompt component is retrieved by callinggetPromptComponent(JTextComponent)
and it's preferred size is returned.JTextComponent
getPromptComponent(JTextComponent txt)
Creates a label component, if none has already been created.View
getRootView(JTextComponent t)
String
getToolTipText(JTextComponent t, Point pt)
int
hashCode()
void
installUI(JComponent c)
Calls TextUI#installUI(JComponent) on the delegate and installs a focus listener onc
which repaints the component when it gains or loses the focus.Rectangle
modelToView(JTextComponent t, int pos)
Rectangle
modelToView(JTextComponent t, int pos, Position.Bias bias)
Delegate whenshouldPaintPrompt(JTextComponent)
returns false.void
paint(Graphics g, JComponent c)
Delegates painting whenshouldPaintPrompt(JTextComponent)
returns false.protected void
paintPromptComponent(Graphics g, JTextComponent txt)
boolean
shouldPaintPrompt(JTextComponent txt)
Returns if the prompt or the text field should be painted, depending on the state oftxt
.String
toString()
void
uninstallUI(JComponent c)
Delegates, then uninstalls the focus listener.void
update(Graphics g, JComponent c)
Calls super.update(Graphics, JComponent)
, which in turn calls the paint method of this object.int
viewToModel(JTextComponent t, Point pt)
int
viewToModel(JTextComponent t, Point pt, Position.Bias[] biasReturn)
-
Methods inherited from class javax.swing.plaf.TextUI
getToolTipText2D, modelToView2D, viewToModel2D
-
Methods inherited from class javax.swing.plaf.ComponentUI
createUI, getBaselineResizeBehavior
-
-
-
-
Field Detail
-
delegate
protected final TextUI delegate
Delegate the hard work to this object.
-
promptComponent
protected JTextComponent promptComponent
This component ist painted when rendering the prompt text.
-
-
Constructor Detail
-
PromptTextUI
public PromptTextUI(TextUI delegate)
Creates a newPromptTextUI
which delegates most work to anotherTextUI
.- Parameters:
delegate
-
-
-
Method Detail
-
createPromptComponent
protected abstract JTextComponent createPromptComponent()
Creates a component which should be used to render the prompt text.- Returns:
-
installUI
public void installUI(JComponent c)
Calls TextUI#installUI(JComponent) on the delegate and installs a focus listener onc
which repaints the component when it gains or loses the focus.- Overrides:
installUI
in classComponentUI
-
uninstallUI
public void uninstallUI(JComponent c)
Delegates, then uninstalls the focus listener.- Overrides:
uninstallUI
in classComponentUI
-
getPromptComponent
public JTextComponent getPromptComponent(JTextComponent txt)
Creates a label component, if none has already been created. Sets the prompt components properties to reflect the givenJTextComponent
s properties and returns it.- Parameters:
txt
-- Returns:
- the adjusted prompt component
-
getPreferredSize
public Dimension getPreferredSize(JComponent c)
WhenshouldPaintPrompt(JTextComponent)
returns true, the prompt component is retrieved by callinggetPromptComponent(JTextComponent)
and it's preferred size is returned. Otherwise supergetPreferredSize(JComponent)
is called.- Overrides:
getPreferredSize
in classComponentUI
-
paint
public void paint(Graphics g, JComponent c)
Delegates painting whenshouldPaintPrompt(JTextComponent)
returns false. Otherwise the prompt component is retrieved by callinggetPromptComponent(JTextComponent)
and painted. Then the caret of the given text component is painted.- Overrides:
paint
in classComponentUI
-
paintPromptComponent
protected void paintPromptComponent(Graphics g, JTextComponent txt)
-
shouldPaintPrompt
public boolean shouldPaintPrompt(JTextComponent txt)
Returns if the prompt or the text field should be painted, depending on the state oftxt
.- Parameters:
txt
-- Returns:
- true when
txt
contains not text, otherwise false
-
update
public void update(Graphics g, JComponent c)
Calls super.update(Graphics, JComponent)
, which in turn calls the paint method of this object.- Overrides:
update
in classComponentUI
-
modelToView
public Rectangle modelToView(JTextComponent t, int pos, Position.Bias bias) throws BadLocationException
Delegate whenshouldPaintPrompt(JTextComponent)
returns false. Otherwise get the prompt component's UI and delegate to it. This ensures that theCaret
is painted on the correct position (this is important when the text is centered, so that the caret will not be painted inside the label text)- Specified by:
modelToView
in classTextUI
- Throws:
BadLocationException
-
modelToView
public Rectangle modelToView(JTextComponent t, int pos) throws BadLocationException
- Specified by:
modelToView
in classTextUI
- Throws:
BadLocationException
-
contains
public boolean contains(JComponent c, int x, int y)
- Overrides:
contains
in classComponentUI
-
damageRange
public void damageRange(JTextComponent t, int p0, int p1, Position.Bias firstBias, Position.Bias secondBias)
- Specified by:
damageRange
in classTextUI
-
damageRange
public void damageRange(JTextComponent t, int p0, int p1)
- Specified by:
damageRange
in classTextUI
-
getAccessibleChild
public Accessible getAccessibleChild(JComponent c, int i)
- Overrides:
getAccessibleChild
in classComponentUI
-
getAccessibleChildrenCount
public int getAccessibleChildrenCount(JComponent c)
- Overrides:
getAccessibleChildrenCount
in classComponentUI
-
getEditorKit
public EditorKit getEditorKit(JTextComponent t)
- Specified by:
getEditorKit
in classTextUI
-
getMaximumSize
public Dimension getMaximumSize(JComponent c)
- Overrides:
getMaximumSize
in classComponentUI
-
getMinimumSize
public Dimension getMinimumSize(JComponent c)
- Overrides:
getMinimumSize
in classComponentUI
-
getNextVisualPositionFrom
public int getNextVisualPositionFrom(JTextComponent t, int pos, Position.Bias b, int direction, Position.Bias[] biasRet) throws BadLocationException
- Specified by:
getNextVisualPositionFrom
in classTextUI
- Throws:
BadLocationException
-
getRootView
public View getRootView(JTextComponent t)
- Specified by:
getRootView
in classTextUI
-
getToolTipText
public String getToolTipText(JTextComponent t, Point pt)
- Overrides:
getToolTipText
in classTextUI
-
viewToModel
public int viewToModel(JTextComponent t, Point pt, Position.Bias[] biasReturn)
- Specified by:
viewToModel
in classTextUI
-
viewToModel
public int viewToModel(JTextComponent t, Point pt)
- Specified by:
viewToModel
in classTextUI
-
getBaseline
public int getBaseline(JComponent c, int width, int height)
Tries to callComponentUI#getBaseline(int, int)
on the delegate via Reflection. Workaround to maintain compatibility with Java 5. Ideally we should also overrideComponentUI.getBaselineResizeBehavior(JComponent)
, but that's impossible since theComponent.BaselineResizeBehavior
class, which does not exist in Java 5, is involved.- Overrides:
getBaseline
in classComponentUI
- Returns:
- the baseline, or -2 if
getBaseline
could not be invoked on the delegate.
-
-