javax.swing
Class JTextField

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--javax.swing.text.JTextComponent
                          |
                          +--javax.swing.JTextField
All Implemented Interfaces:
Accessible, java.awt.image.ImageObserver, MenuContainer, Scrollable, Serializable, SwingConstants
Direct Known Subclasses:
JFormattedTextField, JPasswordField

public class JTextField
extends JTextComponent
implements SwingConstants

Safe:

See Also:
Serialized Form

Field Summary
private  Action action
           
private  java.beans.PropertyChangeListener actionPropertyChangeListener
           
private  int columns
           
private  int columnWidth
           
private  String command
           
private static Action[] defaultActions
           
private  int horizontalAlignment
           
static String notifyAction
          Suppressed: Name of the action to send notification that the contents of the field have been accepted.
private static String uiClassID
           
private  BoundedRangeModel visibility
           
 
Fields inherited from class javax.swing.text.JTextComponent
DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY
 
Fields inherited from class javax.swing.JComponent
_bounds, accessibleContext, listenerList, paintingChild, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
 
Fields inherited from class java.awt.Container
 
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
Fields inherited from interface javax.swing.SwingConstants
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
 
Constructor Summary
JTextField()
          Enabled: Constructs a new TextField.
JTextField(Document doc, String text, int columns)
          Enabled: Constructs a new JTextField that uses the given text storage model and the given number of columns.
JTextField(int columns)
          Enabled: Constructs a new empty TextField with the specified number of columns.
JTextField(String text)
          Enabled: Constructs a new TextField initialized with the specified text.
JTextField(String text, int columns)
          Enabled: Constructs a new TextField initialized with the specified text and columns.
 
Method Summary
 void addActionListener(ActionListener l)
          Enabled: Adds the specified action listener to receive action events from this textfield.
protected  void configurePropertiesFromAction(Action a)
          Factory method which sets the ActionEvent source's properties according to values from the Action instance.
protected  java.beans.PropertyChangeListener createActionPropertyChangeListener(Action a)
          Factory method which creates the PropertyChangeListener used to update the ActionEvent source as properties change on its Action instance.
protected  Document createDefaultModel()
          Creates the default implementation of the model to be used at construction if one isn't explicitly given.
protected  void fireActionPerformed()
          Notifies all listeners that have registered interest for notification on this event type.
 AccessibleContext getAccessibleContext()
          Suppressed: Gets the AccessibleContext associated with this JTextField.
 Action getAction()
          Suppressed: Returns the currently set Action for this ActionEvent source, or null if no Action is set.
 ActionListener[] getActionListeners()
          Suppressed: Returns an array of all the ActionListeners added to this JTextField with addActionListener().
 Action[] getActions()
          Suppressed: Fetches the command list for the editor.
 int getColumns()
          Enabled: Returns the number of columns in this TextField.
protected  int getColumnWidth()
          Returns the column width.
 int getHorizontalAlignment()
          Enabled: Returns the horizontal alignment of the text.
 BoundedRangeModel getHorizontalVisibility()
          Enabled: Gets the visibility of the text field.
 Dimension getPreferredSize()
          Enabled: Returns the preferred size Dimensions needed for this TextField.
 int getScrollOffset()
          Enabled: Gets the scroll offset, in pixels.
 String getUIClassID()
          Enabled: Gets the class ID for a UI.
(package private)  boolean hasActionListener()
          Returns true if the receiver has an ActionListener installed.
private  boolean isListener(Class c, ActionListener a)
           
 boolean isValidateRoot()
          Enabled: Calls to revalidate that come from within the textfield itself will be handled by validating the textfield, unless the textfield is contained within a JViewport, in which case this returns false.
protected  String paramString()
          Returns a string representation of this JTextField.
 void postActionEvent()
          Suppressed: Processes action events occurring on this textfield by dispatching them to any registered ActionListener objects.
 void removeActionListener(ActionListener l)
          Enabled: Removes the specified action listener so that it no longer receives action events from this textfield.
 void scrollRectToVisible(Rectangle r)
          Enabled: Scrolls the field left or right.
 void setAction(Action a)
          Enabled: Sets the Action for the ActionEvent source.
 void setActionCommand(String command)
          Enabled: Sets the command string used for action events.
 void setColumns(int columns)
          Enabled: Sets the number of columns in this TextField, and then invalidate the layout.
 void setDocument(Document doc)
          Enabled: Associates the editor with a text document.
 void setFont(Font f)
          Enabled: Sets the current font.
 void setHorizontalAlignment(int alignment)
          Enabled: Sets the horizontal alignment of the text.
 void setScrollOffset(int scrollOffset)
          Enabled: Sets the scroll offset, in pixels.
