|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.text.JTextComponent
public abstract class JTextComponent
Nested Class Summary | |
---|---|
class |
JTextComponent.AccessibleJTextComponent
AccessibleJTextComponent implements accessibility hooks for JTextComponent. |
static class |
JTextComponent.KeyBinding
|
Nested classes/interfaces inherited from class javax.swing.JComponent |
---|
JComponent.AccessibleJComponent |
Nested classes/interfaces inherited from class java.awt.Container |
---|
Container.AccessibleAWTContainer |
Nested classes/interfaces inherited from class java.awt.Component |
---|
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy |
Field Summary | |
---|---|
static String |
DEFAULT_KEYMAP
|
static String |
FOCUS_ACCELERATOR_KEY
|
Fields inherited from class javax.swing.JComponent |
---|
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW |
Fields inherited from class java.awt.Component |
---|
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT |
Fields inherited from interface java.awt.image.ImageObserver |
---|
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH |
Constructor Summary | |
---|---|
JTextComponent()
Creates a new JTextComponent instance. |
Method Summary | |
---|---|
void |
addCaretListener(CaretListener listener)
Adds a CaretListener object to this text component. |
void |
addInputMethodListener(InputMethodListener listener)
Adds an InputListener object to this text component. |
static Keymap |
addKeymap(String n,
Keymap parent)
Create a new Keymap with a specific name and parent, and add the new Keymap to the global keymap table. |
void |
copy()
|
void |
cut()
|
protected void |
fireCaretUpdate(CaretEvent event)
Notifies all registered CaretListener objects that the caret
was updated. |
AccessibleContext |
getAccessibleContext()
Get the AccessibleContext of this object. |
Action[] |
getActions()
Returns the set of available Actions this component's associated editor can run. |
Caret |
getCaret()
The Caret object used in this text component. |
Color |
getCaretColor()
|
CaretListener[] |
getCaretListeners()
Returns all added CaretListener objects. |
int |
getCaretPosition()
Retrisves the current caret position. |
Color |
getDisabledTextColor()
|
Document |
getDocument()
|
boolean |
getDragEnabled()
|
char |
getFocusAccelerator()
|
Highlighter |
getHighlighter()
|
InputMethodListener[] |
getInputMethodListeners()
Returns all added InputMethodListener objects. |
Keymap |
getKeymap()
Get the current Keymap of this component. |
static Keymap |
getKeymap(String n)
Get a Keymap from the global keymap table, by name. |
Insets |
getMargin()
|
NavigationFilter |
getNavigationFilter()
|
Dimension |
getPreferredScrollableViewportSize()
|
int |
getScrollableBlockIncrement(Rectangle visible,
int orientation,
int direction)
Return the preferred scrolling amount (in pixels) for the given scrolling direction and orientation when scrolling in large amounts (pages). |
boolean |
getScrollableTracksViewportHeight()
Return true if the height of the scrollable is always equal to the view, where it is displayed, height.In such case, the vertical scrolling should not be performed. |
boolean |
getScrollableTracksViewportWidth()
Return true if the width of the scrollable is always equal to the view, where it is displayed, width (for instance, the text area with the word wrap). |
int |
getScrollableUnitIncrement(Rectangle visible,
int orientation,
int direction)
Return the preferred scrolling amount (in pixels) for the given scrolling direction and orientation when scrolling in small amounts like table lines. |
String |
getSelectedText()
Retrieves the currently selected text in this text document. |
Color |
getSelectedTextColor()
|
Color |
getSelectionColor()
|
int |
getSelectionEnd()
Returns the end postion of the currently selected text. |
int |
getSelectionStart()
Returns the start postion of the currently selected text. |
String |
getText()
Retrieves the current text in this text document. |
String |
getText(int offset,
int length)
Retrieves a part of the current text in this document. |
String |
getToolTipText(MouseEvent ev)
Returns the tooltip text for this text component for the given mouse event. |
TextUI |
getUI()
This method returns the label's UI delegate. |
String |
getUIClassID()
Returns a string that specifies the name of the Look and Feel class that renders this component. |
boolean |
isEditable()
Checks whether this text component it editable. |
static void |
loadKeymap(Keymap map,
JTextComponent.KeyBinding[] bindings,
Action[] actions)
Resolves a set of bindings against a set of actions and inserts the results into a Keymap . |
Rectangle |
modelToView(int position)
|
void |
moveCaretPosition(int position)
Moves the caret to a given position. |
protected String |
paramString()
Returns a string representation of this JTextComponent. |
void |
paste()
|
void |
read(Reader input,
Object streamDescription)
Read and set the content this component. |
void |
removeCaretListener(CaretListener listener)
Removed a CaretListener object from this text component. |
void |
removeInputMethodListener(InputMethodListener listener)
Removes an InputListener object from this text component. |
static Keymap |
removeKeymap(String n)
Remove a Keymap from the global Keymap table, by name. |
void |
replaceSelection(String content)
|
void |
select(int start,
int end)
Selects a part of the content of the text component. |
void |
selectAll()
Selects the whole content of the text component. |
void |
setCaret(Caret newCaret)
Sets a new Caret for this text component. |
void |
setCaretColor(Color newColor)
|
void |
setCaretPosition(int position)
Sets the caret to a new position. |
void |
setDisabledTextColor(Color newColor)
|
void |
setDocument(Document newDoc)
|
void |
setDragEnabled(boolean enabled)
|
void |
setEditable(boolean newValue)
Enables/disabled this text component's editability. |
void |
setFocusAccelerator(char newKey)
|
void |
setHighlighter(Highlighter newHighlighter)
|
void |
setKeymap(Keymap k)
Set the current Keymap of this component, installing appropriate KeymapWrapper and KeymapActionMap objects in the
InputMap and ActionMap parent chains, respectively,
and fire a property change event with name "keymap" . |
void |
setMargin(Insets m)
|
void |
setNavigationFilter(NavigationFilter filter)
|
void |
setSelectedTextColor(Color newColor)
|
void |
setSelectionColor(Color newColor)
|
void |
setSelectionEnd(int end)
Selects the text from the selection start postion to the given position. |
void |
setSelectionStart(int start)
Selects the text from the given postion to the selection end position. |
void |
setText(String text)
|
void |
setUI(TextUI newUI)
This method sets the label's UI delegate. |
void |
updateUI()
This method resets the label's UI delegate to the default UI for the current look and feel. |
int |
viewToModel(Point pt)
|
void |
write(Writer output)
Write the content of this component to the given stream. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final String DEFAULT_KEYMAP
public static final String FOCUS_ACCELERATOR_KEY
Constructor Detail |
---|
public JTextComponent()
JTextComponent
instance.
Method Detail |
---|
public static Keymap getKeymap(String n)
n
- The name of the Keymap to look up
null
if no such Keymap existsaddKeymap(java.lang.String, javax.swing.text.Keymap)
,
removeKeymap(java.lang.String)
,
keymaps
public static Keymap removeKeymap(String n)
n
- The name of the Keymap to remove
addKeymap(java.lang.String, javax.swing.text.Keymap)
,
getKeymap()
,
keymaps
public static Keymap addKeymap(String n, Keymap parent)
null
,
in which case the new Keymap will not be added to the global
Keymap table. The parent may also be null
, which is
harmless.
n
- The name of the new Keymap, or null
parent
- The parent of the new Keymap, or null
removeKeymap(java.lang.String)
,
getKeymap()
,
keymaps
public Keymap getKeymap()
setKeymap(javax.swing.text.Keymap)
,
keymap
public void setKeymap(Keymap k)
KeymapWrapper
and KeymapActionMap
objects in the
InputMap
and ActionMap
parent chains, respectively,
and fire a property change event with name "keymap"
.
getKeymap()
,
keymap
public static void loadKeymap(Keymap map, JTextComponent.KeyBinding[] bindings, Action[] actions)
Keymap
. Specifically, for each provided binding
b
, if there exists a provided action a
such
that a.getValue(Action.NAME) == b.ActionName
then an
entry is added to the Keymap mapping b
to
a
.
map
- The Keymap to add new mappings tobindings
- The set of bindings to add to the Keymapactions
- The set of actions to resolve binding names againstAction.NAME
,
Action.getValue(java.lang.String)
,
JTextComponent.KeyBinding.actionName
public Action[] getActions()
getUI().getEditorKit().getActions()
. This set of Actions
is a reasonable value to provide as a parameter to loadKeymap(javax.swing.text.Keymap, javax.swing.text.JTextComponent.KeyBinding[], javax.swing.Action[])
, when resolving a set of JTextComponent.KeyBinding
objects
against this component.
EditorKit
TextUI.getEditorKit(javax.swing.text.JTextComponent)
,
EditorKit.getActions()
public void setDocument(Document newDoc)
public Document getDocument()
public AccessibleContext getAccessibleContext()
AccessibleContext
of this object.
getAccessibleContext
in interface Accessible
getAccessibleContext
in class JComponent
AccessibleContext
objectpublic void setMargin(Insets m)
public Insets getMargin()
public void setText(String text)
public String getText()
NullPointerException
- if the underlaying document is nullpublic String getText(int offset, int length) throws BadLocationException
offset
- the postion of the first characterlength
- the length of the text to retrieve
BadLocationException
- if arguments do not hold pre-conditionspublic String getSelectedText()
NullPointerException
- if the underlaying document is nullpublic String getUIClassID()
getUIClassID
in class JComponent
JComponent.setUI(javax.swing.plaf.ComponentUI)
,
JComponent.updateUI()
protected String paramString()
paramString
in class JComponent
public TextUI getUI()
public void setUI(TextUI newUI)
newUI
- The label's UI delegate.public void updateUI()
updateUI
in class JComponent
public Dimension getPreferredScrollableViewportSize()
getPreferredScrollableViewportSize
in interface Scrollable
public int getScrollableUnitIncrement(Rectangle visible, int orientation, int direction)
Scrollable
getScrollableUnitIncrement
in interface Scrollable
visible
- the currently visible part of the component.orientation
- the scrolling orientationdirection
- the scrolling direction (negative - up, positive -down).
The values greater than one means that more mouse wheel or similar
events were generated, and hence it is better to scroll the longer
distance.
public int getScrollableBlockIncrement(Rectangle visible, int orientation, int direction)
Scrollable
getScrollableBlockIncrement
in interface Scrollable
visible
- the currently visible part of the component.orientation
- the scrolling orientationdirection
- the scrolling direction (negative - up, positive -down).
The values greater than one means that more mouse wheel or similar
events were generated, and hence it is better to scroll the longer
distance.
public boolean isEditable()
public void setEditable(boolean newValue)
newValue
- true to make it editable, false otherwise.public Caret getCaret()
Caret
object used in this text component.
public void setCaret(Caret newCaret)
Caret
for this text component.
newCaret
- the new Caret
to setpublic Color getCaretColor()
public void setCaretColor(Color newColor)
public Color getDisabledTextColor()
public void setDisabledTextColor(Color newColor)
public Color getSelectedTextColor()
public void setSelectedTextColor(Color newColor)
public Color getSelectionColor()
public void setSelectionColor(Color newColor)
public int getCaretPosition()
public void setCaretPosition(int position)
position
- the new positionpublic void moveCaretPosition(int position)
public Highlighter getHighlighter()
public void setHighlighter(Highlighter newHighlighter)
public int getSelectionStart()
public void setSelectionStart(int start)
start
- the start positon of the selected text.public int getSelectionEnd()
public void setSelectionEnd(int end)
end
- the end positon of the selected text.public void select(int start, int end)
start
- the start position of the selected textend
- the end position of the selected textpublic void selectAll()
public void replaceSelection(String content)
public boolean getScrollableTracksViewportHeight()
Scrollable
getScrollableTracksViewportHeight
in interface Scrollable
public boolean getScrollableTracksViewportWidth()
Scrollable
getScrollableTracksViewportWidth
in interface Scrollable
public void addCaretListener(CaretListener listener)
CaretListener
object to this text component.
listener
- the listener to addpublic void removeCaretListener(CaretListener listener)
CaretListener
object from this text component.
listener
- the listener to removepublic CaretListener[] getCaretListeners()
CaretListener
objects.
protected void fireCaretUpdate(CaretEvent event)
CaretListener
objects that the caret
was updated.
event
- the event to sendpublic void addInputMethodListener(InputMethodListener listener)
InputListener
object to this text component.
addInputMethodListener
in class Component
listener
- the listener to addInputMethodEvent
,
Component.removeInputMethodListener(InputMethodListener)
,
Component.getInputMethodListeners()
,
Component.getInputMethodRequests()
public void removeInputMethodListener(InputMethodListener listener)
InputListener
object from this text component.
removeInputMethodListener
in class Component
listener
- the listener to removeInputMethodEvent
,
Component.addInputMethodListener(InputMethodListener)
,
Component.getInputMethodRequests()
public InputMethodListener[] getInputMethodListeners()
InputMethodListener
objects.
getInputMethodListeners
in class Component
Component.addInputMethodListener(InputMethodListener)
,
Component.removeInputMethodListener(InputMethodListener)
public Rectangle modelToView(int position) throws BadLocationException
BadLocationException
public boolean getDragEnabled()
public void setDragEnabled(boolean enabled)
public int viewToModel(Point pt)
public void copy()
public void cut()
public void paste()
public void setFocusAccelerator(char newKey)
public char getFocusAccelerator()
public NavigationFilter getNavigationFilter()
public void setNavigationFilter(NavigationFilter filter)
public void read(Reader input, Object streamDescription) throws IOException
Document.StreamDescriptionProperty
.
input
- an input stream to read from.streamDescription
- an object, describing the stream.
IOException
- if the reader throws it.getDocument()
,
Document.getProperty(Object)
public void write(Writer output) throws IOException
output
- the writer to write into.
IOException
- if the writer throws it.public String getToolTipText(MouseEvent ev)
TextUI.getToolTipText(JTextComponent, Point)
.
getToolTipText
in class JComponent
ev
- the mouse event
JComponent.setToolTipText(java.lang.String)
,
JComponent.getToolTipText()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |