Spec-Zone.ru › OpenJDK 27

Class JTextField

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.text.JTextComponent
javax.swing.JTextField
Все реализованные интерфейсы:
ImageObserver, MenuContainer, Serializable, Accessible, Scrollable, SwingConstants
Прямые известные подклассы:
DefaultTreeCellEditor.DefaultTextField, JFormattedTextField, JPasswordField
@JavaBean(defaultProperty="UIClassID", description="A component which allows for the editing of a single line of text.") public class JTextField extends JTextComponent implements SwingConstants
JTextField — это легковесный компонент, позволяющий редактировать одну строку текста. Информацию и примеры использования текстовых полей см. в разделе How to Use Text Fields руководства The Java Tutorial.

JTextField предназначен для обеспечения совместимости на уровне исходного кода с java.awt.TextField там, где это целесообразно. Этот компонент обладает возможностями, отсутствующими в классе java.awt.TextField. Информацию о дополнительных возможностях см. в описании суперкласса.

JTextField содержит метод для установки строки, используемой в качестве строки команды для генерируемого события действия. Класс java.awt.TextField использовал текст поля в качестве строки команды для ActionEvent. JTextField будет использовать строку команды, установленную с помощью метода setActionCommand, если она не равна null, в противном случае для совместимости с java.awt.TextField будет использоваться текст поля.

Методы setEchoChar и getEchoChar не предоставляются напрямую во избежание ситуации, когда новая реализация подключаемого внешнего вида (look-and-feel) может случайно раскрыть символы пароля. Для предоставления функциональности ввода паролей отдельный класс JPasswordField расширяет JTextField, обеспечивая эту возможность с независимо подключаемым внешним видом.

За изменениями в java.awt.TextField можно следить, добавив TextListener для событий TextEvent. В компонентах на основе JTextComponent изменения рассылаются от модели через DocumentEvent слушателям DocumentListeners. Событие DocumentEvent при необходимости указывает место и тип изменения. Фрагмент кода может выглядеть следующим образом:

     DocumentListener myListener = ??;
     JTextField myArea = ??;
     myArea.getDocument().addDocumentListener(myListener);
 

Горизонтальное выравнивание JTextField может быть настроено по левому краю, по ведущему краю (leading), по центру, по правому краю или по конечному краю (trailing). Выравнивание по правому/конечному краю полезно, если требуемый размер текста поля меньше выделенного для него размера. Это определяется методами setHorizontalAlignment и getHorizontalAlignment. По умолчанию используется выравнивание по ведущему краю.

То, как текстовое поле обрабатывает события VK_ENTER, зависит от наличия у него слушателей действий. Если они есть, то VK_ENTER приводит к тому, что слушатели получают ActionEvent, а событие VK_ENTER поглощается. Это совместимо с тем, как текстовые поля AWT обрабатывают события VK_ENTER. Если у текстового поля нет слушателей действий, то, начиная с версии 1.3, событие VK_ENTER не поглощается. Вместо этого обрабатываются привязки компонентов-предков, что позволяет работать функции кнопки по умолчанию в JFC/Swing.

Пользовательские поля можно легко создавать путем расширения модели и изменения предоставленной модели по умолчанию. Например, следующий фрагмент кода создаст поле, содержащее только символы верхнего регистра. Оно будет работать, даже если текст вставляется из буфера обмена или изменяется программно.


 public class UpperCaseField extends JTextField {
 
     public UpperCaseField(int cols) {
         super(cols);
     }
 
     protected Document createDefaultModel() {
         return new UpperCaseDocument();
     }
 
     static class UpperCaseDocument extends PlainDocument {
 
         public void insertString(int offs, String str, AttributeSet a)
             throws BadLocationException {
 
             if (str == null) {
                 return;
             }
             char[] upper = str.toCharArray();
             for (int i = 0; i < upper.length; i++) {
                 upper[i] = Character.toUpperCase(upper[i]);
             }
             super.insertString(offs, new String(upper), a);
         }
     }
 }

 

Предупреждение: Swing не является потокобезопасным. Дополнительную информацию см. в разделе Swing's Threading Policy.

Предупреждение: Сериализованные объекты этого класса будут несовместимы с будущими релизами Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, работающими на одной и той же версии Swing. Начиная с версии 1.4, поддержка долговременного хранения всех JavaBeans была добавлена в пакет java.beans. См. XMLEncoder.

С какого поколения:
1.2
См. также:
  • setActionCommand(String)
  • JPasswordField
  • addActionListener(ActionListener)

Краткое описание вложенных классов

Модификатор и тип Класс Описание
protected class  JTextField.AccessibleJTextField
Этот класс реализует поддержку доступности (accessibility) для класса JTextField.

Вложенные классы/интерфейсы, объявленные в классе JTextComponent

JTextComponent.AccessibleJTextComponent, JTextComponent.DropLocation, JTextComponent.KeyBinding
Модификатор и тип Класс Описание
class  JTextComponent.AccessibleJTextComponent
Этот класс реализует поддержку доступности (accessibility) для класса JTextComponent.
static final class  JTextComponent.DropLocation
Представляет место сброса (drop location) для компонентов JTextComponent.
static class  JTextComponent.KeyBinding
Запись привязки для создания сочетаний клавиш.

Вложенные классы/интерфейсы, объявленные в классе JComponent

JComponent.AccessibleJComponent
Модификатор и тип Класс Описание
class  JComponent.AccessibleJComponent
Внутренний класс JComponent, используемый для обеспечения поддержки доступности по умолчанию.

Вложенные классы/интерфейсы, объявленные в классе Container

Container.AccessibleAWTContainer
Модификатор и тип Класс Описание
protected class  Container.AccessibleAWTContainer
Внутренний класс Container, используемый для обеспечения поддержки доступности по умолчанию.

Вложенные классы/интерфейсы, объявленные в классе Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Модификатор и тип Класс Описание
protected class  Component.AccessibleAWTComponent
Внутренний класс Component, используемый для обеспечения поддержки доступности по умолчанию.
static enum  Component.BaselineResizeBehavior
Перечисление типичных способов изменения базовой линии компонента при изменении размера.
protected class  Component.BltBufferStrategy
Внутренний класс для побитового копирования (blitting) закадровых поверхностей на компонент.
protected class  Component.FlipBufferStrategy
Внутренний класс для переключения буферов (flipping) в компоненте.

Краткое описание полей

Модификатор и тип Поле Описание
static final String notifyAction
Имя действия для отправки уведомления о принятии содержимого поля.

Поля, объявленные в классе JTextComponent

DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY
Модификатор и тип Поле Описание
static final String DEFAULT_KEYMAP
Раскладка клавиш по умолчанию (keymap), которая будет совместно использоваться всеми экземплярами JTextComponent, если для них не была установлена другая раскладка.
static final String FOCUS_ACCELERATOR_KEY
Имя связываемого свойства для акселератора фокуса.

Поля, объявленные в классе JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
Модификатор и тип Поле Описание
protected EventListenerList listenerList
Список слушателей событий для этого компонента.
static final String TOOL_TIP_TEXT_KEY
Комментарий, отображаемый при наведении курсора на компонент, также известный как «всплывающая подсказка» (value tip, flyover help или flyover label).
protected ComponentUI ui
Делегат внешнего вида (look and feel) для этого компонента.
static final int UNDEFINED_CONDITION
Константа, используемая некоторыми API для обозначения того, что условие не определено.
static final int WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
Константа, используемая для registerKeyboardAction, означающая, что команда должна вызываться, когда принимающий компонент является предком сфокусированного компонента или сам является сфокусированным компонентом.
static final int WHEN_FOCUSED
Константа, используемая для registerKeyboardAction, означающая, что команда должна вызываться, когда компонент имеет фокус.
static final int WHEN_IN_FOCUSED_WINDOW
Константа, используемая для registerKeyboardAction, означающая, что команда должна вызываться, когда принимающий компонент находится в окне, имеющем фокус, или сам является сфокусированным компонентом.

Поля, объявленные в классе Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Модификатор и тип Поле Описание
protected AccessibleContext accessibleContext
Объект AccessibleContext, связанный с этим Component.
static final float BOTTOM_ALIGNMENT
Удобная константа для getAlignmentY.
static final float CENTER_ALIGNMENT
Удобная константа для getAlignmentY и getAlignmentX.
static final float LEFT_ALIGNMENT
Удобная константа для getAlignmentX.
static final float RIGHT_ALIGNMENT
Удобная константа для getAlignmentX.
static final float TOP_ALIGNMENT
Удобная константа для getAlignmentY().

Поля, объявленные в интерфейсе ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Модификатор и тип Поле Описание
static final int ABORT
Этот флаг в аргументе infoflags метода imageUpdate указывает, что асинхронно отслеживаемое изображение было прервано до завершения генерации.
static final int ALLBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает, что статическое изображение, которое ранее отрисовывалось, теперь завершено и может быть отрисовано снова в окончательном виде.
static final int ERROR
Этот флаг в аргументе infoflags метода imageUpdate указывает, что при асинхронном отслеживании изображения произошла ошибка.
static final int FRAMEBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает, что стал доступен для повторной отрисовки еще один полный кадр многокадрового изображения, которое ранее отрисовывалось.
static final int HEIGHT
Этот флаг в аргументе infoflags метода imageUpdate указывает, что высота базового изображения теперь доступна и может быть получена из аргумента height метода обратного вызова imageUpdate.
static final int PROPERTIES
Этот флаг в аргументе infoflags метода imageUpdate указывает, что свойства изображения стали доступны.
static final int SOMEBITS
Этот флаг в аргументе infoflags метода imageUpdate указывает, что стало доступно больше пикселей, необходимых для отрисовки масштабированного варианта изображения.
static final int WIDTH
Этот флаг в аргументе infoflags метода imageUpdate указывает, что ширина базового изображения теперь доступна и может быть получена из аргумента width метода обратного вызова imageUpdate.