private  void writeObject(ObjectOutputStream s)
          See readObject and writeObject in JComponent for more information about serialization in Swing.
 
Methods inherited from class javax.swing.text.JTextComponent
addCaretListener, addInputMethodListener, addKeymap, addKeymap, copy, cut, fireCaretUpdate, getCaret, getCaretColor, getCaretListeners, getCaretPosition, getDisabledTextColor, getDocument, getDragEnabled, getFocusAccelerator, getHighlighter, getInputMethodRequests, getKeymap, getKeymap, getMargin, getNavigationFilter, getPreferredScrollableViewportSize, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getSelectedText, getSelectedTextColor, getSelectionColor, getSelectionEnd, getSelectionStart, getText, getText, getToolTipText, getUI, isEditable, loadKeymap, modelToView, moveCaretPosition, paste, processInputMethodEvent, read, removeCaretListener, removeKeymap, removeNotify, replaceSelection, select, selectAll, setCaret, setCaretColor, setCaretPosition, setComponentOrientation, setDisabledTextColor, setDragEnabled, setEditable, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setText, setUI, updateUI, viewToModel, write
 
Methods inherited from class javax.swing.JComponent
_paintImmediately, addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, alwaysOnTop, checkIfChildObscuredBySibling, componentInputMapChanged, computeVisibleRect, computeVisibleRect, compWriteObjectNotify, contains, createToolTip, disable, enable, enableSerialization, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getCreatedDoubleBuffer, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getManagingFocusBackwardTraversalKeys, getManagingFocusForwardTraversalKeys, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getWriteObjCounter, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyBindings, processKeyBindingsForAllComponents, processKeyEvent, processMouseMotionEvent, putClientProperty, rectangleIsObscured, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setCreatedDoubleBuffer, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPaintingChild, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, setWriteObjCounter, shouldDebugGraphics, superProcessMouseMotionEvent, unregisterKeyboardAction, update
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, get, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, iterate, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setLayout, size, transferFocusBackward, transferFocusDownCycle, validate, validateTree
 
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, toString, transferFocus, transferFocus, transferFocusUpCycle
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

action

private Action action

actionPropertyChangeListener

private java.beans.PropertyChangeListener actionPropertyChangeListener

notifyAction

public static final String notifyAction
Suppressed: Name of the action to send notification that the contents of the field have been accepted. Typically this is bound to a carriage-return.


visibility

private BoundedRangeModel visibility

horizontalAlignment

private int horizontalAlignment

columns

private int columns

columnWidth

private int columnWidth

command

private String command

defaultActions

private static final Action[] defaultActions

uiClassID

private static final String uiClassID
See Also:
getUIClassID(), JTextComponent.readObject(java.io.ObjectInputStream)
Constructor Detail

JTextField

public JTextField()
Enabled: Constructs a new TextField. A default model is created, the initial string is null, and the number of columns is set to 0.


JTextField

public JTextField(String text)
Enabled: Constructs a new TextField initialized with the specified text. A default model is created and the number of columns is 0.

Parameters:
text - the text to be displayed, or null

JTextField

public JTextField(int columns)
Enabled: Constructs a new empty TextField with the specified number of columns. A default model is created and the initial string is set to null.

Parameters:
columns - the number of columns to use to calculate the preferred width; if columns is set to zero, the preferred width will be whatever naturally results from the component implementation

JTextField

public JTextField(String text,
                  int columns)
Enabled: Constructs a new TextField initialized with the specified text and columns. A default model is created.

Parameters:
text - the text to be displayed, or null
columns - the number of columns to use to calculate the preferred width; if columns is set to zero, the preferred width will be whatever naturally results from the component implementation

JTextField

public JTextField(Document doc,
                  String text,
                  int columns)
Enabled: Constructs a new JTextField that uses the given text storage model and the given number of columns. This is the constructor through which the other constructors feed. If the document is null, a default model is created.

