java.awt

Класс TextComponent

java.lang. Объект

java.awt. Компонент

java.awt. TextComponent

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

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

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

TextArea, TextField

public class TextComponent
extends Component
implements Accessible

TextComponent class является суперклассом любого компонента, который позволяет редактирование некоторого текста.

Текстовый компонент воплощает строку текста. TextComponent class определяет ряд методов, которые определяют, доступен ли этот текст для редактирования. Если компонент доступен для редактирования, он определяет другой набор методов, который поддерживает каре вставки текста.

Кроме того, class определяет методы, которые используются, чтобы поддержать текущий выбор из текста. Текстовый выбор, подстрока текста компонента, является целью редактирования операций. Это также упоминается как выбранный текст.

С тех пор:

JDK1.0

См. Также:

Сериализированная Форма

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

Вложенные Классы

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

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

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

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

Поля

Модификатор и Тип	Поле и Описание
protected TextListener	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

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

Модификатор и Тип	Метод и Описание
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) Возвращает массив всех объектов, в настоящий момент зарегистрированных как FooListeners на это 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) Устанавливает текст, который представляется этим текстовым компонентом, чтобы быть указанным текстом.

Методы, наследованные от 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, 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

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

textListener

protected transient TextListener textListener

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

enableInputMethods

public void enableInputMethods(boolean enable)

Включает или отключает входную поддержку метода этого текстового компонента. Если входная поддержка метода включается, и текстовый компонент также обрабатывает ключевые события, входящие события предлагаются текущему входному методу и будут только обработаны компонентом или диспетчеризированы его слушателям, если входной метод не использует их. Ли и как введенная поддержка метода этого текстового компонента включается или отключается, по умолчанию зависящее от реализации.

Переопределения:

enableInputMethods в class Component

Параметры:

enable - истина, чтобы включить, ложь, чтобы отключить

С тех пор:

1.2

См. Также:

Component.processKeyEvent(java.awt.event.KeyEvent)

getInputMethodRequests

public InputMethodRequests getInputMethodRequests()

Описание скопировало с class: Component

Получает входной обработчик запроса метода, который поддерживает запросы от входных методов для этого компонента. Компонент, который поддерживает текстовый ввод на месте, должен переопределить этот метод, чтобы возвратиться InputMethodRequests экземпляр. Одновременно, это также должно обработать входные события метода.

Переопределения:

getInputMethodRequests в class Component

Возвраты:

входной метод запрашивает обработчик на этот компонент, null по умолчанию

См. Также:

Component.addInputMethodListener(java.awt.event.InputMethodListener)

addNotify

public void addNotify()

Делает этот Компонент визуализуемым, соединяя это с собственным экранным ресурсом. Этот метод вызывает внутренне инструментарий и не должен быть вызван непосредственно программами.

Переопределения:

addNotify в class Component

См. Также:

removeNotify()

removeNotify

public void removeNotify()

Удаляет TextComponent's коллега. Коллега позволяет нам изменять появление TextComponent не изменяя его функциональность.

Переопределения:

removeNotify в class 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 в class Component

Возвраты:

Этот текстовый компонентный цвет фона. Если у этого текстового компонента нет цвета фона, цвет фона его родителя возвращается.

С тех пор:

JDK1.0

См. Также:

setBackground(Color)

setBackground

public void setBackground(Color c)

Устанавливает цвет фона этого текстового компонента.

Переопределения:

setBackground в class 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 параметр с литералом class, такой как FooListener.class. Например, можно запросить a TextComponent t для его текстовых слушателей со следующим кодом:

TextListener[] tls = (TextListener[])(t.getListeners(TextListener.class));

Если никакие такие слушатели не существуют, этот метод возвращает пустой массив.

Переопределения:

getListeners в class Component

Параметры:

listenerType - тип слушателей требуют; этот параметр должен определить интерфейс, который убывает от java.util.EventListener

Возвраты:

массив всех объектов, зарегистрированных как FooListeners на этом текстовом компоненте, или пустом массиве, если никакие такие слушатели не были добавлены

Броски:

ClassCastException - если listenerType не определяет class или интерфейс, который реализует java.util.EventListener

С тех пор:

1.3

См. Также:

getTextListeners()

processEvent

protected void processEvent(AWTEvent e)

События процессов на этом текстовом компоненте. Если событие является a TextEvent, это вызывает processTextEvent метод еще это вызывает свой суперкласс processEvent.

Отметьте это, если параметр события null поведение является неуказанным и может привести к исключению.

Переопределения:

processEvent в class 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 в class Component

Возвраты:

строка параметра этого текстового компонента

getAccessibleContext

public AccessibleContext getAccessibleContext()

Связали AccessibleContext с этим TextComponent. Для текстовых компонентов AccessibleContext принимает форму AccessibleAWTTextComponent. Новый экземпляр AccessibleAWTTextComponent создается в случае необходимости.

Определенный:

getAccessibleContext в интерфейсе Accessible

Переопределения:

getAccessibleContext в class Component

Возвраты:

AccessibleAWTTextComponent, который служит AccessibleContext этого TextComponent

С тех пор:

1.3