TextField (Платформа Java SE 8 b92)

java.lang. Объект
- java.awt. Компонент
- - java.awt. TextComponent
  - - java.awt. TextField

Все Реализованные Интерфейсы:

ImageObserver, MenuContainer, Сериализуемый, Доступный
```
public class TextField
extends TextComponent
```
A TextField объект является текстовым компонентом, который учитывает редактирование одной строки текста.
Например, следующее изображение изображает фрейм с четырьмя текстовыми полями переменных ширин. Два из этих текстовых полей выводят на экран предопределенный текст "Hello".

Вот код, который производит эти четыре текстовых поля:
```
 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);
 
```
Каждый раз, когда пользователь вводит ключ в текстовом поле, одно или более ключевых событий отправляются текстовому полю. A KeyEvent может быть один из трех типов: keyPressed, keyReleased, или keyTyped. Свойства ключевого события указывают, какой из этих типов это, так же как дополнительная информация о событии, такой как, какие модификаторы применяются к ключевому событию и время, в которое событие имело место.
Ключевое событие передают к каждому KeyListener или KeyAdapter объект, который зарегистрировался, чтобы получить такие события, используя компонент addKeyListener метод. (KeyAdapter объекты реализуют KeyListener интерфейс.)
Также возможно стрелять ActionEvent. Если события действия включаются для текстового поля, они могут быть уволены, нажимая Return ключ.
TextField class processEvent метод исследует событие действия и передает его processActionEvent. Последний метод перенаправляет событие любому ActionListener объекты, которые зарегистрировались, чтобы получить события действия, сгенерированные этим текстовым полем.
С тех пор:

JDK1.0

См. Также:

KeyEvent, KeyAdapter, KeyListener, ActionEvent, Component.addKeyListener(java.awt.event.KeyListener), processEvent(java.awt.AWTEvent), processActionEvent(java.awt.event.ActionEvent), addActionListener(java.awt.event.ActionListener), Сериализированная Форма

Вложенная Сводка Класса

Вложенные Классы
Модификатор и Тип	Класс и Описание
`protected class`	`TextField. AccessibleAWTTextField` Этот class реализует поддержку доступности `TextField` class.

Вложенные классы/интерфейсы, наследованные от class java.awt. TextComponent
TextComponent. AccessibleAWTTextComponent

Вложенные классы/интерфейсы, наследованные от class java.awt. Компонент
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Полевая Сводка
- Поля, наследованные от class java.awt. TextComponent
  textListener
- Поля, наследованные от class java.awt. Компонент
  accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
- Поля, наследованные от интерфейса java.awt.image. ImageObserver
  ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Сводка конструктора

Конструкторы
Конструктор и Описание
`TextField()` Создает новое текстовое поле.
`TextField(int columns)` Создает новое пустое текстовое поле с конкретным количеством столбцов.
`TextField(String text)` Создает новое текстовое поле, инициализированное с указанным текстом.
`TextField(String text, int columns)` Создает новое текстовое поле, инициализированное с указанным текстом, который будет выведен на экран, и достаточно широкий, чтобы содержать конкретное количество столбцов.

Сводка метода