Поля, объявленные в интерфейсе SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
Модификатор и тип Поле Описание
static final int BOTTOM
Константа ориентации блока, используемая для указания нижней части блока.
static final int CENTER
Центральное положение в области.
static final int EAST
Направление по компасу: восток (вправо).
static final int HORIZONTAL
Горизонтальная ориентация.
static final int LEADING
Определяет ведущий край текста для использования с языками с письмом слева направо и справа налево.
static final int LEFT
Константа ориентации блока, используемая для указания левой стороны блока.
static final int NEXT
Определяет следующее направление в последовательности.
static final int NORTH
Направление по компасу: север (вверх).
static final int NORTH_EAST
Направление по компасу: северо-восток (вверх-вправо).
static final int NORTH_WEST
Направление по компасу: северо-запад (вверх-влево).
static final int PREVIOUS
Определяет предыдущее направление в последовательности.
static final int RIGHT
Константа ориентации блока, используемая для указания правой стороны блока.
static final int SOUTH
Направление по компасу: юг (вниз).
static final int SOUTH_EAST
Направление по компасу: юго-восток (вниз-вправо).
static final int SOUTH_WEST
Направление по компасу: юго-запад (вниз-влево).
static final int TOP
Константа ориентации блока, используемая для указания верхней части блока.
static final int TRAILING
Определяет конечный край текста для использования с языками с письмом слева направо и справа налево.
static final int VERTICAL
Вертикальная ориентация.
static final int WEST
Направление по компасу: запад (влево).

Краткое описание конструкторов

Конструктор Описание
JTextField()
Создает новый TextField.
JTextField(int columns)
Создает новый пустой TextField с указанным количеством столбцов.
JTextField(String text)
Создает новый TextField, инициализированный указанным текстом.
JTextField(String text, int columns)
Создает новый TextField, инициализированный указанным текстом и количеством столбцов.
JTextField(Document doc, String text, int columns)
Создает новый JTextField, использующий заданную модель хранения текста и заданное количество столбцов.

Краткое описание методов

Modifier and Type Method Description
protected void actionPropertyChanged(Action action, String propertyName)
Обновляет состояние текстового поля в ответ на изменения свойств в связанном действии.
void addActionListener(ActionListener l)
Добавляет указанный слушатель действий для получения событий действия от этого текстового поля.
protected void configurePropertiesFromAction(Action a)
Устанавливает свойства этого текстового поля в соответствии со свойствами указанного Action.
protected PropertyChangeListener createActionPropertyChangeListener(Action a)
Создает и возвращает PropertyChangeListener, который отвечает за отслеживание изменений из указанного Action и обновление соответствующих свойств.
protected Document createDefaultModel()
Создает реализацию модели по умолчанию, используемую при конструировании, если она не задана явно.
protected void fireActionPerformed()
Уведомляет всех слушателей, зарегистрировавших интерес к получению уведомлений об этом типе событий.
AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим JTextField.
Action getAction()
Возвращает текущее установленное действие Action для этого источника ActionEvent или null, если Action не задано.
ActionListener[] getActionListeners()
Возвращает массив всех ActionListener, добавленных в этот JTextField с помощью addActionListener().
Action[] getActions()
Извлекает список команд для редактора.
int getColumns()
Возвращает количество столбцов в этом TextField.
protected int getColumnWidth()
Возвращает ширину столбца.
int getHorizontalAlignment()
Возвращает горизонтальное выравнивание текста.
BoundedRangeModel getHorizontalVisibility()
Возвращает видимость текстового поля.
Dimension getPreferredSize()
Возвращает предпочтительный размер Dimensions, необходимый для этого TextField.
int getScrollOffset()
Возвращает смещение прокрутки в пикселях.
String getUIClassID()
Возвращает идентификатор класса (class ID) для пользовательского интерфейса (UI).
boolean isValidateRoot()
Вызовы revalidate, поступающие из самого текстового поля, будут обрабатываться путем валидации текстового поля, если только текстовое поле не содержится внутри JViewport, и в этом случае возвращается false.
protected String paramString()
Возвращает строковое представление этого JTextField.
void postActionEvent()
Обрабатывает события действия, происходящие в этом текстовом поле, путем их отправки всем зарегистрированным объектам ActionListener.
void removeActionListener(ActionListener l)
Удаляет указанный слушатель действий, чтобы он больше не получал события действия от этого текстового поля.
void scrollRectToVisible(Rectangle r)
Прокручивает поле влево или вправо.
void setAction(Action a)
Устанавливает Action для источника ActionEvent.
void setActionCommand(String command)
Задает строку команды, используемую для событий действия.
void setColumns(int columns)
Устанавливает количество столбцов в этом TextField, а затем инвалидирует макет.
void setDocument(Document doc)
Связывает редактор с текстовым документом.
void setFont(Font f)
Устанавливает текущий шрифт.
void setHorizontalAlignment(int alignment)
Устанавливает горизонтальное выравнивание текста.
void setScrollOffset(int scrollOffset)
Задает смещение прокрутки в пикселях.

Методы, объявленные в классе JTextComponent

