Spec-Zone .ru
спецификации, руководства, описания, API
|
|
Spec-Zone .ru
спецификации, руководства, описания, API
|
public class TextField extends TextComponent
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 класс processEvent метод исследует событие действия и передает его processActionEvent. Последний метод перенаправляет событие любому ActionListener объекты, которые зарегистрировались, чтобы получить события действия, сгенерированные этим текстовым полем.
| Модификатор и Тип | Класс и Описание |
|---|---|
protected class |
TextField. AccessibleAWTTextField
Этот класс реализует поддержку доступности
TextField класс. |
TextComponent. AccessibleAWTTextComponentComponent.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategytextListenerBOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTABORT, 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> |
getListeners(Class<T> listenerType)
Возвращает массив всех объектов, в настоящий момент зарегистрированных как
FooListeners на это 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)
Устанавливает текст, который представляется этим текстовым компонентом, чтобы быть указанным текстом.
|
addTextListener, enableInputMethods, getBackground, getCaretPosition, getInputMethodRequests, getSelectedText, getSelectionEnd, getSelectionStart, getText, getTextListeners, isEditable, processTextEvent, removeNotify, removeTextListener, select, selectAll, setBackground, setCaretPosition, setEditable, setSelectionEnd, setSelectionStartaction, 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, validatepublic TextField()
throws HeadlessException
HeadlessException - если GraphicsEnvironment.isHeadless () возвращает true.GraphicsEnvironment.isHeadless()public TextField(String text) throws HeadlessException
text - текст, который будет выведен на экран. Если text null, пустая строка "" будет выведен на экран.HeadlessException - если GraphicsEnvironment.isHeadless () возвращает true.GraphicsEnvironment.isHeadless()public TextField(int columns)
throws HeadlessException
columns - число столбцов. Если columns меньше чем 0, columns устанавливается в 0.HeadlessException - если GraphicsEnvironment.isHeadless () возвращает true.GraphicsEnvironment.isHeadless()public TextField(String text, int columns) throws HeadlessException
text - текст, который будет выведен на экран. Если text null, пустая строка "" будет выведен на экран.columns - число столбцов. Если columns меньше чем 0, columns устанавливается в 0.HeadlessException - если GraphicsEnvironment.isHeadless () возвращает true.GraphicsEnvironment.isHeadless()public void addNotify()
addNotify в классе TextComponentTextComponent.removeNotify()public char getEchoChar()
Символ эха полезен для текстовых полей, где ввод данных пользователем не должен быть отражен на экран, как в случае текстового поля для того, чтобы ввести пароль. Если echoChar = 0, ввод данных пользователем отражается на неизменный экран.
Реализация платформы Java может поддерживать только ограниченное, непустое множество символов эха. Эта функция возвращает символ эха, который первоначально требуют через setEchoChar (). Символ эха, фактически используемый реализацией TextField, мог бы отличаться.
echoCharIsSet(), setEchoChar(char)public void setEchoChar(char c)
Символ эха полезен для текстовых полей, где ввод данных пользователем не должен быть отражен на экран, как в случае текстового поля для того, чтобы ввести пароль. Установка echoChar = 0 позволяет вводу данных пользователем быть отраженным на экран снова.
Реализация платформы Java может поддерживать только ограниченное, непустое множество символов эха. Попытки установить неподдерживаемый символ эха заставят символ эха по умолчанию использоваться вместо этого. Последующие звонки getEchoChar () возвратят символ эха, который первоначально требуют. Эта энергия или не могла бы быть идентичной символу эха, фактически используемому реализацией TextField.
c - символ эха для этого текстового поля.echoCharIsSet(), getEchoChar()@Deprecated public void setEchoCharacter(char c)
setEchoChar(char).public void setText(String t)
setText в классе TextComponentt - новый текст.TextComponent.getText()public boolean echoCharIsSet()
Символ эха полезен для текстовых полей, где ввод данных пользователем не должен быть отражен на экран, как в случае текстового поля для того, чтобы ввести пароль.
true если у этого текстового поля есть набор символов для того, чтобы отозваться эхом; false иначе.setEchoChar(char), getEchoChar()public int getColumns()
setColumns(int)public void setColumns(int columns)
columns - число столбцов.IllegalArgumentException - если значение, предоставленное для columns меньше чем 0.getColumns()public Dimension getPreferredSize(int columns)
columns - число столбцов в этом текстовом поле.@Deprecated public Dimension preferredSize(int columns)
getPreferredSize(int).public Dimension getPreferredSize()
getPreferredSize в классе ComponentComponent.getMinimumSize(), LayoutManager@Deprecated public Dimension preferredSize()
getPreferredSize().preferredSize в классе Componentpublic Dimension getMinimumSize(int columns)
columns - число столбцов в этом текстовом поле.@Deprecated public Dimension minimumSize(int columns)
getMinimumSize(int).public Dimension getMinimumSize()
getMinimumSize в классе ComponentComponent.getPreferredSize(), LayoutManager@Deprecated public Dimension minimumSize()
getMinimumSize().minimumSize в классе Componentpublic void addActionListener(ActionListener l)
Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.
l - слушатель действия.removeActionListener(java.awt.event.ActionListener), getActionListeners(), ActionListenerpublic void removeActionListener(ActionListener l)
Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.
l - слушатель действия.addActionListener(java.awt.event.ActionListener), getActionListeners(), ActionListenerpublic ActionListener[] getActionListeners()
ActionListeners или пустой массив, если никакие слушатели действия в настоящий момент не регистрируютсяaddActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener), java.awt.eventpublic <T extends EventListener> T[] getListeners(Class<T> listenerType)
FooListeners на это TextField. FooListeners регистрируются, используя addFooListener метод. Можно определить listenerType параметр с литералом класса, такой как FooListener.class. Например, можно запросить a TextField t для его слушателей действия со следующим кодом:
ActionListener[] als = (ActionListener[])(t.getListeners(ActionListener.class));Если никакие такие слушатели не существуют, этот метод возвращает пустой массив.
getListeners в классе TextComponentlistenerType - тип слушателей требуют; этот параметр должен определить интерфейс, который убывает от java.util.EventListenerFooListeners на этом текстовом поле, или пустом массиве, если никакие такие слушатели не были добавленыClassCastException - если listenerType не определяет класс или интерфейс, который реализует java.util.EventListenergetActionListeners()protected void processEvent(AWTEvent e)
ActionEvent, это вызывает processActionEvent метод. Иначе, это вызывает processEvent на суперклассе. Отметьте это, если параметр события null поведение является неуказанным и может привести к исключению.
processEvent в классе TextComponente - событиеActionEvent, processActionEvent(java.awt.event.ActionEvent)protected void processActionEvent(ActionEvent e)
ActionListener объекты. Этот метод не вызывают, если события действия не включаются для этого компонента. События действия включаются, когда одно из следующего происходит:
ActionListener объект регистрируется через addActionListener. enableEvents. Отметьте это, если параметр события null поведение является неуказанным и может привести к исключению.
e - событие действияActionListener, addActionListener(java.awt.event.ActionListener), Component.enableEvents(long)protected String paramString()
TextField. Этот метод предназначается, чтобы использоваться только для того, чтобы отладить цели, и контент и формат возвращенной строки могут измениться между реализациями. Возвращенная строка может быть пустой, но, возможно, не null.paramString в классе TextComponentpublic AccessibleContext getAccessibleContext()
getAccessibleContext в интерфейсе AccessiblegetAccessibleContext в классе TextComponent
Для дальнейшей ссылки API и документации разработчика, см. . Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.