Все Методы Методы экземпляра Конкретные Методы Устаревшие Методы
Модификатор и Тип	Метод и Описание
`void`	`addActionListener(ActionListener l)` Добавляет указанный слушатель действия, чтобы получить события действия от этого текстового поля.
`void`	`addNotify()` Создает коллегу TextField.
`boolean`	`echoCharIsSet()` Указывает, есть ли у этого текстового поля набор символов для того, чтобы отозваться эхом.
`AccessibleContext`	`getAccessibleContext()` Связали AccessibleContext с этим TextField.
`ActionListener[]`	`getActionListeners()` Возвращает массив всех слушателей действия, зарегистрированных на этом текстовом поле.
`int`	`getColumns()` Получает число столбцов в этом текстовом поле.
`char`	`getEchoChar()` Получает символ, который должен использоваться для того, чтобы отозваться эхом.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)` Возвращает массив всех объектов, в настоящий момент зарегистрированных как `FooListener`s на это `TextField`.
`Размерность`	`getMinimumSize()` Получает minumum размерности для этого текстового поля.
`Размерность`	`getMinimumSize(int columns)` Получает minumum размерности для текстового поля с конкретным количеством столбцов.
`Размерность`	`getPreferredSize()` Получает привилегированный размер этого текстового поля.
`Размерность`	`getPreferredSize(int columns)` Получает привилегированный размер этого текстового поля с конкретным количеством столбцов.
`Размерность`	`minimumSize()` Осуждаемый. С версии 1.1 JDK, замененной `getMinimumSize()`.
`Размерность`	`minimumSize(int columns)` Осуждаемый. С версии 1.1 JDK, замененной `getMinimumSize(int)`.
`protected String`	`paramString()` Возвращает строку, представляющую состояние этого `TextField`.
`Размерность`	`preferredSize()` Осуждаемый. С версии 1.1 JDK, замененной `getPreferredSize()`.
`Размерность`	`preferredSize(int columns)` Осуждаемый. С версии 1.1 JDK, замененной `getPreferredSize(int)`.
`protected void`	`processActionEvent(ActionEvent e)` События действия процессов, происходящие на этом текстовом поле, диспетчеризируя их любому зарегистрированному `ActionListener` объекты.
`protected void`	`processEvent(AWTEvent e)` События процессов на этом текстовом поле.
`void`	`removeActionListener(ActionListener l)` Удаляет указанного слушателя действия так, чтобы это больше не получило события действия от этого текстового поля.
`void`	`setColumns(int columns)` Определяет номер столбцов в этом текстовом поле.
`void`	`setEchoChar(char c)` Устанавливает символ эха для этого текстового поля.
`void`	`setEchoCharacter(char c)` Осуждаемый. С версии 1.1 JDK, замененной `setEchoChar(char)`.
`void`	`setText(String t)` Устанавливает текст, который представляется этим текстовым компонентом, чтобы быть указанным текстом.

Методы, наследованные от class java.awt. TextComponent
addTextListener, enableInputMethods, getBackground, getCaretPosition, getInputMethodRequests, getSelectedText, getSelectionEnd, getSelectionStart, getText, getTextListeners, isEditable, processTextEvent, removeNotify, removeTextListener, select, selectAll, setBackground, setCaretPosition, setEditable, setSelectionEnd, setSelectionStart

Методы, наследованные от class java.awt. Компонент
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate

Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Деталь конструктора
  - TextField
```
public TextField()
          throws HeadlessException
```
    Создает новое текстовое поле.
    
    Броски:
    
    HeadlessException - если GraphicsEnvironment.isHeadless () возвращает true.
    
    См. Также:
    
    GraphicsEnvironment.isHeadless()
  - TextField
```
public TextField(String text)
          throws HeadlessException
```
    Создает новое текстовое поле, инициализированное с указанным текстом.
    
    Параметры:
    
    text - текст, который будет выведен на экран. Если text null, пустая строка "" будет выведен на экран.
    
    Броски:
    
    HeadlessException - если GraphicsEnvironment.isHeadless () возвращает true.
    
    См. Также:
    
    GraphicsEnvironment.isHeadless()
  - TextField
```
public TextField(int columns)
          throws HeadlessException
```
    Создает новое пустое текстовое поле с конкретным количеством столбцов. Столбцом является приблизительный средний символьный width, который зависим от платформы.
    
    Параметры:
    
    columns - число столбцов. Если columns меньше чем 0, columns устанавливается в 0.
    
    Броски:
    
    HeadlessException - если GraphicsEnvironment.isHeadless () возвращает true.
    
    См. Также:
    
    GraphicsEnvironment.isHeadless()
  - TextField
```
public TextField(String text,
                 int columns)
          throws HeadlessException