addCaretListener, addKeymap, copy, cut, fireCaretUpdate, getCaret, getCaretColor, getCaretListeners, getCaretPosition, getDisabledTextColor, getDocument, getDragEnabled, getDropLocation, getDropMode, getFocusAccelerator, getHighlighter, getInputMethodRequests, getKeymap, getKeymap, getMargin, getNavigationFilter, getPreferredScrollableViewportSize, getPrintable, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getSelectedText, getSelectedTextColor, getSelectionColor, getSelectionEnd, getSelectionStart, getText, getText, getToolTipText, getUI, isEditable, loadKeymap, modelToView, modelToView2D, moveCaretPosition, paste, print, print, print, read, removeCaretListener, removeKeymap, replaceSelection, restoreComposedText, saveComposedText, select, selectAll, setCaret, setCaretColor, setCaretPosition, setDisabledTextColor, setDragEnabled, setDropMode, setEditable, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setText, setUI, updateUI, viewToModel, viewToModel2D, write
Modifier and Type Method Description
void addCaretListener(CaretListener listener)
Добавляет слушатель каретки для уведомления о любых изменениях каретки.
static Keymap addKeymap(String nm, Keymap parent)
Добавляет новую раскладку клавиш (keymap) в иерархию раскладок клавиш.
void copy()
Переносит текущий выделенный диапазон в связанной текстовой модели в системный буфер обмена, оставляя содержимое в текстовой модели.
void cut()
Переносит текущий выделенный диапазон в связанной текстовой модели в системный буфер обмена, удаляя содержимое из модели.
protected void fireCaretUpdate(CaretEvent e)
Уведомляет всех слушателей, зарегистрировавших интерес к получению уведомлений об этом типе событий.
Caret getCaret()
Извлекает каретку, которая позволяет осуществлять навигацию по тексту в представлении.
Color getCaretColor()
Возвращает текущий цвет, используемый для отрисовки каретки.
CaretListener[] getCaretListeners()
Возвращает массив всех слушателей каретки, зарегистрированных в этом текстовом компоненте.
int getCaretPosition()
Возвращает позицию каретки вставки текста для текстового компонента.
Color getDisabledTextColor()
Возвращает текущий цвет, используемый для отрисовки отключенного текста.
Document getDocument()
Извлекает модель, связанную с редактором.
boolean getDragEnabled()
Возвращает значение, указывающее, включена ли автоматическая обработка перетаскивания.
final JTextComponent.DropLocation getDropLocation()
Возвращает местоположение, которое этот компонент должен визуально отображать как место сброса во время операции DnD над компонентом, или null, если в данный момент местоположение отображаться не должно.
final DropMode getDropMode()
Возвращает режим сброса (drop mode) для этого компонента.
char getFocusAccelerator()
Возвращает клавишу-акселератор, которая заставляет принимающий текстовый компонент получить фокус.
Highlighter getHighlighter()
Извлекает объект, отвечающий за создание подсветки.
InputMethodRequests getInputMethodRequests()
Получает обработчик запросов метода ввода, который поддерживает запросы от методов ввода для этого компонента.
Keymap getKeymap()
Извлекает раскладку клавиш (keymap), активную в данный момент в этом текстовом компоненте.
static Keymap getKeymap(String nm)
Извлекает именованную раскладку клавиш (keymap), ранее добавленную в документ.
Insets getMargin()
Возвращает отступ между границей текстового компонента и его текстом.
NavigationFilter getNavigationFilter()
Возвращает NavigationFilter.
Dimension getPreferredScrollableViewportSize()
Возвращает предпочтительный размер области просмотра для компонента представления.
Printable getPrintable(MessageFormat headerFormat, MessageFormat footerFormat)
Возвращает Printable для печати содержимого этого JTextComponent.
int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
Компоненты, отображающие логические строки или столбцы, должны вычислять шаг прокрутки, который полностью откроет один блок строк или столбцов в зависимости от значения ориентации.
boolean getScrollableTracksViewportHeight()
Возвращает true, если область просмотра должна всегда принудительно согласовывать высоту этого Scrollable с высотой области просмотра.
boolean getScrollableTracksViewportWidth()
Возвращает true, если область просмотра должна всегда принудительно согласовывать ширину этого Scrollable с шириной области просмотра.
int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
Компоненты, отображающие логические строки или столбцы, должны вычислять шаг прокрутки, который полностью откроет одну новую строку или столбец в зависимости от значения ориентации.
String getSelectedText()
Возвращает выделенный текст, содержащийся в этом TextComponent.
Color getSelectedTextColor()
Возвращает текущий цвет, используемый для отрисовки выделенного текста.
Color getSelectionColor()
Возвращает текущий цвет, используемый для отрисовки выделения.
int getSelectionEnd()
Возвращает конечную позицию выделенного текста.
int getSelectionStart()
Возвращает начальную позицию выделенного текста.
String getText()
Возвращает текст, содержащийся в этом TextComponent.
String getText(int offs, int len)
Извлекает часть текста, представленного компонентом.
String getToolTipText(MouseEvent event)
Возвращает строку, которая будет использоваться в качестве всплывающей подсказки для event.
TextUI getUI()
Извлекает фабрику пользовательского интерфейса для этого текстового редактора.
boolean isEditable()
Возвращает логическое значение, указывающее, доступен ли этот TextComponent для редактирования или нет.
static void loadKeymap(Keymap map, JTextComponent.KeyBinding[] bindings, Action[] actions)
Загружает раскладку клавиш с набором привязок.
Rectangle modelToView(int pos)
Устарело.
заменено на JTextComponent.modelToView2D(int)
Rectangle2D modelToView2D(int pos)
Преобразует заданную позицию в модели в точку в системе координат представления.
void moveCaretPosition(int pos)
Перемещает каретку на новую позицию, оставляя после себя метку, определенную при последнем вызове setCaretPosition.
void paste()
Переносит содержимое системного буфера обмена в связанную текстовую модель.
boolean print()
Удобный метод печати, который отображает диалоговое окно печати, а затем печатает этот JTextComponent в интерактивном режиме без верхнего или нижнего колонтитула.
boolean print(MessageFormat headerFormat, MessageFormat footerFormat)
Удобный метод печати, который отображает диалоговое окно печати, а затем печатает этот JTextComponent в интерактивном режиме с указанным текстом верхнего и нижнего колонтитулов.
boolean print(MessageFormat headerFormat, MessageFormat footerFormat, boolean showPrintDialog, PrintService service, PrintRequestAttributeSet attributes, boolean interactive)
Печатает содержимое этого JTextComponent.
void read(Reader in, Object desc)
Выполняет инициализацию из потока.
void removeCaretListener(CaretListener listener)
Удаляет слушатель каретки.
static Keymap removeKeymap(String nm)
Удаляет именованную раскладку клавиш (keymap), ранее добавленную в документ.
void replaceSelection(String content)
Заменяет текущее выделенное содержимое новым содержимым, представленным заданной строкой.
protected void restoreComposedText()
Восстанавливает составной текст, ранее сохраненный с помощью saveComposedText.
protected boolean saveComposedText(int pos)
Сохраняет составной текст вокруг указанной позиции.
void select(int selectionStart, int selectionEnd)
Выделяет текст между указанными начальной и конечной позициями.
void selectAll()
Выделяет весь текст в TextComponent.
void setCaret(Caret c)
Устанавливает используемую каретку.
void setCaretColor(Color c)
Устанавливает текущий цвет, используемый для отрисовки каретки.
void setCaretPosition(int position)
Устанавливает позицию каретки вставки текста для TextComponent.
void setDisabledTextColor(Color c)
Устанавливает текущий цвет, используемый для отрисовки отключенного текста.
void setDragEnabled(boolean b)
Включает или выключает автоматическую обработку перетаскивания.
final void setDropMode(DropMode dropMode)
Устанавливает режим сброса (drop mode) для этого компонента.
void setEditable(boolean b)
Устанавливает указанное логическое значение, определяющее, должен ли этот TextComponent быть доступен для редактирования.
void setFocusAccelerator(char aKey)
Устанавливает клавишу-акселератор, которая заставляет принимающий текстовый компонент получить фокус.
void setHighlighter(Highlighter h)
Устанавливает используемый объект подсветки.
void setKeymap(Keymap map)
Устанавливает раскладку клавиш (keymap), используемую для привязки событий к действиям.
void setMargin(Insets m)
Задает отступ между границей текстового компонента и его текстом.
void setNavigationFilter(NavigationFilter filter)
Устанавливает NavigationFilter.
void setSelectedTextColor(Color c)
Устанавливает текущий цвет, используемый для отрисовки выделенного текста.
void setSelectionColor(Color c)
Устанавливает текущий цвет, используемый для отрисовки выделения.
void setSelectionEnd(int selectionEnd)
Устанавливает конец выделения в указанную позицию.
void setSelectionStart(int selectionStart)
Устанавливает начало выделения в указанную позицию.
void setText(String t)
Устанавливает текст этого TextComponent равным указанному тексту.
void setUI(TextUI ui)
Устанавливает фабрику пользовательского интерфейса для этого текстового редактора.
void updateUI()
Перезагружает подключаемый пользовательский интерфейс.
int viewToModel(Point pt)
Устарело.
заменено на JTextComponent.viewToModel2D(Point2D)
int viewToModel2D(Point2D pt)
Преобразует заданную точку в системе координат представления в ближайшую соответствующую позицию в модели.
void write(Writer out)
Сохраняет содержимое модели в указанный поток.

