TextComponent (Платформа Java SE 7)

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

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

ImageObserver, MenuContainer, Сериализуемый, Доступный

Прямые Известные Подклассы:

TextArea, TextField
```
public class TextComponent
extends Component
implements Accessible
```
TextComponent класс является суперклассом любого компонента, который позволяет редактирование некоторого текста.
Текстовый компонент воплощает строку текста. TextComponent класс определяет ряд методов, которые определяют, доступен ли этот текст для редактирования. Если компонент доступен для редактирования, он определяет другой набор методов, который поддерживает каре вставки текста.
Кроме того, класс определяет методы, которые используются, чтобы поддержать текущий выбор из текста. Текстовый выбор, подстрока текста компонента, является целью редактирования операций. Это также упоминается как выбранный текст.

С тех пор:

JDK1.0

См. Также:
Сериализированная Форма

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

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

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

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

Поля
Модификатор и Тип Поле и Описание

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

Поля
Модификатор и Тип	Поле и Описание
`protected TextListener`	`textListener`

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

Методы
Модификатор и Тип	Метод и Описание
`void`	`addNotify()` Делает этот Компонент визуализуемым, соединяя это с собственным экранным ресурсом.
`void`	`addTextListener(TextListener l)` Добавляет указанный текстовый слушатель события, чтобы получить текстовые события от этого текстового компонента.
`void`	`enableInputMethods(boolean enable)` Включения или входной метод отключений поддерживают для этого текстового компонента.
`AccessibleContext`	`getAccessibleContext()` Связали AccessibleContext с этим TextComponent.
`Цвет`	`getBackground()` Получает цвет фона этого текстового компонента.
`int`	`getCaretPosition()` Возвращает позицию каре вставки текста.
`InputMethodRequests`	`getInputMethodRequests()` Получает входной обработчик запроса метода, который поддерживает запросы от входных методов для этого компонента.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)` Возвращает массив всех объектов, в настоящий момент зарегистрированных как `FooListener`s на это `TextComponent`.
`Строка`	`getSelectedText()` Возвращает выбранный текст из текста, который представляется этим текстовым компонентом.
`int`	`getSelectionEnd()` Получает позицию конца выбранного текста в этом текстовом компоненте.
`int`	`getSelectionStart()` Получает позицию запуска выбранного текста в этом текстовом компоненте.
`Строка`	`getText()` Возвращает текст, который представляется этим текстовым компонентом.
`TextListener[]`	`getTextListeners()` Возвращает массив всех текстовых слушателей, зарегистрированных на этом текстовом компоненте.
`boolean`	`isEditable()` Указывает, доступен ли этот текстовый компонент для редактирования.
`protected String`	`paramString()` Возвращает строку, представляющую состояние этого `TextComponent`.
`protected void`	`processEvent(AWTEvent e)` События процессов на этом текстовом компоненте.
`protected void`	`processTextEvent(TextEvent e)` Текстовые события процессов, происходящие на этом текстовом компоненте, диспетчеризируя их любому зарегистрированному `TextListener` объекты.
`void`	`removeNotify()` Удаляет `TextComponent`'s коллега.
`void`	`removeTextListener(TextListener l)` Удаляет указанного текстового слушателя события так, чтобы это больше не получило текстовые события от этого текстового компонента Если `l` `null`, никакое исключение не выдается, и никакое действие не выполняется.
`void`	`select(int selectionStart, int selectionEnd)` Выбирает текст между указанным запуском и позициями конца.
`void`	`selectAll()` Выбирает весь текст в этом текстовом компоненте.
`void`	`setBackground(Color c)` Устанавливает цвет фона этого текстового компонента.
`void`	`setCaretPosition(int position)` Устанавливает позицию каре вставки текста.
`void`	`setEditable(boolean b)` Устанавливает флаг, который определяет, доступен ли этот текстовый компонент для редактирования.
`void`	`setSelectionEnd(int selectionEnd)` Устанавливает конец выбора для этого текстового компонента к указанной позиции.
`void`	`setSelectionStart(int selectionStart)` Наборы выбор запускаются для этого текстового компонента к указанной позиции.
`void`	`setText(String t)` Устанавливает текст, который представляется этим текстовым компонентом, чтобы быть указанным текстом.

Методы 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, getMinimumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPreferredSize, 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, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, preferredSize, 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

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

- Полевая Деталь
  - textListener
```
protected transient TextListener textListener
```
- Деталь метода
  - enableInputMethods
```
public void enableInputMethods(boolean enable)
```
    Включения или входной метод отключений поддерживают для этого текстового компонента. Если входная поддержка метода включается, и текстовый компонент также обрабатывает ключевые события, входящие события предлагаются текущему входному методу и будут только обработаны компонентом или диспетчеризированы его слушателям, если входной метод не использует их. Ли и как введенная поддержка метода этого текстового компонента включается или отключается, по умолчанию зависящее от реализации.
    
    Переопределения:
    
    enableInputMethods в классе Component
    
    Параметры:
    enable - истина, чтобы включить, ложь, чтобы отключить
    С тех пор:
    
    1.2
    
    См. Также:
    Component.processKeyEvent(java.awt.event.KeyEvent)
  - getInputMethodRequests
```
public InputMethodRequests getInputMethodRequests()
```
    Описание скопировало с класса: Component
    
    Получает входной обработчик запроса метода, который поддерживает запросы от входных методов для этого компонента. Компонент, который поддерживает текстовый ввод на месте, должен переопределить этот метод, чтобы возвратиться InputMethodRequests экземпляр. Одновременно, это также должно обработать входные события метода.
    
    Переопределения:
    
    getInputMethodRequests в классе Component
    
    Возвраты:
    входной метод запрашивает обработчик на этот компонент, null по умолчанию
    См. Также:
    Component.addInputMethodListener(java.awt.event.InputMethodListener)
  - addNotify
```
public void addNotify()
```
    Делает этот Компонент визуализуемым, соединяя это с собственным экранным ресурсом. Этот метод вызывает внутренне инструментарий и не должен быть вызван непосредственно программами.
    
    Переопределения:
    
    addNotify в классе Component
    
    См. Также:
    removeNotify()
  - removeNotify
```
public void removeNotify()
```
    Удаляет TextComponent's коллега. Коллега позволяет нам изменять появление TextComponent не изменяя его функциональность.
    
    Переопределения:
    
    removeNotify в классе Component
    
    См. Также:
    Component.isDisplayable(), Component.addNotify()
  - setText
```
public void setText(String t)
```
    Устанавливает текст, который представляется этим текстовым компонентом, чтобы быть указанным текстом.
    
    Параметры:
    t - новый текст; если этот параметр null тогда текст устанавливается в пустую строку""
    См. Также:
    getText()
  - getText
```
public String getText()
```
    Возвращает текст, который представляется этим текстовым компонентом. По умолчанию это - пустая строка.
    
    Возвраты:
    значение этого TextComponent
    См. Также:
    setText(java.lang.String)
  - getSelectedText
```
public String getSelectedText()
```
    Возвращает выбранный текст из текста, который представляется этим текстовым компонентом.
    
    Возвраты:
    выбранный текст этого текстового компонента
    См. Также:
    select(int, int)
  - isEditable
```
public boolean isEditable()
```
    Указывает, доступен ли этот текстовый компонент для редактирования.
    
    Возвраты:
    true если этот текстовый компонент доступен для редактирования; false иначе.
    С тех пор:
    
    JDK1.0
    
    См. Также:
    setEditable(boolean)
  - setEditable
```
public void setEditable(boolean b)
```
    Устанавливает флаг, который определяет, доступен ли этот текстовый компонент для редактирования.
    Если флаг устанавливается в true, этот текстовый компонент становится доступным для редактирования пользователем. Если флаг устанавливается в false, пользователь не может изменить текст этого текстового компонента. По умолчанию у недоступных для редактирования текстовых компонентов есть цвет фона SystemColor.control. Это значение по умолчанию может быть переопределено, вызывая setBackground.
    
    Параметры:
    b - флаг, указывающий, является ли этот текстовый компонент доступным для редактирования пользователем.
    С тех пор:
    
    JDK1.0
    
    См. Также:
    isEditable()
  - getBackground
```
public Color getBackground()
```
    Получает цвет фона этого текстового компонента. По умолчанию у недоступных для редактирования текстовых компонентов есть цвет фона SystemColor.control. Это значение по умолчанию может быть переопределено, вызывая setBackground.
    
    Переопределения:
    
    getBackground в классе Component
    
    Возвраты:
    Этот текстовый компонентный цвет фона. Если у этого текстового компонента нет цвета фона, цвет фона его родителя возвращается.
    С тех пор:
    
    JDK1.0
    
    См. Также:
    setBackground(Color)
  - setBackground
```
public void setBackground(Color c)
```
    Устанавливает цвет фона этого текстового компонента.
    
    Переопределения:
    
    setBackground в классе Component
    
    Параметры:
    c - Цвет, чтобы стать этим текстовым компонентным цветом. Если этот параметр будет нулем тогда, то этот текстовый компонент наследует цвет фона своего родителя.
    С тех пор:
    
    JDK1.0
    
    См. Также:
    getBackground()
  - getSelectionStart
```
public int getSelectionStart()
```
    Получает позицию запуска выбранного текста в этом текстовом компоненте.
    
    Возвраты:
    позиция запуска выбранного текста
    См. Также:
    setSelectionStart(int), getSelectionEnd()
  - setSelectionStart
```
public void setSelectionStart(int selectionStart)
```
    Наборы выбор запускаются для этого текстового компонента к указанной позиции. Новая стартовая точка ограничивается быть в или перед текущим концом выбора. Это также не может быть установлено в меньше чем нуль, начало текста компонента. Если вызывающая сторона предоставляет значение для selectionStart это за пределы, метод осуществляет эти ограничения тихо, и без отказа.
    
    Параметры:
    selectionStart - позиция запуска выбранного текста
    С тех пор:
    
    JDK1.1
    
    См. Также:
    getSelectionStart(), setSelectionEnd(int)
  - getSelectionEnd
```
public int getSelectionEnd()
```
    Получает позицию конца выбранного текста в этом текстовом компоненте.
    
    Возвраты:
    позиция конца выбранного текста
    См. Также:
    setSelectionEnd(int), getSelectionStart()
  - setSelectionEnd
```
public void setSelectionEnd(int selectionEnd)
```
    Устанавливает конец выбора для этого текстового компонента к указанной позиции. Новая конечная точка ограничивается быть в или после того, как текущий выбор запускается. Это также не может быть установлено вне конца текста компонента. Если вызывающая сторона предоставляет значение для selectionEnd это за пределы, метод осуществляет эти ограничения тихо, и без отказа.
    
    Параметры:
    selectionEnd - позиция конца выбранного текста
    С тех пор:
    
    JDK1.1
    
    См. Также:
    getSelectionEnd(), setSelectionStart(int)
  - выбрать
```
public void select(int selectionStart,
          int selectionEnd)