```
    Создает новое текстовое поле, инициализированное с указанным текстом, который будет выведен на экран, и достаточно широкий, чтобы содержать конкретное количество столбцов. Столбцом является приблизительный средний символьный width, который зависим от платформы.
    
    Параметры:
    
    text - текст, который будет выведен на экран. Если text null, пустая строка "" будет выведен на экран.
    
    columns - число столбцов. Если columns меньше чем 0, columns устанавливается в 0.
    
    Броски:
    
    HeadlessException - если GraphicsEnvironment.isHeadless () возвращает true.
    
    См. Также:
    
    GraphicsEnvironment.isHeadless()
- Деталь метода
  - addNotify
```
public void addNotify()
```
    Создает коллегу TextField. Коллега позволяет нам изменять появление TextField, не изменяя его функциональность.
    
    Переопределения:
    
    addNotify в class TextComponent
    
    См. Также:
    
    TextComponent.removeNotify()
  - getEchoChar
```
public char getEchoChar()
```
    Получает символ, который должен использоваться для того, чтобы отозваться эхом.
    Символ эха полезен для текстовых полей, где ввод данных пользователем не должен быть отражен на экран, как в случае текстового поля для того, чтобы ввести пароль. Если echoChar = 0, ввод данных пользователем отражается на неизменный экран.
    Реализация платформы Java может поддерживать только ограниченное, непустое множество символов эха. Эта функция возвращает символ эха, который первоначально требуют через setEchoChar (). Символ эха, фактически используемый реализацией TextField, мог бы отличаться.
    
    Возвраты:
    
    символ эха для этого текстового поля.
    
    См. Также:
    
    echoCharIsSet(), setEchoChar(char)
  - setEchoChar
```
public void setEchoChar(char c)
```
    Устанавливает символ эха для этого текстового поля.
    Символ эха полезен для текстовых полей, где ввод данных пользователем не должен быть отражен на экран, как в случае текстового поля для того, чтобы ввести пароль. Установка echoChar = 0 позволяет вводу данных пользователем быть отраженным на экран снова.
    Реализация платформы Java может поддерживать только ограниченное, непустое множество символов эха. Попытки установить неподдерживаемый символ эха заставят символ эха значения по умолчанию использоваться вместо этого. Последующие звонки getEchoChar () возвратят символ эха, который первоначально требуют. Эта энергия или не могла бы быть идентичной символу эха, фактически используемому реализацией TextField.
    
    Параметры:
    
    c - символ эха для этого текстового поля.
    
    С тех пор:
    
    JDK1.1
    
    См. Также:
    
    echoCharIsSet(), getEchoChar()
  - setEchoCharacter
```
@Deprecated
public void setEchoCharacter(char c)
```
    Осуждаемый. С версии 1.1 JDK, замененной setEchoChar(char).
  - setText
```
public void setText(String t)
```
    Устанавливает текст, который представляется этим текстовым компонентом, чтобы быть указанным текстом.
    
    Переопределения:
    
    setText в class TextComponent
    
    Параметры:
    
    t - новый текст.
    
    См. Также:
    
    TextComponent.getText()
  - echoCharIsSet
```
public boolean echoCharIsSet()
```
    Указывает, есть ли у этого текстового поля набор символов для того, чтобы отозваться эхом.
    Символ эха полезен для текстовых полей, где ввод данных пользователем не должен быть отражен на экран, как в случае текстового поля для того, чтобы ввести пароль.
    
    Возвраты:
    
    true если у этого текстового поля есть набор символов для того, чтобы отозваться эхом; false иначе.
    
    См. Также:
    
    setEchoChar(char), getEchoChar()
  - getColumns
```
public int getColumns()
```
    Получает число столбцов в этом текстовом поле. Столбцом является приблизительный средний символьный width, который зависим от платформы.
    
    Возвраты:
    
    число столбцов.
    
    С тех пор:
    
    JDK1.1
    
    См. Также:
    
    setColumns(int)
  - setColumns
```
public void setColumns(int columns)
```
    Определяет номер столбцов в этом текстовом поле. Столбцом является приблизительный средний символьный width, который зависим от платформы.
    
    Параметры:
    
    columns - число столбцов.
    
    Броски:
    
    IllegalArgumentException - если значение, предоставленное для columns меньше чем 0.
    
    С тех пор:
    
    JDK1.1
    
    См. Также:
    
    getColumns()
  - getPreferredSize
```
public Dimension getPreferredSize(int columns)
```
    Получает привилегированный размер этого текстового поля с конкретным количеством столбцов.
    
    Параметры:
    
    columns - число столбцов в этом текстовом поле.
    
    Возвраты:
    
    привилегированные размерности для того, чтобы вывести на экран это текстовое поле.
    
    С тех пор:
    
    JDK1.1
  - preferredSize
```
@Deprecated
public Dimension preferredSize(int columns)
```
    Осуждаемый. С версии 1.1 JDK, замененной getPreferredSize(int).
  - getPreferredSize
```
public Dimension getPreferredSize()
```
    Получает привилегированный размер этого текстового поля.
    
    Переопределения:
    
    getPreferredSize в class Component
    
    Возвраты:
    
    привилегированные размерности для того, чтобы вывести на экран это текстовое поле.
    
    С тех пор:
    
    JDK1.1
    
    См. Также:
    
    Component.getMinimumSize(), LayoutManager
  - preferredSize
```
@Deprecated
public Dimension preferredSize()
```
    Осуждаемый. С версии 1.1 JDK, замененной getPreferredSize().
    
    Переопределения:
    
    preferredSize в class Component
  - getMinimumSize
```
public Dimension getMinimumSize(int columns)
```
    Получает minumum размерности для текстового поля с конкретным количеством столбцов.
    
    Параметры:
    
    columns - число столбцов в этом текстовом поле.
    
    С тех пор:
    
    JDK1.1
  - minimumSize
```
@Deprecated
public Dimension minimumSize(int columns)
```
    Осуждаемый. С версии 1.1 JDK, замененной getMinimumSize(int).
  - getMinimumSize
```
public Dimension getMinimumSize()
```
    Получает minumum размерности для этого текстового поля.
    
    Переопределения:
    
    getMinimumSize в class Component
    
    Возвраты:
    
    минимальные размерности для того, чтобы вывести на экран это текстовое поле.
    
    С тех пор:
    
    JDK1.1
    
    См. Также:
    
    Component.getPreferredSize(), LayoutManager
  - minimumSize
```
@Deprecated
public Dimension minimumSize()
```
    Осуждаемый. С версии 1.1 JDK, замененной getMinimumSize().
    
    Переопределения:
    
    minimumSize в class Component
  - addActionListener
```
public void addActionListener(ActionListener l)
```
    Добавляет указанный слушатель действия, чтобы получить события действия от этого текстового поля. Если l является нулем, никакое исключение не выдается, и никакое действие не выполняется.
    Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.
    
    Параметры:
    
    l - слушатель действия.
    
    С тех пор:
    
    JDK1.1
    
    См. Также:
    
    removeActionListener(java.awt.event.ActionListener), getActionListeners(), ActionListener
  - removeActionListener
```
public void removeActionListener(ActionListener l)
```
    Удаляет указанного слушателя действия так, чтобы это больше не получило события действия от этого текстового поля. Если l является нулем, никакое исключение не выдается, и никакое действие не выполняется.
    Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.
    
    Параметры:
    
    l - слушатель действия.
    
    С тех пор:
    
    JDK1.1
    
    См. Также:
    
    addActionListener(java.awt.event.ActionListener), getActionListeners(), ActionListener
  - getActionListeners
```
public ActionListener[] getActionListeners()
```
    Возвращает массив всех слушателей действия, зарегистрированных на этом текстовом поле.
    
    Возвраты:
    
    все это текстовое поле ActionListeners или пустой массив, если никакие слушатели действия в настоящий момент не регистрируются
    
    С тех пор:
    
    1.4
    
    См. Также:
    
    addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener), java.awt.event
  - getListeners
```
public <T extends EventListener> T[] getListeners(Class<T> listenerType)
```
    Возвращает массив всех объектов, в настоящий момент зарегистрированных как FooListeners на это TextField. FooListeners регистрируются, используя addFooListener метод.
    Можно определить listenerType параметр с литералом class, такой как FooListener.class. Например, можно запросить a TextField t для его слушателей действия со следующим кодом:
```
ActionListener[] als = (ActionListener[])(t.getListeners(ActionListener.class));
```
    Если никакие такие слушатели не существуют, этот метод возвращает пустой массив.
    Переопределения:
    
    getListeners в class TextComponent
    
    Параметры:
    
    listenerType - тип слушателей требуют; этот параметр должен определить интерфейс, который убывает от java.util.EventListener
    
    Возвраты:
    
    массив всех объектов, зарегистрированных как FooListeners на этом текстовом поле, или пустом массиве, если никакие такие слушатели не были добавлены
    
    Броски:
    
    ClassCastException - если listenerType не определяет class или интерфейс, который реализует java.util.EventListener
    
    С тех пор:
    
    1.3
    
    См. Также:
    
    getActionListeners()
  - processEvent
```
protected void processEvent(AWTEvent e)
```
    События процессов на этом текстовом поле. Если событие является экземпляром ActionEvent, это вызывает processActionEvent метод. Иначе, это вызывает processEvent на суперклассе.
    Отметьте это, если параметр события null поведение является неуказанным и может привести к исключению.
    
    Переопределения:
    
    processEvent в class TextComponent
    
    Параметры:
    
    e - событие
    
    С тех пор:
    
    JDK1.1
    
    См. Также:
    
    ActionEvent, processActionEvent(java.awt.event.ActionEvent)
  - processActionEvent
```
protected void processActionEvent(ActionEvent e)
```
    События действия процессов, происходящие на этом текстовом поле, диспетчеризируя их любому зарегистрированному ActionListener объекты.
    Этот метод не вызывают, если события действия не включаются для этого компонента. События действия включаются, когда одно из следующего происходит:
    - ActionListener объект регистрируется через addActionListener.
    - Через события действия включают enableEvents.
    Отметьте это, если параметр события null поведение является неуказанным и может привести к исключению.
    Параметры:
    
    e - событие действия
    
    С тех пор:
    
    JDK1.1
    
    См. Также:
    
    ActionListener, addActionListener(java.awt.event.ActionListener), Component.enableEvents(long)
  - paramString
```
protected String paramString()
```
    Возвращает строку, представляющую состояние этого TextField. Этот метод предназначается, чтобы использоваться только для того, чтобы отладить цели, и контент и формат возвращенной строки могут измениться между реализациями. Возвращенная строка может быть пустой, но, возможно, не null.
    
    Переопределения:
    
    paramString в class TextComponent
    
    Возвраты:
    
    строка параметра этого текстового поля
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    Связали AccessibleContext с этим TextField. Для текстовых полей AccessibleContext принимает форму AccessibleAWTTextField. Новый экземпляр AccessibleAWTTextField создается в случае необходимости.
    
    Определенный:
    
    getAccessibleContext в интерфейсе Accessible
    
    Переопределения:
    
    getAccessibleContext в class TextComponent
    
    Возвраты:
    
    AccessibleAWTTextField, который служит AccessibleContext этого TextField
    
    С тех пор:
    
    1.3

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс TextField

Вложенная Сводка Класса

Вложенные классы/интерфейсы, наследованные от class java.awt. TextComponent

Вложенные классы/интерфейсы, наследованные от class java.awt. Компонент

Полевая Сводка

Поля, наследованные от class java.awt. TextComponent

Поля, наследованные от class java.awt. Компонент

Поля, наследованные от интерфейса java.awt.image. ImageObserver

Сводка конструктора

Сводка метода

Методы, наследованные от class java.awt. TextComponent

Методы, наследованные от class java.awt. Компонент

Методы, наследованные от class java.lang. Объект

Деталь конструктора

TextField

TextField

TextField

TextField

Деталь метода

addNotify

getEchoChar

setEchoChar

setEchoCharacter

setText

echoCharIsSet

getColumns

setColumns

getPreferredSize

preferredSize

getPreferredSize

preferredSize

getMinimumSize

minimumSize

getMinimumSize

minimumSize

addActionListener

removeActionListener

getActionListeners

getListeners

processEvent

processActionEvent

paramString

getAccessibleContext