| java.lang.Object java.awt.Component java.awt.TextComponent java.awt.TextField
TextField | public class TextField extends TextComponent (Code) | | A TextField object is a text component
that allows for the editing of a single line of text.
For example, the following image depicts a frame with four
text fields of varying widths. Two of these text fields
display the predefined text "Hello" .
Here is the code that produces these four text fields:
TextField tf1, tf2, tf3, tf4;
// a blank text field
tf1 = new TextField();
// blank field of 20 columns
tf2 = new TextField("", 20);
// predefined text displayed
tf3 = new TextField("Hello!");
// predefined text in 30 columns
tf4 = new TextField("Hello", 30);
Every time the user types a key in the text field, AWT
sends two action events to the text field. The first
one represents the key press and the second one,
the key release. Each action event embodies the state
of the system at the time that some action occurred.
The properties of an action event indicate which
key was pressed, what modifier keys were also pressed,
and the time at which the event occurred.
Since the event is an instance of ActionEvent ,
the TextField class's processEvent
method examines the event and passes it along to
processActionEvent . The latter method redirects the
event to any ActionListener objects that have
registered an interest in action events generated by this
text field.
version: 1.59, 08/19/02 author: Sami Shaio See Also: java.awt.event.ActionEvent See Also: java.awt.TextField.processEvent See Also: java.awt.TextField.processActionEvent since: JDK1.0 |
Constructor Summary | |
public | TextField() Constructs a new text field. | public | TextField(String text) Constructs a new text field initialized with the specified text. | public | TextField(int columns) Constructs a new empty TextField with the specified number of columns. | public | TextField(String text, int columns) Constructs a new text field initialized with the specified text
to be displayed, and wide enough to hold the specified
number of characters. |
columns | int columns(Code) | | The number of columns in the TextField.
|
echoChar | char echoChar(Code) | | The echo character.
|
TextField | public TextField()(Code) | | Constructs a new text field.
since: JDK1.0 |
TextField | public TextField(String text)(Code) | | Constructs a new text field initialized with the specified text.
Parameters: text - the text to be displayed. since: JDK1.0 |
TextField | public TextField(int columns)(Code) | | Constructs a new empty TextField with the specified number of columns.
Parameters: columns - the number of columns |
TextField | public TextField(String text, int columns)(Code) | | Constructs a new text field initialized with the specified text
to be displayed, and wide enough to hold the specified
number of characters.
Parameters: text - the text to be displayed. Parameters: columns - the number of characters. since: JDK1.0 |
addNotify | public void addNotify()(Code) | | Creates the TextField's peer. The peer allows us to modify the
appearance of the TextField without changing its functionality.
|
constructComponentName | String constructComponentName()(Code) | | Construct a name for this component. Called by getName() when the
name is null.
|
echoCharIsSet | public boolean echoCharIsSet()(Code) | | Indicates whether or not this text field has a
character set for echoing.
An echo character is useful for text fields where
user input should not be echoed to the screen, as in
the case of a text field for entering a password.
true if this text field hasa character set for echoing;false otherwise. See Also: java.awt.TextField.setEchoChar See Also: java.awt.TextField.getEchoChar since: JDK1.0 |
getActionListeners | public synchronized ActionListener[] getActionListeners()(Code) | | Returns an array of all the action listeners
registered on this textfield.
all of this textfield's ActionListener sor an empty array if no actionlisteners are currently registered See Also: TextField.addActionListener See Also: TextField.removeActionListener See Also: java.awt.event.ActionListener since: 1.4 |
getEchoChar | public char getEchoChar()(Code) | | Gets the character that is to be used for echoing.
An echo character is useful for text fields where
user input should not be echoed to the screen, as in
the case of a text field for entering a password.
the echo character for this text field. See Also: java.awt.TextField.echoCharIsSet See Also: java.awt.TextField.setEchoChar since: JDK1.0 |
getMinimumSize | public Dimension getMinimumSize(int columns)(Code) | | Gets the minumum dimensions for a text field with
the specified number of columns.
Parameters: columns - the number of columns inthis text field. since: JDK1.1 |
getMinimumSize | public Dimension getMinimumSize()(Code) | | Gets the minumum dimensions for this text field.
the minimum dimensions fordisplaying this text field. since: JDK1.1 |
getPreferredSize | public Dimension getPreferredSize(int columns)(Code) | | Gets the preferred size of this text field
with the specified number of columns.
Parameters: columns - the number of columnsin this text field. the preferred dimensions fordisplaying this text field. since: JDK1.1 |
getPreferredSize | public Dimension getPreferredSize()(Code) | | Gets the preferred size of this text field.
the preferred dimensions fordisplaying this text field. since: JDK1.1 |
paramString | protected String paramString()(Code) | | Returns the parameter string representing the state of this
text field. This string is useful for debugging.
the parameter string of this text field. since: JDK1.0 |
processActionEvent | protected void processActionEvent(ActionEvent e)(Code) | | Processes action events occurring on this text field by
dispatching them to any registered
ActionListener objects.
This method is not called unless action events are
enabled for this component. Action events are enabled
when one of the following occurs:
- An
ActionListener object is registered
via addActionListener .
- Action events are enabled via
enableEvents .
Parameters: e - the action event. See Also: java.awt.event.ActionListener See Also: java.awt.TextField.addActionListener See Also: java.awt.Component.enableEvents since: JDK1.1 |
setColumns | public synchronized void setColumns(int columns)(Code) | | Sets the number of columns in this text field.
Parameters: columns - the number of columns. See Also: java.awt.TextField.getColumns exception: IllegalArgumentException - if the valuesupplied for columns is less than zero. since: JDK1.1 |
setEchoChar | public void setEchoChar(char c)(Code) | | Sets the echo character for this text field.
An echo character is useful for text fields where
user input should not be echoed to the screen, as in
the case of a text field for entering a password.
Parameters: c - the echo character for this text field. See Also: java.awt.TextField.echoCharIsSet See Also: java.awt.TextField.getEchoChar since: JDK1.1 |
setEchoCharacter | public synchronized void setEchoCharacter(char c)(Code) | | |
Methods inherited from java.awt.Component | public boolean action(Event evt, Object what)(Code)(Java Doc) public synchronized void add(PopupMenu popup)(Code)(Java Doc) public synchronized void addComponentListener(ComponentListener l)(Code)(Java Doc) public synchronized void addFocusListener(FocusListener l)(Code)(Java Doc) public synchronized void addKeyListener(KeyListener l)(Code)(Java Doc) public synchronized void addMouseListener(MouseListener l)(Code)(Java Doc) public synchronized void addMouseMotionListener(MouseMotionListener l)(Code)(Java Doc) public void addNotify()(Code)(Java Doc) boolean areInputMethodsEnabled()(Code)(Java Doc) public Rectangle bounds()(Code)(Java Doc) final void checkEnableNewEventsOnly(Object listener)(Code)(Java Doc) public int checkImage(Image image, ImageObserver observer)(Code)(Java Doc) public int checkImage(Image image, int width, int height, ImageObserver observer)(Code)(Java Doc) protected AWTEvent coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)(Code)(Java Doc) String constructComponentName()(Code)(Java Doc) public boolean contains(int x, int y)(Code)(Java Doc) public boolean contains(Point p)(Code)(Java Doc) public Image createImage(ImageProducer producer)(Code)(Java Doc) public Image createImage(int width, int height)(Code)(Java Doc) ComponentXWindow createXWindow()(Code)(Java Doc) public void deliverEvent(Event e)(Code)(Java Doc) public void disable()(Code)(Java Doc) final protected void disableEvents(long eventsToDisable)(Code)(Java Doc) final public void dispatchEvent(AWTEvent e)(Code)(Java Doc) void dispatchEventImpl(AWTEvent e)(Code)(Java Doc) public void doLayout()(Code)(Java Doc) public void enable()(Code)(Java Doc) public void enable(boolean b)(Code)(Java Doc) final protected synchronized void enableEvents(long eventsToEnable)(Code)(Java Doc) boolean eventEnabled(AWTEvent e)(Code)(Java Doc) Component findFocusDelegate(Container container)(Code)(Java Doc) public float getAlignmentX()(Code)(Java Doc) public float getAlignmentY()(Code)(Java Doc) public Color getBackground()(Code)(Java Doc) public Rectangle getBounds()(Code)(Java Doc) public ColorModel getColorModel()(Code)(Java Doc) public Component getComponentAt(int x, int y)(Code)(Java Doc) public Component getComponentAt(Point p)(Code)(Java Doc) public Cursor getCursor()(Code)(Java Doc) Component getFocusDelegate()(Code)(Java Doc) public Font getFont()(Code)(Java Doc) Component getFontAndColorDelegate()(Code)(Java Doc) public FontMetrics getFontMetrics(Font font)(Code)(Java Doc) public Color getForeground()(Code)(Java Doc) public Graphics getGraphics()(Code)(Java Doc) InputContext getInputContext()(Code)(Java Doc) public Locale getLocale()(Code)(Java Doc) public Point getLocation()(Code)(Java Doc) public Point getLocationOnScreen()(Code)(Java Doc) public Dimension getMaximumSize()(Code)(Java Doc) public Dimension getMinimumSize()(Code)(Java Doc) public String getName()(Code)(Java Doc) Container getNativeContainer()(Code)(Java Doc) public Container getParent()(Code)(Java Doc) public Dimension getPreferredSize()(Code)(Java Doc) public Dimension getSize()(Code)(Java Doc) public Toolkit getToolkit()(Code)(Java Doc) final public Object getTreeLock()(Code)(Java Doc) public boolean gotFocus(Event evt, Object what)(Code)(Java Doc) public boolean handleEvent(Event evt)(Code)(Java Doc) public void hide()(Code)(Java Doc) public boolean imageUpdate(Image img, int flags, int x, int y, int w, int h)(Code)(Java Doc) public boolean inside(int x, int y)(Code)(Java Doc) public void invalidate()(Code)(Java Doc) static void invokeAndWait(Runnable runnable)(Code)(Java Doc) public boolean isDisplayable()(Code)(Java Doc) public boolean isEnabled()(Code)(Java Doc) public boolean isFocusTraversable()(Code)(Java Doc) public boolean isLightweight()(Code)(Java Doc) boolean isLightweightWhenDisplayable()(Code)(Java Doc) public boolean isOpaque()(Code)(Java Doc) public boolean isShowing()(Code)(Java Doc) public boolean isValid()(Code)(Java Doc) public boolean isVisible()(Code)(Java Doc) public boolean keyDown(Event evt, int key)(Code)(Java Doc) public boolean keyUp(Event evt, int key)(Code)(Java Doc) public void layout()(Code)(Java Doc) void lightweightPrint(Graphics g)(Code)(Java Doc) public void list()(Code)(Java Doc) public void list(PrintStream out)(Code)(Java Doc) public void list(PrintStream out, int indent)(Code)(Java Doc) public void list(PrintWriter out)(Code)(Java Doc) public void list(PrintWriter out, int indent)(Code)(Java Doc) public Component locate(int x, int y)(Code)(Java Doc) public Point location()(Code)(Java Doc) public boolean lostFocus(Event evt, Object what)(Code)(Java Doc) public Dimension minimumSize()(Code)(Java Doc) public boolean mouseDown(Event evt, int x, int y)(Code)(Java Doc) public boolean mouseDrag(Event evt, int x, int y)(Code)(Java Doc) public boolean mouseEnter(Event evt, int x, int y)(Code)(Java Doc) public boolean mouseExit(Event evt, int x, int y)(Code)(Java Doc) public boolean mouseMove(Event evt, int x, int y)(Code)(Java Doc) public boolean mouseUp(Event evt, int x, int y)(Code)(Java Doc) public void move(int x, int y)(Code)(Java Doc) public void nextFocus()(Code)(Java Doc) public void paint(Graphics g)(Code)(Java Doc) public void paintAll(Graphics g)(Code)(Java Doc) protected String paramString()(Code)(Java Doc) public boolean postEvent(Event e)(Code)(Java Doc) public Dimension preferredSize()(Code)(Java Doc) public boolean prepareImage(Image image, ImageObserver observer)(Code)(Java Doc) public boolean prepareImage(Image image, int width, int height, ImageObserver observer)(Code)(Java Doc) public void print(Graphics g)(Code)(Java Doc) public void printAll(Graphics g)(Code)(Java Doc) protected void processComponentEvent(ComponentEvent e)(Code)(Java Doc) protected void processEvent(AWTEvent e)(Code)(Java Doc) protected void processFocusEvent(FocusEvent e)(Code)(Java Doc) protected void processKeyEvent(KeyEvent e)(Code)(Java Doc) protected void processMouseEvent(MouseEvent e)(Code)(Java Doc) protected void processMouseMotionEvent(MouseEvent e)(Code)(Java Doc) public synchronized void remove(MenuComponent popup)(Code)(Java Doc) public synchronized void removeComponentListener(ComponentListener l)(Code)(Java Doc) public synchronized void removeFocusListener(FocusListener l)(Code)(Java Doc) public synchronized void removeKeyListener(KeyListener l)(Code)(Java Doc) public synchronized void removeMouseListener(MouseListener l)(Code)(Java Doc) public synchronized void removeMouseMotionListener(MouseMotionListener l)(Code)(Java Doc) public void removeNotify()(Code)(Java Doc) public void repaint()(Code)(Java Doc) public void repaint(long tm)(Code)(Java Doc) public void repaint(int x, int y, int width, int height)(Code)(Java Doc) public void repaint(long tm, int x, int y, int width, int height)(Code)(Java Doc) public void requestFocus()(Code)(Java Doc) public void reshape(int x, int y, int width, int height)(Code)(Java Doc) public void resize(int width, int height)(Code)(Java Doc) public void resize(Dimension d)(Code)(Java Doc) public void setBackground(Color c)(Code)(Java Doc) public void setBounds(int x, int y, int width, int height)(Code)(Java Doc) public void setBounds(Rectangle r)(Code)(Java Doc) public synchronized void setCursor(Cursor cursor)(Code)(Java Doc) public void setEnabled(boolean b)(Code)(Java Doc) public void setFont(Font f)(Code)(Java Doc) public void setForeground(Color c)(Code)(Java Doc) public void setLocale(Locale l)(Code)(Java Doc) public void setLocation(int x, int y)(Code)(Java Doc) public void setLocation(Point p)(Code)(Java Doc) public void setName(String name)(Code)(Java Doc) public void setSize(int width, int height)(Code)(Java Doc) public void setSize(Dimension d)(Code)(Java Doc) public void setVisible(boolean b)(Code)(Java Doc) public void show()(Code)(Java Doc) public void show(boolean b)(Code)(Java Doc) public Dimension size()(Code)(Java Doc) public String toString()(Code)(Java Doc) public void transferFocus()(Code)(Java Doc) public void update(Graphics g)(Code)(Java Doc) public void validate()(Code)(Java Doc)
|
|
|