Методы, объявленные в классе JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
Модификатор и тип Метод Описание
void addAncestorListener(AncestorListener listener)
Регистрирует listener для получения AncestorEvents при перемещении его самого или любого из его предков, либо изменении их видимости.
void addNotify()
Уведомляет данный компонент о том, что у него теперь есть родительский компонент.
void addVetoableChangeListener(VetoableChangeListener listener)
Добавляет VetoableChangeListener в список слушателей.
void computeVisibleRect(Rectangle visibleRect)
Возвращает «видимый прямоугольник» компонента Component — пересечение видимых прямоугольников этого компонента и всех его предков.
boolean contains(int x, int y)
Предоставляет делегату пользовательского интерфейса возможность определить точную форму этого компонента для обработки событий мыши.
JToolTip createToolTip()
Возвращает экземпляр JToolTip, который должен использоваться для отображения всплывающей подсказки.
void disable()
Устарело.
Начиная с версии JDK 1.1, заменено на java.awt.Component.setEnabled(boolean).
void enable()
Устарело.
Начиная с версии JDK 1.1, заменено на java.awt.Component.setEnabled(boolean).
void firePropertyChange(String propertyName, boolean oldValue, boolean newValue)
Поддержка оповещения об изменениях связанных логических (boolean) свойств.
void firePropertyChange(String propertyName, int oldValue, int newValue)
Поддержка оповещения об изменениях связанных целочисленных (integer) свойств.
protected void fireVetoableChange(String propertyName, Object oldValue, Object newValue)
Поддерживает оповещение об изменениях свойств с ограничениями.
ActionListener getActionForKeyStroke(KeyStroke aKeyStroke)
Возвращает объект, который будет выполнять действие, зарегистрированное для заданного нажатия клавиши.
final ActionMap getActionMap()
Возвращает ActionMap, используемый для определения того, какое Action необходимо вызвать для конкретной привязки KeyStroke.
float getAlignmentX()
Переопределяет Container.getAlignmentX для возврата горизонтального выравнивания.
float getAlignmentY()
Переопределяет Container.getAlignmentY для возврата вертикального выравнивания.
AncestorListener[] getAncestorListeners()
Возвращает массив всех слушателей предков, зарегистрированных для этого компонента.
boolean getAutoscrolls()
Возвращает свойство autoscrolls.
int getBaseline(int width, int height)
Возвращает базовую линию.
Component.BaselineResizeBehavior getBaselineResizeBehavior()
Возвращает значение перечисления, указывающее, как базовая линия компонента изменяется при изменении размера.
Border getBorder()
Возвращает рамку этого компонента или null, если рамка в данный момент не установлена.
Rectangle getBounds(Rectangle rv)
Сохраняет границы этого компонента в «возвращаемое значение» rv и возвращает rv.
final Object getClientProperty(Object key)
Возвращает значение свойства с указанным ключом.
protected Graphics getComponentGraphics(Graphics g)
Возвращает графический объект, используемый для отрисовки этого компонента.
JPopupMenu getComponentPopupMenu()
Возвращает JPopupMenu, назначенный для этого компонента.
int getConditionForKeyStroke(KeyStroke aKeyStroke)
Возвращает условие, определяющее, происходит ли зарегистрированное действие в ответ на указанное нажатие клавиши.
int getDebugGraphicsOptions()
Возвращает состояние отладки графики.
static Locale getDefaultLocale()
Возвращает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при создании.
FontMetrics getFontMetrics(Font font)
Возвращает FontMetrics для указанного Font.
Graphics getGraphics()
Возвращает графический контекст этого компонента, позволяющий выполнять отрисовку на компоненте.
int getHeight()
Возвращает текущую высоту этого компонента.
boolean getInheritsPopupMenu()
Возвращает true, если JPopupMenu должен наследоваться от родительского компонента.
final InputMap getInputMap()
Возвращает InputMap, используемый, когда компонент находится в фокусе.
final InputMap getInputMap(int condition)
Возвращает InputMap, используемый во время condition.
InputVerifier getInputVerifier()
Возвращает верификатор ввода для этого компонента.
Insets getInsets()
Если для этого компонента установлена рамка, возвращает отступы рамки; в противном случае вызывает super.getInsets.
Insets getInsets(Insets insets)
Возвращает объект Insets, содержащий значения внутренних отступов этого компонента.
<T extends EventListener>
T[]
getListeners(Class<T> listenerType)
Возвращает массив всех объектов, зарегистрированных в данный момент как FooListener для этого JComponent.
Point getLocation(Point rv)
Сохраняет координаты x,y начала этого компонента в «возвращаемое значение» rv и возвращает rv.
Dimension getMaximumSize()
Если максимальный размер был установлен в значение, отличное от null, просто возвращает его.
Dimension getMinimumSize()
Если минимальный размер был установлен в значение, отличное от null, просто возвращает его.
Component getNextFocusableComponent()
Устарело.
Начиная с версии 1.4, заменено на FocusTraversalPolicy.
Point getPopupLocation(MouseEvent event)
Возвращает предпочтительное местоположение для отображения всплывающего меню в системе координат этого компонента.
KeyStroke[] getRegisteredKeyStrokes()
Возвращает KeyStrokes, инициирующий зарегистрированные действия.
JRootPane getRootPane()
Возвращает предка JRootPane для этого компонента.
Dimension getSize(Dimension rv)
Сохраняет ширину/высоту этого компонента в «возвращаемое значение» rv и возвращает rv.
Point getToolTipLocation(MouseEvent event)
Возвращает положение всплывающей подсказки в системе координат этого компонента.
String getToolTipText()
Возвращает строку всплывающей подсказки, заданную с помощью setToolTipText.
Container getTopLevelAncestor()
Возвращает предка верхнего уровня для этого компонента (содержащий его Window) или null, если этот компонент не был добавлен ни в один контейнер.
TransferHandler getTransferHandler()
Возвращает свойство transferHandler.
boolean getVerifyInputWhenFocusTarget()
Возвращает значение, указывающее, будет ли вызываться верификатор ввода для текущего владельца фокуса перед тем, как этот компонент запросит фокус.
VetoableChangeListener[] getVetoableChangeListeners()
Возвращает массив всех слушателей вето-изменений, зарегистрированных для этого компонента.
Rectangle getVisibleRect()
Возвращает «видимый прямоугольник» компонента Component — пересечение видимого прямоугольника этого компонента, new Rectangle(0, 0, getWidth(), getHeight()), и видимых прямоугольников всех его предков.
int getWidth()
Возвращает текущую ширину этого компонента.
int getX()
Возвращает текущую координату x начала этого компонента.
int getY()
Возвращает текущую координату y начала этого компонента.
void grabFocus()
Запрашивает передачу фокуса ввода этому Component, а также чтобы предок верхнего уровня этого Component стал сфокусированным Window.
void hide()
Устарело.
boolean isDoubleBuffered()
Возвращает значение, указывающее, должен ли этот компонент использовать буфер для отрисовки.
static boolean isLightweightComponent(Component c)
Возвращает true, если этот компонент является легковесным, то есть если у него нет нативного аналога в оконной системе.
boolean isManagingFocus()
Устарело.
Начиная с версии 1.4, заменено на Component.setFocusTraversalKeys(int, Set) и Container.setFocusCycleRoot(boolean).
boolean isOpaque()
Возвращает true, если этот компонент полностью непрозрачен.
boolean isOptimizedDrawingEnabled()
Возвращает true, если этот компонент размещает свои дочерние элементы мозаикой, то есть может гарантировать, что дочерние элементы не будут перекрываться.
final boolean isPaintingForPrint()
Возвращает true, если текущая операция отрисовки этого компонента является частью операции print.
protected boolean isPaintingOrigin()
Возвращает true, если отрисовка, инициированная для дочернего компонента, должна приводить к запуску отрисовки из этого Component или одного из его предков.
boolean isPaintingTile()
Возвращает true, если компонент в данный момент выполняет отрисовку фрагмента.
boolean isRequestFocusEnabled()
Возвращает true, если этот JComponent должен получить фокус; в противном случае возвращает false.
void paint(Graphics g)
Вызывается Swing для отрисовки компонентов.
protected void paintBorder(Graphics g)
Отрисовывает рамку компонента.
protected void paintChildren(Graphics g)
Отрисовывает дочерние элементы этого компонента.
protected void paintComponent(Graphics g)
Вызывает метод paint делегата пользовательского интерфейса, если делегат UI не равен null.
void paintImmediately(int x, int y, int w, int h)
Немедленно выполняет отрисовку указанной области в этом компоненте и во всех его потомках, перекрывающих эту область.
void paintImmediately(Rectangle r)
Немедленно отрисовывает указанную область.
void print(Graphics g)
Вызовите этот метод для вывода компонента на печать в указанный Graphics.
void printAll(Graphics g)
Вызовите этот метод для вывода компонента на печать.
protected void printBorder(Graphics g)
Печатает рамку компонента.
protected void printChildren(Graphics g)
Печатает дочерние элементы этого компонента.
protected void printComponent(Graphics g)
Вызывается во время операции печати.
protected void processComponentKeyEvent(KeyEvent e)
Обрабатывает любые события клавиатуры, распознаваемые самим компонентом.
protected boolean processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)
Вызывается для обработки привязок клавиш для ks в результате KeyEvent e.
protected void processKeyEvent(KeyEvent e)
Переопределяет processKeyEvent для обработки событий.
protected void processMouseEvent(MouseEvent e)
Обрабатывает события мыши, возникающие на этом компоненте, диспетчеризируя их любым зарегистрированным объектам MouseListener; полное описание этого метода см. в Component.processMouseEvent(MouseEvent).
protected void processMouseMotionEvent(MouseEvent e)
Обрабатывает события перемещения мыши, такие как MouseEvent.MOUSE_DRAGGED.
final void putClientProperty(Object key, Object value)
Добавляет произвольное «клиентское свойство» типа ключ/значение к этому компоненту.
void registerKeyboardAction(ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition)
Этот метод устарел; для аналогичного поведения используйте сочетание getActionMap() и getInputMap().
void registerKeyboardAction(ActionListener anAction, KeyStroke aKeyStroke, int aCondition)
Этот метод устарел; для аналогичного поведения используйте сочетание getActionMap() и getInputMap().
void removeAncestorListener(AncestorListener listener)
Отменяет регистрацию listener, чтобы он больше не получал AncestorEvents.
void removeNotify()
Уведомляет данный компонент о том, что у него больше нет родительского компонента.
void removeVetoableChangeListener(VetoableChangeListener listener)
Удаляет VetoableChangeListener из списка слушателей.
void repaint(long tm, int x, int y, int width, int height)
Добавляет указанную область в список «грязных» областей, если компонент отображается.
void repaint(Rectangle r)
Добавляет указанную область в список «грязных» областей, если компонент отображается.
boolean requestDefaultFocus()
Устарело.
Начиная с версии 1.4, заменено на FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()
void requestFocus()
Запрашивает передачу фокуса ввода этому Component.
boolean requestFocus(boolean temporary)
Запрашивает передачу фокуса ввода этому Component.
boolean requestFocusInWindow()
Запрашивает передачу фокуса ввода этому Component.
protected boolean requestFocusInWindow(boolean temporary)
Запрашивает передачу фокуса ввода этому Component.
void resetKeyboardActions()
Отменяет регистрацию всех привязок на первом уровне InputMaps и ActionMap.
void reshape(int x, int y, int w, int h)
Устарело.
Начиная с версии JDK 5, заменено на Component.setBounds(int, int, int, int).
void revalidate()
Поддерживает отложенную автоматическую компоновку.
final void setActionMap(ActionMap am)
Устанавливает ActionMap в am.
void setAlignmentX(float alignmentX)
Устанавливает горизонтальное выравнивание.
void setAlignmentY(float alignmentY)
Устанавливает вертикальное выравнивание.
void setAutoscrolls(boolean autoscrolls)
Устанавливает свойство autoscrolls.
void setBackground(Color bg)
Устанавливает цвет фона этого компонента.
void setBorder(Border border)
Устанавливает рамку этого компонента.
void setComponentPopupMenu(JPopupMenu popup)
Устанавливает JPopupMenu для этого JComponent.
void setDebugGraphicsOptions(int debugOptions)
Включает или отключает диагностическую информацию о каждой графической операции, выполняемой внутри компонента или одного из его дочерних элементов.
static void setDefaultLocale(Locale l)
Устанавливает локаль по умолчанию, используемую для инициализации свойства locale каждого JComponent при создании.
void setDoubleBuffered(boolean aFlag)
Задает, должен ли этот компонент использовать буфер для отрисовки.
void setEnabled(boolean enabled)
Устанавливает, включен ли этот компонент.
void setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)
Устанавливает клавиши перемещения фокуса для заданной операции перемещения фокуса для этого Component.
void setForeground(Color fg)
Устанавливает цвет переднего плана этого компонента.
void setInheritsPopupMenu(boolean value)
Задает, должен ли getComponentPopupMenu делегировать вызов родительскому компоненту, если для этого компонента не назначен JPopupMenu.
final void setInputMap(int condition, InputMap map)
Устанавливает InputMap для использования при условии condition в map.
void setInputVerifier(InputVerifier inputVerifier)
Устанавливает верификатор ввода для этого компонента.
void setMaximumSize(Dimension maximumSize)
Устанавливает максимальный размер этого компонента в постоянное значение.
void setMinimumSize(Dimension minimumSize)
Устанавливает минимальный размер этого компонента в постоянное значение.
void setNextFocusableComponent(Component aComponent)
Устарело.
Начиная с версии 1.4, заменено на FocusTraversalPolicy
void setOpaque(boolean isOpaque)
Если true, компонент отрисовывает каждый пиксель в пределах своих границ.
void setPreferredSize(Dimension preferredSize)
Устанавливает предпочтительный размер этого компонента.
void setRequestFocusEnabled(boolean requestFocusEnabled)
Предоставляет подсказку относительно того, должен ли этот JComponent получать фокус.
setToolTipText(String text) void
Регистрирует текст для отображения во всплывающей подсказке.
void setTransferHandler(TransferHandler newHandler)
Устанавливает TransferHandler, обеспечивающий поддержку передачи данных в данный компонент и из него через вырезание/копирование/вставку и перетаскивание.
protected void setUI(ComponentUI newUI)
Устанавливает делегат внешнего вида и поведения для этого компонента.
void setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)
Устанавливает значение, указывающее, будет ли вызываться верификатор ввода для текущего владельца фокуса перед тем, как этот компонент запросит фокус.
void setVisible(boolean aFlag)
Делает компонент видимым или невидимым.
void unregisterKeyboardAction(KeyStroke aKeyStroke)
Этот метод устарел.
void update(Graphics g)
Вызывает paint.