```
    Выбирает текст между указанным запуском и позициями конца.
    Этот метод устанавливает запуск и позиции конца выбранного текста, осуществляя ограничение, что позиция запуска должна быть больше чем или равной нулю. Позиция конца должна быть больше чем или равной позиции запуска, и меньше чем или равной длине текстового компонентного текста. Символьные позиции индексируются, запускаясь с нуля. Продолжительность выбора endPosition - startPosition, так символ в endPosition не выбирается. Если запуск и позиции конца выбранного текста равны, весь текст является невыбранным.
    Если вызывающая сторона предоставляет значения, которые непоследовательны или за пределы, метод осуществляет эти ограничения тихо, и без отказа. Определенно, если позиция запуска или позиция конца больше чем длина текста, это сбрасывается, чтобы равняться текстовой длине. Если позиция запуска является меньше чем нуль, она сбрасывается, чтобы обнулить, и если позиция конца является меньше чем позиция запуска, она сбрасывается к позиции запуска.
    
    Параметры:
    selectionStart - основанный на нуле индекс первого символа (char значение), чтобы быть выбранным
    selectionEnd - основанная на нуле позиция конца текста, который будет выбран; символ (char значение) в selectionEnd не выбирается
    См. Также:
    setSelectionStart(int), setSelectionEnd(int), selectAll()
  - selectAll
```
public void selectAll()
```
    Выбирает весь текст в этом текстовом компоненте.
    
    См. Также:
    select(int, int)
  - setCaretPosition
```
public void setCaretPosition(int position)
```
    Устанавливает позицию каре вставки текста. Позиция каре ограничивается быть между 0 и последний знак текста, включительно. Если переданный - в значении больше чем этот диапазон, значение устанавливается в последний знак (или 0, если TextComponent не содержит текста), и никакая ошибка не возвращается. Если переданный - в значении является меньше чем 0, IllegalArgumentException бросается.
    
    Параметры:
    position - позиция каре вставки текста
    
    Броски:
    
    IllegalArgumentException - если position меньше чем нуль
    С тех пор:
    
    JDK1.1
  - getCaretPosition
```
public int getCaretPosition()
```
    Возвращает позицию каре вставки текста. Позиция каре ограничивается быть между 0 и последний знак текста, включительно. Если текст или каре не были установлены, позиция каре по умолчанию 0.
    
    Возвраты:
    позиция каре вставки текста
    С тех пор:
    
    JDK1.1
    
    См. Также:
    setCaretPosition(int)
  - addTextListener
```
public void addTextListener(TextListener l)
```
    Добавляет указанный текстовый слушатель события, чтобы получить текстовые события от этого текстового компонента. Если l null, никакое исключение не выдается, и никакое действие не выполняется.
    Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.
    
    Параметры:
    l - текстовый слушатель события
    См. Также:
    removeTextListener(java.awt.event.TextListener), getTextListeners(), TextListener
  - removeTextListener
```
public void removeTextListener(TextListener l)
```
    Удаляет указанного текстового слушателя события так, чтобы это больше не получило текстовые события от этого текстового компонента Если l null, никакое исключение не выдается, и никакое действие не выполняется.
    Отошлите к AWT Распараллеливающие Проблемы для деталей о модели потоков AWT.
    
    Параметры:
    l - текстовый слушатель
    С тех пор:
    
    JDK1.1
    
    См. Также:
    addTextListener(java.awt.event.TextListener), getTextListeners(), TextListener
  - getTextListeners
```
public TextListener[] getTextListeners()
```
    Возвращает массив всех текстовых слушателей, зарегистрированных на этом текстовом компоненте.
    
    Возвраты:
    весь этот текстовый компонент TextListeners или пустой массив, если никакие текстовые слушатели в настоящий момент не регистрируются
    С тех пор:
    
    1.4
    
    См. Также:
    addTextListener(java.awt.event.TextListener), removeTextListener(java.awt.event.TextListener)
  - getListeners
```
public <T extends EventListener> T[] getListeners(Class<T> listenerType)
```
    Возвращает массив всех объектов, в настоящий момент зарегистрированных как FooListeners на это TextComponent. FooListeners регистрируются, используя addFooListener метод.
    Можно определить listenerType параметр с литералом класса, такой как FooListener.class. Например, можно запросить a TextComponent t для его текстовых слушателей со следующим кодом:
```
TextListener[] tls = (TextListener[])(t.getListeners(TextListener.class));
```
    Если никакие такие слушатели не существуют, этот метод возвращает пустой массив.
    Переопределения:
    
    getListeners в классе Component
    
    Параметры:
    listenerType - тип слушателей требуют; этот параметр должен определить интерфейс, который убывает от java.util.EventListener
    
    Возвраты:
    массив всех объектов, зарегистрированных как FooListeners на этом текстовом компоненте, или пустом массиве, если никакие такие слушатели не были добавлены
    
    Броски:
    
    ClassCastException - если listenerType не определяет класс или интерфейс, который реализует java.util.EventListener
    С тех пор:
    
    1.3
    
    См. Также:
    getTextListeners()
  - processEvent
```
protected void processEvent(AWTEvent e)
```
    События процессов на этом текстовом компоненте. Если событие является a TextEvent, это вызывает processTextEvent метод еще это вызывает свой суперкласс processEvent.
    Отметьте это, если параметр события null поведение является неуказанным и может привести к исключению.
    
    Переопределения:
    
    processEvent в классе Component
    
    Параметры:
    e - событие
    См. Также:
    Component.processComponentEvent(java.awt.event.ComponentEvent), Component.processFocusEvent(java.awt.event.FocusEvent), Component.processKeyEvent(java.awt.event.KeyEvent), Component.processMouseEvent(java.awt.event.MouseEvent), Component.processMouseMotionEvent(java.awt.event.MouseEvent), Component.processInputMethodEvent(java.awt.event.InputMethodEvent), Component.processHierarchyEvent(java.awt.event.HierarchyEvent), Component.processMouseWheelEvent(java.awt.event.MouseWheelEvent)
  - processTextEvent
```
protected void processTextEvent(TextEvent e)
```
    Текстовые события процессов, происходящие на этом текстовом компоненте, диспетчеризируя их любому зарегистрированному TextListener объекты.
    ОТМЕТЬТЕ: Этот метод не вызовут, если текстовые события не будут включены для этого компонента. Это происходит, когда одно из следующего происходит:
    - A TextListener объект регистрируется через addTextListener
    - Через текстовые события включают enableEvents
    Отметьте это, если параметр события null поведение является неуказанным и может привести к исключению.
    Параметры:
    e - текстовое событие
    См. Также:
    Component.enableEvents(long)
  - paramString
```
protected String paramString()
```
    Возвращает строку, представляющую состояние этого TextComponent. Этот метод предназначается, чтобы использоваться только для того, чтобы отладить цели, и контент и формат возвращенной строки могут измениться между реализациями. Возвращенная строка может быть пустой, но, возможно, не null.
    
    Переопределения:
    
    paramString в классе Component
    
    Возвраты:
    строка параметра этого текстового компонента
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    Связали AccessibleContext с этим TextComponent. Для текстовых компонентов AccessibleContext принимает форму AccessibleAWTTextComponent. Новый экземпляр AccessibleAWTTextComponent создается в случае необходимости.
    
    Определенный:
    
    getAccessibleContext в интерфейсе Accessible
    
    Переопределения:
    
    getAccessibleContext в классе Component
    
    Возвраты:
    AccessibleAWTTextComponent, который служит AccessibleContext этого TextComponent
    С тех пор:
    
    1.3

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

Класс TextComponent

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

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

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

Поля java.awt унаследованный от класса. Компонент

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

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

Методы java.awt унаследованный от класса. Компонент

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

Полевая Деталь

textListener

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

enableInputMethods

getInputMethodRequests

addNotify

removeNotify

setText

getText

getSelectedText

isEditable

setEditable

getBackground

setBackground

getSelectionStart

setSelectionStart

getSelectionEnd

setSelectionEnd

выбрать

selectAll

setCaretPosition

getCaretPosition

addTextListener

removeTextListener

getTextListeners

getListeners

processEvent

processTextEvent

paramString

getAccessibleContext