Parameters:
doc - the text storage to use; if this is null, a default will be provided by calling the createDefaultModel method
text - the initial string to display, or null
columns - the number of columns to use to calculate the preferred width >= 0; if columns is set to zero, the preferred width will be whatever naturally results from the component implementation
Method Detail

getUIClassID

public String getUIClassID()
Enabled: Gets the class ID for a UI.

Overrides:
getUIClassID in class JComponent
Returns:
the string "TextFieldUI"
See Also:
JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

setDocument

public void setDocument(Document doc)
Enabled: Associates the editor with a text document. The currently registered factory is used to build a view for the document, which gets displayed by the editor after revalidation. A PropertyChange event ("document") is propagated to each listener.

Overrides:
setDocument in class JTextComponent
Parameters:
doc - the document to display/edit
See Also:
JTextComponent.getDocument()

isValidateRoot

public boolean isValidateRoot()
Enabled: Calls to revalidate that come from within the textfield itself will be handled by validating the textfield, unless the textfield is contained within a JViewport, in which case this returns false.

Overrides:
isValidateRoot in class JComponent
Returns:
if the parent of this textfield is a JViewPort return false, otherwise return true
See Also:
JComponent.revalidate(), JComponent.isValidateRoot()

getHorizontalAlignment

public int getHorizontalAlignment()
Enabled: Returns the horizontal alignment of the text. Valid keys are:

Returns:
the horizontal alignment

setHorizontalAlignment

public void setHorizontalAlignment(int alignment)
Enabled: Sets the horizontal alignment of the text. Valid keys are: invalidate and repaint are called when the alignment is set, and a PropertyChange event ("horizontalAlignment") is fired.

Parameters:
alignment - the alignment

createDefaultModel

protected Document createDefaultModel()
Creates the default implementation of the model to be used at construction if one isn't explicitly given. An instance of PlainDocument is returned.

Returns:
the default model implementation

getColumns

public int getColumns()
Enabled: Returns the number of columns in this TextField.

Returns:
the number of columns >= 0

setColumns

public void setColumns(int columns)
Enabled: Sets the number of columns in this TextField, and then invalidate the layout.

Parameters:
columns - the number of columns >= 0

getColumnWidth

protected int getColumnWidth()
Returns the column width. The meaning of what a column is can be considered a fairly weak notion for some fonts. This method is used to define the width of a column. By default this is defined to be the width of the character m for the font used. This method can be redefined to be some alternative amount

Returns:
the column width >= 1

getPreferredSize

public Dimension getPreferredSize()
Enabled: Returns the preferred size Dimensions needed for this TextField. If a non-zero number of columns has been set, the width is set to the columns multiplied by the column width.

Overrides:
getPreferredSize in class JComponent
Returns:
the dimension of this textfield
See Also:
JComponent.setPreferredSize(java.awt.Dimension), ComponentUI

setFont

public void setFont(Font f)
Enabled: Sets the current font. This removes cached row height and column width so the new font will be reflected. revalidate is called after setting the font.

Overrides:
setFont in class JComponent
Parameters:
f - the new font
See Also:
java.awt.Component#getFont

addActionListener

public void addActionListener(ActionListener l)
Enabled: Adds the specified action listener to receive action events from this textfield.

Parameters:
l - the action listener to be added

removeActionListener

public void removeActionListener(ActionListener l)
Enabled: Removes the specified action listener so that it no longer receives action events from this textfield.

Parameters:
l - the action listener to be removed

getActionListeners

public ActionListener[] getActionListeners()
Suppressed: Returns an array of all the ActionListeners added to this JTextField with addActionListener().

Returns:
all of the ActionListeners added or an empty array if no listeners have been added
Since:
1.4

fireActionPerformed

protected void fireActionPerformed()
Notifies all listeners that have registered interest for notification on this event type. The event instance is lazily created. The listener list is processed in last to first order.

See Also:
EventListenerList

setActionCommand

public void setActionCommand(String command)
Enabled: Sets the command string used for action events.

Parameters:
command - the command string

setAction