Методы, объявленные в классе Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
Модификатор и тип Метод Описание
Component add(Component comp)
Добавляет указанный компонент в конец этого контейнера.
Component add(Component comp, int index)
Добавляет указанный компонент в этот контейнер на заданную позицию.
void add(Component comp, Object constraints)
Добавляет указанный компонент в конец этого контейнера.
void add(Component comp, Object constraints, int index)
Добавляет указанный компонент в этот контейнер с заданными ограничениями по указанному индексу.
Component add(String name, Component comp)
Добавляет указанный компонент в этот контейнер.
void addContainerListener(ContainerListener l)
Добавляет указанный слушатель контейнера для получения событий контейнера от этого контейнера.
protected void addImpl(Component comp, Object constraints, int index)
Добавляет указанный компонент в этот контейнер по указанному индексу.
void addPropertyChangeListener(PropertyChangeListener listener)
Добавляет PropertyChangeListener в список слушателей.
void addPropertyChangeListener(String propertyName, PropertyChangeListener listener)
Добавляет PropertyChangeListener в список слушателей для определенного свойства.
void applyComponentOrientation(ComponentOrientation o)
Устанавливает свойство ComponentOrientation этого контейнера и всех компонентов, содержащихся внутри него.
boolean areFocusTraversalKeysSet(int id)
Возвращает значение, указывающее, был ли явно определен для этого контейнера набор клавиш обхода фокуса для заданной операции обхода фокуса.
int countComponents()
Устарело.
Начиная с версии JDK 1.1, заменено на getComponentCount().
void deliverEvent(Event e)
Устарело.
Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent e)
void doLayout()
Заставляет этот контейнер разместить свои компоненты.
Component findComponentAt(int x, int y)
Находит видимый дочерний компонент, содержащий указанную позицию.
Component findComponentAt(Point p)
Находит видимый дочерний компонент, содержащий указанную точку.
Component getComponent(int n)
Возвращает n-й компонент в этом контейнере.
Component getComponentAt(int x, int y)
Находит компонент, содержащий позицию x,y.
Component getComponentAt(Point p)
Возвращает компонент, содержащий указанную точку.
int getComponentCount()
Возвращает количество компонентов в этой панели.
Component[] getComponents()
Возвращает все компоненты в этом контейнере.
int getComponentZOrder(Component comp)
Возвращает индекс z-порядка компонента внутри контейнера.
ContainerListener[] getContainerListeners()
Возвращает массив всех слушателей контейнера, зарегистрированных для этого контейнера.
Set<AWTKeyStroke> getFocusTraversalKeys(int id)
Возвращает набор клавиш обхода фокуса для заданной операции обхода для этого контейнера.
FocusTraversalPolicy getFocusTraversalPolicy()
Возвращает политику обхода фокуса, которая будет управлять обходом с клавиатуры дочерних элементов этого контейнера, или null, если этот контейнер не является корнем цикла фокуса.
LayoutManager getLayout()
Возвращает менеджер компоновки для этого контейнера.
Point getMousePosition(boolean allowChildren)
Возвращает положение указателя мыши в системе координат этого Container, если Container находится под указателем мыши, в противном случае возвращает null.
Insets insets()
Устарело.
Начиная с версии JDK 1.1, заменено на getInsets().
void invalidate()
Делает контейнер недействительным.
boolean isAncestorOf(Component c)
Проверяет, содержится ли компонент в иерархии компонентов этого контейнера.
boolean isFocusCycleRoot()
Возвращает значение, указывающее, является ли этот контейнер корнем цикла обхода фокуса.
boolean isFocusCycleRoot(Container container)
Возвращает значение, указывающее, является ли указанный контейнер корнем цикла фокуса для цикла обхода фокуса этого контейнера.
final boolean isFocusTraversalPolicyProvider()
Возвращает значение, указывающее, предоставляет ли этот контейнер политику обхода фокуса.
boolean isFocusTraversalPolicySet()
Возвращает значение, указывающее, была ли политика обхода фокуса явно задана для этого контейнера.
void layout()
Устарело.
Начиная с версии JDK 1.1, заменено на doLayout().
void list(PrintStream out, int indent)
Выводит список содержимого этого контейнера в указанный выходной поток.
void list(PrintWriter out, int indent)
Выводит список, начиная с указанного отступа, в указанный print writer.
Component locate(int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на getComponentAt(int, int).
Dimension minimumSize()
Устарело.
Начиная с версии JDK 1.1, заменено на getMinimumSize().
paintComponents(Graphics g) void
Отрисовывает каждый из компонентов в этом контейнере.
Dimension preferredSize()
Устарело.
Начиная с версии JDK 1.1, заменено на getPreferredSize().
void printComponents(Graphics g)
Печатает каждый из компонентов в этом контейнере.
protected void processContainerEvent(ContainerEvent e)
Обрабатывает события контейнера, происходящие в этом контейнере, отправляя их любым зарегистрированным объектам ContainerListener.
protected void processEvent(AWTEvent e)
Обрабатывает события в этом контейнере.
void remove(int index)
Удаляет компонент, указанный с помощью index, из этого контейнера.
void remove(Component comp)
Удаляет указанный компонент из этого контейнера.
void removeAll()
Удаляет все компоненты из этого контейнера.
void removeContainerListener(ContainerListener l)
Удаляет указанный слушатель контейнера, чтобы он больше не получал события контейнера от этого контейнера.
void setComponentZOrder(Component comp, int index)
Перемещает указанный компонент на указанный индекс z-порядка в контейнере.
void setFocusCycleRoot(boolean focusCycleRoot)
Задает, является ли этот контейнер корнем цикла обхода фокуса.
void setFocusTraversalPolicy(FocusTraversalPolicy policy)
Устанавливает политику обхода фокуса, которая будет управлять обходом с клавиатуры дочерних элементов этого контейнера, если этот контейнер является корнем цикла фокуса.
final void setFocusTraversalPolicyProvider(boolean provider)
Задает, будет ли этот контейнер использоваться для предоставления политики обхода фокуса.
void setLayout(LayoutManager mgr)
Устанавливает менеджер компоновки для этого контейнера.
void transferFocusDownCycle()
Передает фокус на один цикл обхода фокуса вниз.
void validate()
Проверяет корректность (validates) этого контейнера и всех его подкомпонентов.
protected void validateTree()
Рекурсивно спускается по дереву контейнеров и повторно вычисляет компоновку для любых поддеревьев, помеченных как требующие этого (помеченных как недействительные).

Методы, объявленные в классе Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
Модификатор и тип Метод Описание
boolean action(Event evt, Object what)
Устарело.
Начиная с версии JDK 1.1, следует регистрировать этот компонент как ActionListener для компонента, генерирующего события действия.
void add(PopupMenu popup)
Добавляет указанное контекстное меню к компоненту.
void addComponentListener(ComponentListener l)
Добавляет указанный слушатель компонентов для получения событий компонента от этого компонента.
void addFocusListener(FocusListener l)
Добавляет указанный слушатель фокуса для получения событий фокуса от этого компонента при получении им фокуса ввода.
void addHierarchyBoundsListener(HierarchyBoundsListener l)
Добавляет указанный слушатель границ иерархии для получения событий границ иерархии от этого компонента при изменении иерархии, к которой принадлежит данный контейнер.
void addHierarchyListener(HierarchyListener l)
Добавляет указанный слушатель иерархии для получения событий изменения иерархии от этого компонента при изменении иерархии, к которой принадлежит данный контейнер.
void addInputMethodListener(InputMethodListener l)
Добавляет указанный слушатель метода ввода для получения событий метода ввода от этого компонента.
void addKeyListener(KeyListener l)
Добавляет указанный слушатель клавиш для получения событий клавиш от этого компонента.
void addMouseListener(MouseListener l)
Добавляет указанный слушатель мыши для получения событий мыши от этого компонента.
void addMouseMotionListener(MouseMotionListener l)
Добавляет указанный слушатель движения мыши для получения событий движения мыши от этого компонента.
void addMouseWheelListener(MouseWheelListener l)
Добавляет указанный слушатель колеса мыши для получения событий колеса мыши от этого компонента.
Rectangle bounds()
Устарело.
Начиная с версии JDK 1.1, заменено на getBounds().
int checkImage(Image image, int width, int height, ImageObserver observer)
Возвращает статус построения экранного представления указанного изображения.
int checkImage(Image image, ImageObserver observer)
Возвращает статус построения экранного представления указанного изображения.
protected AWTEvent coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)
Потенциально объединяет отправляемое событие с существующим событием.
boolean contains(Point p)
Проверяет, «содержит» ли этот компонент указанную точку, где координаты x и y точки определены относительно системы координат этого компонента.
Image createImage(int width, int height)
Создает закадровое отрисовываемое изображение, используемое для двойной буферизации.
Image createImage(ImageProducer producer)
Создает изображение из указанного поставщика изображений.
VolatileImage createVolatileImage(int width, int height)
Создает энергонезависимое (volatile) закадровое отрисовываемое изображение, используемое для двойной буферизации.
VolatileImage createVolatileImage(int width, int height, ImageCapabilities caps)
Создает энергонезависимое (volatile) закадровое отрисовываемое изображение с заданными возможностями.
protected final void disableEvents(long eventsToDisable)
Отключает доставку этому компоненту событий, определенных указанным параметром маски событий.
final void dispatchEvent(AWTEvent e)
Диспетчеризирует событие этому компоненту или одному из его подкомпонентов.
void enable(boolean b)
Устарело.
Начиная с версии JDK 1.1, заменено на setEnabled(boolean).
protected final void enableEvents(long eventsToEnable)
Включает доставку этому компоненту событий, определенных указанным параметром маски событий.
void enableInputMethods(boolean enable)
Включает или отключает поддержку методов ввода для этого компонента.
void firePropertyChange(String propertyName, byte oldValue, byte newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, char oldValue, char newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, double oldValue, double newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, float oldValue, float newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, long oldValue, long newValue)
Сообщает об изменении связанного свойства.
void firePropertyChange(String propertyName, short oldValue, short newValue)
Сообщает об изменении связанного свойства.
protected void firePropertyChange(String propertyName, Object oldValue, Object newValue)
Поддержка уведомлений об изменении связанных свойств для свойств типа Object.
Color getBackground()
Возвращает цвет фона этого компонента.
Rectangle getBounds()
Возвращает границы этого компонента в виде объекта Rectangle.
ColorModel getColorModel()
Возвращает экземпляр ColorModel, используемый для отображения компонента на устройстве вывода.
ComponentListener[] getComponentListeners()
Возвращает массив всех слушателей компонентов, зарегистрированных для этого компонента.
ComponentOrientation getComponentOrientation()
Возвращает языковую ориентацию, которая должна использоваться для упорядочения элементов или текста внутри этого компонента.
Cursor getCursor()
Возвращает курсор, установленный в компоненте.
DropTarget getDropTarget()
Возвращает DropTarget, связанный с этим Component.
Container getFocusCycleRootAncestor()
Возвращает контейнер Container, который является корнем цикла обхода фокуса для этого Component.
FocusListener[] getFocusListeners()
Возвращает массив всех слушателей фокуса, зарегистрированных для этого компонента.
boolean getFocusTraversalKeysEnabled()
Возвращает, включены ли клавиши обхода фокуса для этого Component.
Font getFont()
Возвращает шрифт этого компонента.
Color getForeground()
Возвращает цвет переднего плана этого компонента.
GraphicsConfiguration getGraphicsConfiguration()
Возвращает GraphicsConfiguration, связанный с этим Component.
HierarchyBoundsListener[] getHierarchyBoundsListeners()
Возвращает массив всех слушателей границ иерархии, зарегистрированных для этого компонента.
HierarchyListener[] getHierarchyListeners()
Возвращает массив всех слушателей иерархии, зарегистрированных для этого компонента.
boolean getIgnoreRepaint()
Возвращает, следует ли игнорировать сообщения отрисовки, полученные от операционной системы.
InputContext getInputContext()
Возвращает контекст ввода, используемый этим компонентом для обработки взаимодействия с методами ввода при вводе текста в этот компонент.
InputMethodListener[] getInputMethodListeners()
Возвращает массив всех слушателей метода ввода, зарегистрированных для этого компонента.
KeyListener[] getKeyListeners()
Возвращает массив всех слушателей клавиш, зарегистрированных для этого компонента.
Locale getLocale()
Возвращает локаль этого компонента.
Point getLocation()
Возвращает положение этого компонента в виде точки, определяющей левый верхний угол компонента.
Point getLocationOnScreen()
Возвращает положение этого компонента в виде точки, определяющей левый верхний угол компонента в пространстве координат экрана.
MouseListener[] getMouseListeners()
Возвращает массив всех слушателей мыши, зарегистрированных для этого компонента.
MouseMotionListener[] getMouseMotionListeners()
Возвращает массив всех слушателей движения мыши, зарегистрированных для этого компонента.
Point getMousePosition()
Возвращает позицию указателя мыши в системе координат этого Component, если Component находится непосредственно под указателем мыши, в противном случае возвращает null.
MouseWheelListener[] getMouseWheelListeners()
Возвращает массив всех слушателей колеса мыши, зарегистрированных для этого компонента.
String getName()
Возвращает имя компонента.
Container getParent()
Возвращает родительский элемент этого компонента.
PropertyChangeListener[] getPropertyChangeListeners()
Возвращает массив всех слушателей изменения свойств, зарегистрированных для этого компонента.
PropertyChangeListener[] getPropertyChangeListeners(String propertyName)
Возвращает массив всех слушателей, связанных с указанным свойством.
Dimension getSize()
Возвращает размер этого компонента в виде объекта Dimension.
Toolkit getToolkit()
Возвращает инструментарий (toolkit) этого компонента.
final Object getTreeLock()
Возвращает объект блокировки этого компонента (объект, владеющий монитором синхронизации потоков) для операций с деревом компонентов и разметкой AWT.
boolean gotFocus(Event evt, Object what)
Устарело.
Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
boolean handleEvent(Event evt)
Устарело.
Начиная с версии JDK 1.1, заменено на processEvent(AWTEvent).
boolean hasFocus()
Возвращает true, если этот Component является владельцем фокуса.
boolean imageUpdate(Image img, int infoflags, int x, int y, int w, int h)
Перерисовывает компонент при изменении изображения.
boolean inside(int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на contains(int, int).
boolean isBackgroundSet()
Возвращает, был ли цвет фона явно установлен для этого Component.
boolean isCursorSet()
Возвращает, был ли курсор явно установлен для этого Component.
boolean isDisplayable()
Определяет, является ли этот компонент отображаемым.
boolean isEnabled()
Определяет, включен ли этот компонент.
boolean isFocusable()
Возвращает, может ли этот Component получать фокус.
boolean isFocusOwner()
Возвращает true, если этот Component является владельцем фокуса.
boolean isFocusTraversable()
Устарело.
Начиная с версии 1.4, заменено на isFocusable().
boolean isFontSet()
Возвращает, был ли шрифт явно установлен для этого Component.
boolean isForegroundSet()
Возвращает, был ли цвет переднего плана явно установлен для этого Component.
boolean isLightweight()
Облегченный компонент (lightweight) не имеет собственного peer-компонента графического инструментария.
boolean isMaximumSizeSet()
Возвращает true, если максимальный размер был установлен в значение, отличное от null, иначе возвращает false.
boolean isMinimumSizeSet()
Возвращает, вызывался ли метод setMinimumSize со значением, отличным от null.
boolean isPreferredSizeSet()
Возвращает true, если предпочитаемый размер был установлен в значение, отличное от null, иначе возвращает false.
boolean isShowing()
Определяет, отображается ли этот компонент на экране.
boolean isValid()
Определяет, является ли этот компонент допустимым (valid).
boolean isVisible()
Определяет, должен ли этот компонент быть видимым, когда видим его родительский компонент.
boolean keyDown(Event evt, int key)
Устарело.
Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent).
boolean keyUp(Event evt, int key)
Устарело.
Начиная с версии JDK 1.1, заменено на processKeyEvent(KeyEvent).
void list()
Выводит список данных этого компонента в стандартный системный поток вывода System.out.
void list(PrintStream out)
Выводит список данных этого компонента в указанный поток вывода.
void list(PrintWriter out)
Выводит список данных в указанный модуль записи (print writer).
Point location()
Устарело.
Начиная с версии JDK 1.1, заменено на getLocation().
boolean lostFocus(Event evt, Object what)
Устарело.
Начиная с версии JDK 1.1, заменено на processFocusEvent(FocusEvent).
boolean mouseDown(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
boolean mouseDrag(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent).
boolean mouseEnter(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
boolean mouseExit(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
boolean mouseMove(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseMotionEvent(MouseEvent).
boolean mouseUp(Event evt, int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на processMouseEvent(MouseEvent).
void move(int x, int y)
Устарело.
Начиная с версии JDK 1.1, заменено на setLocation(int, int).
void nextFocus()
Устарело.
Начиная с версии JDK 1.1, заменено на transferFocus().
void paintAll(Graphics g)
Отрисовывает этот компонент и все его подкомпоненты.
boolean postEvent(Event e)
Устарело.
Начиная с версии JDK 1.1, заменено на dispatchEvent(AWTEvent).
boolean prepareImage(Image image, int width, int height, ImageObserver observer)
Подготавливает изображение для отрисовки на этом компоненте с указанными шириной и высотой.
boolean prepareImage(Image image, ImageObserver observer)
Подготавливает изображение для отрисовки на этом компоненте.
protected void processComponentEvent(ComponentEvent e)
Обрабатывает события компонента, происходящие на этом компоненте, путем диспетчеризации их любым зарегистрированным объектам ComponentListener.
protected void processFocusEvent(FocusEvent e)
Обрабатывает события фокуса, происходящие на этом компоненте, путем диспетчеризации их любым зарегистрированным объектам FocusListener.
protected void processHierarchyBoundsEvent(HierarchyEvent e)
Обрабатывает события границ иерархии, происходящие на этом компоненте, путем диспетчеризации их любым зарегистрированным объектам HierarchyBoundsListener.
protected void processHierarchyEvent(HierarchyEvent e)
Обрабатывает события иерархии, происходящие на этом компоненте, путем диспетчеризации их любым зарегистрированным объектам HierarchyListener.
protected void processInputMethodEvent(InputMethodEvent e)
Обрабатывает события метода ввода, происходящие на этом компоненте, путем диспетчеризации их любым зарегистрированным объектам InputMethodListener.
protected void processMouseWheelEvent(MouseWheelEvent e)
Обрабатывает события колеса мыши, происходящие на этом компоненте, путем диспетчеризации их любым зарегистрированным объектам MouseWheelListener.
void remove(MenuComponent popup)
Удаляет указанное контекстное меню из компонента.
void removeComponentListener(ComponentListener l)
Удаляет указанный слушатель компонентов, чтобы он больше не получал события компонента от этого компонента.
void removeFocusListener(FocusListener l)
Удаляет указанный слушатель фокуса, чтобы он больше не получал события фокуса от этого компонента.
void removeHierarchyBoundsListener(HierarchyBoundsListener l)
Удаляет указанный слушатель границ иерархии, чтобы он больше не получал события границ иерархии от этого компонента.
void removeHierarchyListener(HierarchyListener l)
Удаляет указанный слушатель иерархии, чтобы он больше не получал события изменения иерархии от этого компонента.
void removeInputMethodListener(InputMethodListener l)
Удаляет указанный слушатель метода ввода, чтобы он больше не получал события метода ввода от этого компонента.
void removeKeyListener(KeyListener l)
Удаляет указанный слушатель клавиш, чтобы он больше не получал события клавиш от этого компонента.
void removeMouseListener(MouseListener l)
Удаляет указанный слушатель мыши, чтобы он больше не получал события мыши от этого компонента.
void removeMouseMotionListener(MouseMotionListener l)
Удаляет указанный слушатель движения мыши, чтобы он больше не получал события движения мыши от этого компонента.
void removeMouseWheelListener(MouseWheelListener l)
Удаляет указанный слушатель колеса мыши, чтобы он больше не получал события колеса мыши от этого компонента.
void removePropertyChangeListener(PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка слушателей.
void removePropertyChangeListener(String propertyName, PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка слушателей для определенного свойства.
void repaint()
Перерисовывает этот компонент.
void repaint(int x, int y, int width, int height)
Перерисовывает указанный прямоугольник этого компонента.
void repaint(long tm)
Перерисовывает компонент.
protected boolean requestFocus(boolean temporary, FocusEvent.Cause cause)
Запрашивает по причине cause, чтобы этот Component получил фокус ввода, а предок верхнего уровня этого Component стал сфокусированным Window.
void requestFocus(FocusEvent.Cause cause)
Запрашивает по причине cause, чтобы этот Component получил фокус ввода, а предок верхнего уровня этого Component стал сфокусированным Window.
boolean requestFocusInWindow(FocusEvent.Cause cause)
Запрашивает по причине cause, чтобы этот Component получил фокус ввода, если предок верхнего уровня этого Component уже является сфокусированным Window.
void resize(int width, int height)
Устарело.
Начиная с версии JDK 1.1, заменено на setSize(int, int).
void resize(Dimension d)
Устарело.
Начиная с версии JDK 1.1, заменено на setSize(Dimension).
void setBounds(int x, int y, int width, int height)
Перемещает этот компонент и изменяет его размер.
void setBounds(Rectangle r)
Перемещает этот компонент и изменяет его размер в соответствии с новым ограничивающим прямоугольником r.
void setComponentOrientation(ComponentOrientation o)
Устанавливает языковую ориентацию, которая должна использоваться для упорядочения элементов или текста внутри этого компонента.
void setCursor(Cursor cursor)
Устанавливает изображение курсора в указанный курсор.
void setDropTarget(DropTarget dt)
Связывает DropTarget с этим компонентом.
void setFocusable(boolean focusable)
Устанавливает возможность фокусировки этого Component в указанное значение.
void setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)
Устанавливает, включены ли клавиши обхода фокуса для этого Component.
void setIgnoreRepaint(boolean ignoreRepaint)
Устанавливает, следует ли игнорировать сообщения отрисовки, полученные от операционной системы.
void setLocale(Locale l)
Устанавливает локаль этого компонента.
void setLocation(int x, int y)
Перемещает этот компонент на новое место.
void setLocation(Point p)
Перемещает этот компонент на новое место.
void setMixingCutoutShape(Shape shape)
Устанавливает форму выреза смешивания («mixing-cutout») для этого облегченного компонента.
void setName(String name)
Устанавливает имя компонента в указанную строку.
void setSize(int width, int height)
Изменяет размер этого компонента так, чтобы он имел ширину width и высоту height.
void setSize(Dimension d)
Изменяет размер этого компонента так, чтобы он имел ширину d.width и высоту d.height.
void show()
Устарело.
Начиная с версии JDK 1.1, заменено на setVisible(boolean).
void show(boolean b)
Устарело.
Начиная с версии JDK 1.1, заменено на setVisible(boolean).
Dimension size()
Устарело.
Начиная с версии JDK 1.1, заменено на getSize().
String toString()
Возвращает строковое представление этого компонента и его значений.
void transferFocus()
Передает фокус следующему компоненту, как если бы этот Component являлся владельцем фокуса.
void transferFocusBackward()
Передает фокус предыдущему компоненту, как если бы этот Component являлся владельцем фокуса.
void transferFocusUpCycle()
Передает фокус на один цикл обхода фокуса вверх.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создает и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, равен ли некоторый другой объект «этому».
protected void finalize()
Устарело, для удаления: этот элемент API подлежит удалению в будущей версии.
Механизм финализации объявлен устаревшим и подлежит удалению в будущем выпуске.
final Class<?> getClass()
Возвращает класс среды выполнения для этого Object.
int hashCode()
Возвращает значение хэш-кода для этого объекта.
final void notify()
Возобновляет работу одного потока, ожидающего на мониторе этого объекта.
final void notifyAll()
Возобновляет работу всех потоков, ожидающих на мониторе этого объекта.
final void wait()
Приводит текущий поток в состояние ожидания до тех пор, пока он не будет разбужен, обычно посредством уведомления или прерывания.
final void wait(long timeoutMillis)
Приводит текущий поток в состояние ожидания до тех пор, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет определенное количество реального времени.
final void wait(long timeoutMillis, int nanos)
Приводит текущий поток в состояние ожидания до тех пор, пока он не будет разбужен, обычно посредством уведомления или прерывания, либо пока не истечет определенное количество реального времени.

Подробное описание полей

notifyAction

public static final String notifyAction
Имя действия для отправки уведомления о том, что содержимое поля было принято. Обычно привязано к клавише Enter (возврат каретки).
См. также:
  • Постоянные значения полей

Подробное описание конструкторов

JTextField

public JTextField()
Создает новый TextField. Создается модель по умолчанию, начальная строка равна null, а количество столбцов установлено в 0.

JTextField

public JTextField(String text)
Создает новый TextField, инициализированный указанным текстом. Создается модель по умолчанию, а количество столбцов равно 0.
Параметры:
text - отображаемый текст или null

JTextField

public JTextField(int columns)
Создает новый пустой TextField с указанным количеством столбцов. Создается модель по умолчанию, а начальная строка устанавливается в null.
Параметры:
columns - количество столбцов, используемое для вычисления предпочитаемой ширины; если задан ноль, предпочитаемая ширина будет определяться естественной реализацией компонента

JTextField

public JTextField(String text, int columns)
Создает новый TextField, инициализированный указанным текстом и столбцами. Создается модель по умолчанию.
Параметры:
text - отображаемый текст или null
columns - количество столбцов, используемое для вычисления предпочитаемой ширины; если задан ноль, предпочитаемая ширина будет определяться естественной реализацией компонента

JTextField

public JTextField(Document doc, String text, int columns)
Создает новый JTextField, использующий заданную модель хранения текста и заданное количество столбцов. Это конструктор, через который вызываются остальные конструкторы. Если документ равен null, создается модель по умолчанию.
Параметры:
doc - используемое хранилище текста; если это null, модель по умолчанию будет предоставлена вызовом метода createDefaultModel
text - начальная строка для отображения или null
columns - количество столбцов, используемое для вычисления предпочитаемой ширины >= 0; если columns установлено в ноль, предпочитаемая ширина будет определяться естественной реализацией компонента
Исключения:
IllegalArgumentException - если columns < 0

Подробное описание методов

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()
Возвращает идентификатор класса для UI.
Переопределяет:
getUIClassID в классе JComponent
Возвращает:
строку "TextFieldUI"
См. также:
  • JComponent.getUIClassID()
  • UIDefaults.getUI(JComponent)

setDocument

@BeanProperty(expert=true, description="the text document model") public void setDocument(Document doc)
Связывает редактор с текстовым документом. Зарегистрированная в данный момент фабрика используется для построения представления документа, которое отображается редактором после повторной валидации. Событие PropertyChange ("document") распространяется каждому слушателю.
Переопределяет:
setDocument в классе JTextComponent
Параметры:
doc - документ для отображения/редактирования
См. также:
  • JTextComponent.getDocument()

isValidateRoot

public boolean isValidateRoot()
Вызовы revalidate, исходящие из самого текстового поля, будут обрабатываться путем валидации текстового поля, за исключением случаев, когда текстовое поле находится внутри JViewport, и тогда возвращается false.
Переопределяет:
isValidateRoot в классе JComponent
Возвращает:
если родитель этого текстового поля является JViewPort, возвращает false, иначе возвращает true
См. также:
  • JComponent.revalidate()
  • JComponent.isValidateRoot()
  • Container.isValidateRoot()

getHorizontalAlignment

public int getHorizontalAlignment()
Возвращает горизонтальное выравнивание текста. Допустимые значения:
  • JTextField.LEFT
  • JTextField.CENTER
  • JTextField.RIGHT
  • JTextField.LEADING
  • JTextField.TRAILING
Возвращает:
горизонтальное выравнивание

setHorizontalAlignment

@BeanProperty(preferred=true, enumerationValues={"JTextField.LEFT","JTextField.CENTER","JTextField.RIGHT","JTextField.LEADING","JTextField.TRAILING"}, description="Set the field alignment to LEFT, CENTER, RIGHT, LEADING (the default) or TRAILING") public void setHorizontalAlignment(int alignment)
Устанавливает горизонтальное выравнивание текста. Допустимые значения:
  • JTextField.LEFT
  • JTextField.CENTER
  • JTextField.RIGHT
  • JTextField.LEADING
  • JTextField.TRAILING
При установке выравнивания вызываются invalidate и repaint, а также инициируется событие PropertyChange ("horizontalAlignment").
Параметры:
alignment - выравнивание
Исключения:
IllegalArgumentException - если alignment не является допустимым ключом

createDefaultModel

protected Document createDefaultModel()
Создает реализацию модели по умолчанию, которая будет использоваться при создании, если она не указана явно. Возвращается экземпляр PlainDocument.
Возвращает:
реализацию модели по умолчанию

getColumns

public int getColumns()
Возвращает количество столбцов в этом TextField.
Возвращает:
количество столбцов >= 0

setColumns

@BeanProperty(bound=false, description="the number of columns preferred for display") public void setColumns(int columns)
Устанавливает количество столбцов в этом TextField, а затем делает разметку недействительной.
Параметры:
columns - количество столбцов >= 0
Исключения:
IllegalArgumentException - если columns меньше 0

getColumnWidth

protected int getColumnWidth()
Возвращает ширину столбца. Понятие того, что такое столбец, для некоторых шрифтов может считаться довольно условным. Этот метод используется для определения ширины столбца. По умолчанию это определяется как ширина символа m для используемого шрифта. Этот метод может быть переопределен для установки другого значения
Возвращает:
ширину столбца >= 1

getPreferredSize

public Dimension getPreferredSize()
Возвращает предпочитаемый размер Dimensions, необходимый для этого TextField. Если было задано ненулевое количество столбцов, ширина устанавливается равной количеству столбцов, умноженному на ширину столбца.
Переопределяет:
getPreferredSize в классе JComponent
Возвращает:
размеры этого текстового поля
См. также:
  • JComponent.setPreferredSize(Dimension)
  • ComponentUI

setFont

public void setFont(Font f)
Устанавливает текущий шрифт. При этом удаляются кэшированные высота строки и ширина столбца, чтобы отразить новый шрифт. После установки шрифта вызывается revalidate.
Переопределяет:
setFont в классе JComponent
Параметры:
f - новый шрифт
См. также:
  • Component.getFont()

addActionListener

public void addActionListener(ActionListener l)
Добавляет указанный слушатель действий для получения событий действий от этого текстового поля.
Параметры:
l - добавляемый слушатель действий

removeActionListener

public void removeActionListener(ActionListener l)
Удаляет указанный слушатель действий, чтобы он больше не получал события действий от этого текстового поля.
Параметры:
l - удаляемый слушатель действий

getActionListeners

@BeanProperty(bound=false) public ActionListener[] getActionListeners()
Возвращает массив всех объектов ActionListener, добавленных к этому JTextField с помощью addActionListener().
Возвращает:
все добавленные объекты ActionListener или пустой массив, если слушатели не были добавлены
Начиная с версии:
1.4

fireActionPerformed

protected void fireActionPerformed()
Уведомляет всех слушателей, зарегистрировавших интерес к получению уведомлений об этом типе событий. Экземпляр события создается с опозданием (лениво). Список слушателей обрабатывается в обратном порядке (от последних к первым).
См. также:
  • EventListenerList

setActionCommand

public void setActionCommand(String command)
Задает строку команды, используемую для событий действий.
Параметры:
command - строка команды

setAction

@BeanProperty(visualUpdate=true, description="the Action instance connected with this ActionEvent source") public void setAction(Action a)
Устанавливает Action для источника ActionEvent. Новое действие Action заменяет любое ранее установленное Action, но не влияет на ActionListeners, добавленные независимо с помощью addActionListener. Если Action уже является зарегистрированным ActionListener для источника ActionEvent, оно не регистрируется повторно.

Установка Action приводит к немедленному изменению всех свойств, описанных в разделе Компоненты Swing, поддерживающие Action. Впоследствии свойства текстового поля автоматически обновляются по мере изменения свойств Action.

Этот метод использует три других метода для установки и отслеживания значений свойств Action. Он использует метод configurePropertiesFromAction для немедленного изменения свойств текстового поля. Для отслеживания изменений значений свойств Action этот метод регистрирует PropertyChangeListener, возвращенный методом createActionPropertyChangeListener. Стандартный PropertyChangeListener вызывает метод actionPropertyChanged при изменении свойства в Action.

Параметры:
a - Action для JTextField или null
Начиная с версии:
1.3
См. также:
  • Action
  • getAction()
  • configurePropertiesFromAction(Action)
  • createActionPropertyChangeListener(Action)
  • actionPropertyChanged(Action, String)

getAction

public Action getAction()
Возвращает установленное в данный момент действие Action для этого источника ActionEvent или null, если Action не задано.
Возвращает:
Action для этого источника ActionEvent или null
Начиная с версии:
1.3
См. также:
  • Action
  • setAction(Action)

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action a)
Устанавливает свойства этого текстового поля в соответствии со значениями из указанного Action. Дополнительные сведения о том, какие именно свойства устанавливаются, см. в разделе Компоненты Swing, поддерживающие Action.
Параметры:
a - Action, из которого берутся свойства, или null
Начиная с версии:
1.3
См. также:
  • Action
  • setAction(Action)

actionPropertyChanged

protected void actionPropertyChanged(Action action, String propertyName)
Обновляет состояние текстового поля в ответ на изменения свойств в связанном действии. Этот метод вызывается из PropertyChangeListener, возвращаемого методом createActionPropertyChangeListener. Подклассам обычно не требуется вызывать этот метод. Подклассы, поддерживающие дополнительные свойства Action, должны переопределять этот метод и configurePropertiesFromAction.

Список свойств, устанавливаемых этим методом, приведен в таблице в разделе Компоненты Swing, поддерживающие Action.

Параметры:
action - действие Action, связанное с этим текстовым полем
propertyName - имя изменившегося свойства
Начиная с версии:
1.6
См. также:
  • Action
  • configurePropertiesFromAction(Action)

createActionPropertyChangeListener

protected PropertyChangeListener createActionPropertyChangeListener(Action a)
Создает и возвращает PropertyChangeListener, который отвечает за отслеживание изменений указанного Action и обновление соответствующих свойств.

Предупреждение: при создании подкласса не создавайте анонимный внутренний класс. В противном случае время жизни текстового поля будет привязано ко времени жизни Action.

Параметры:
a - действие текстового поля
Возвращает:
PropertyChangeListener, который отвечает за отслеживание изменений указанного Action и обновление соответствующих свойств
Начиная с версии:
1.3
См. также:
  • Action
  • setAction(Action)

getActions

@BeanProperty(bound=false) public Action[] getActions()
Возвращает список команд для редактора. Это список команд, поддерживаемых подключаемым UI, дополненный набором команд, поддерживаемых самим редактором. Они полезны для привязки к событиям, например в раскладке клавиш (keymap).
Переопределяет:
getActions в классе JTextComponent
Возвращает:
список команд

postActionEvent

public void postActionEvent()
Обрабатывает события действий, происходящие в этом текстовом поле, отправляя их любым зарегистрированным объектам ActionListener. Обычно вызывается контроллером, зарегистрированным в текстовом поле.

getHorizontalVisibility

@BeanProperty(bound=false) public BoundedRangeModel getHorizontalVisibility()
Возвращает видимость текстового поля. Ее можно настраивать для изменения расположения видимой области, если размер поля превышает область, выделенную под него.

Реализация внешнего вида (look-and-feel) поля управляет значениями свойств минимума, максимума и протяженности (extent) в BoundedRangeModel.

Возвращает:
видимость
См. также:
  • BoundedRangeModel

getScrollOffset

public int getScrollOffset()
Возвращает смещение прокрутки в пикселях.
Возвращает:
смещение >= 0

setScrollOffset

public void setScrollOffset(int scrollOffset)
Устанавливает смещение прокрутки в пикселях.
Параметры:
scrollOffset - смещение >= 0

scrollRectToVisible

public void scrollRectToVisible(Rectangle r)
Прокручивает поле влево или вправо.
Переопределяет:
scrollRectToVisible в классе JComponent
Параметры:
r - область для прокрутки
См. также:
  • JViewport

paramString

protected String paramString()
Возвращает строковое представление этого JTextField. Этот метод предназначен для использования только в целях отладки, и содержание и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может быть null.
Переопределяет:
paramString в классе JTextComponent
Возвращает:
строковое представление этого JTextField

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим JTextField. Для JTextFields контекст AccessibleContext принимает форму AccessibleJTextField. При необходимости создается новый экземпляр AccessibleJTextField.
Указано в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе JTextComponent
Возвращает:
AccessibleJTextField, который служит в качестве AccessibleContext для этого JTextField

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в документации по Java SE, где содержатся более подробные описания, ориентированные на разработчиков, с концептуальными обзорами, определениями терминов, обходными путями и рабочими примерами кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком компании Oracle и/или ее филиалов в США и других странах.
Авторские права © 1993, 2026, Oracle и/или ее филиалы, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API