public void setAction(Action a)
Enabled: Sets the Action for the ActionEvent source. The new Action replaces any previously set Action but does not affect ActionListeners independently added with addActionListener. If the Action is already a registered ActionListener for the ActionEvent source, it is not re-registered. A side-effect of setting the Action is that the ActionEvent source's properties are immediately set from the values in the Action (performed by the method configurePropertiesFromAction) and subsequently updated as the Action's properties change (via a PropertyChangeListener created by the method createActionPropertyChangeListener.

Parameters:
a - the Action for the JTextField, or null
Since:
1.3
See Also:
NotifyAction, getAction(), configurePropertiesFromAction(javax.swing.Action), createActionPropertyChangeListener(javax.swing.Action)

isListener

private boolean isListener(Class c,
                           ActionListener a)

getAction

public Action getAction()
Suppressed: Returns the currently set Action for this ActionEvent source, or null if no Action is set.

Returns:
the Action for this ActionEvent source, or null
Since:
1.3
See Also:
NotifyAction, setAction(javax.swing.Action)

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action a)
Factory method which sets the ActionEvent source's properties according to values from the Action instance. The properties which are set may differ for subclasses. By default, the properties which get set are Enabled and ToolTipText.

Parameters:
a - the Action from which to get the properties, or null
Since:
1.3
See Also:
NotifyAction, setAction(javax.swing.Action)

createActionPropertyChangeListener

protected java.beans.PropertyChangeListener createActionPropertyChangeListener(Action a)
Factory method which creates the PropertyChangeListener used to update the ActionEvent source as properties change on its Action instance. Subclasses may override this in order to provide their own PropertyChangeListener if the set of properties which should be kept up to date differs from the default properties (Text, Enabled, ToolTipText).

Note that PropertyChangeListeners should avoid holding strong references to the ActionEvent source, as this may hinder garbage collection of the ActionEvent source and all components in its containment hierarchy.

Parameters:
a - the Action from which to get the properties, or null
Since:
1.3
See Also:
NotifyAction, setAction(javax.swing.Action)

getActions

public Action[] getActions()
Suppressed: Fetches the command list for the editor. This is the list of commands supported by the plugged-in UI augmented by the collection of commands that the editor itself supports. These are useful for binding to events, such as in a keymap.

Overrides:
getActions in class JTextComponent
Returns:
the command list

postActionEvent

public void postActionEvent()
Suppressed: Processes action events occurring on this textfield by dispatching them to any registered ActionListener objects. This is normally called by the controller registered with textfield.


getHorizontalVisibility

public BoundedRangeModel getHorizontalVisibility()
Enabled: Gets the visibility of the text field. This can be adjusted to change the location of the visible area if the size of the field is greater than the area that was allocated to the field.

The fields look-and-feel implementation manages the values of the minimum, maximum, and extent properties on the BoundedRangeModel.

Returns:
the visibility
See Also:
BoundedRangeModel

getScrollOffset

public int getScrollOffset()
Enabled: Gets the scroll offset, in pixels.

Returns:
the offset >= 0

setScrollOffset

public void setScrollOffset(int scrollOffset)
Enabled: Sets the scroll offset, in pixels.

Parameters:
scrollOffset - the offset >= 0

scrollRectToVisible

public void scrollRectToVisible(Rectangle r)
Enabled: Scrolls the field left or right.

Overrides:
scrollRectToVisible in class JComponent
Parameters:
r - the region to scroll
See Also:
JViewport

hasActionListener

boolean hasActionListener()
Returns true if the receiver has an ActionListener installed.


writeObject

private void writeObject(ObjectOutputStream s)
                  throws IOException
See readObject and writeObject in JComponent for more information about serialization in Swing.

Parameters:
s - the ObjectOutputStream in which to write
IOException

paramString

protected String paramString()
Returns a string representation of this JTextField. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not be null.

Overrides:
paramString in class JTextComponent
Returns:
a string representation of this JTextField

getAccessibleContext

public AccessibleContext getAccessibleContext()
Suppressed: Gets the AccessibleContext associated with this JTextField. For JTextFields, the AccessibleContext takes the form of an AccessibleJTextField. A new AccessibleJTextField instance is created if necessary.

Specified by:
getAccessibleContext in interface Accessible
Overrides:
getAccessibleContext in class JTextComponent
Returns:
an AccessibleJTextField that serves as the AccessibleContext of this JTextField


comments?