Класс JTextField

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 — это облегчённый компонент, позволяющий редактировать одну строку текста. Сведения об использовании текстовых полей и примеры приведены в разделе Как использовать текстовые поля в Учебнике по Java.

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

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

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

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

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

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

Обработка событий VK_ENTER текстовым полем зависит от наличия у него слушателей действий. Если они есть, событие VK_ENTER приводит к отправке им ActionEvent, а само событие VK_ENTER поглощается. Это соответствует обработке событий VK_ENTER текстовыми полями AWT. Если у текстового поля нет слушателей действий, то начиная с версии 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.

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

Начиная с версии:

1.2

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`JTextField.AccessibleJTextField`	Этот класс реализует поддержку специальных возможностей для класса `JTextField`.

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

JTextComponent.AccessibleJTextComponent, JTextComponent.DropLocation, JTextComponent.KeyBinding

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

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

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

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

DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY

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

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

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

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, 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`, использующее заданную модель хранения текста и заданное количество столбцов.

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

Модификатор и тип	Метод	Описание
`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()`	Возвращает идентификатор класса пользовательского интерфейса.
`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

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

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

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

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

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

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

notifyAction

public static final String notifyAction

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

См. также:

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

JTextField

public JTextField()

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

JTextField

public JTextField(String text)

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

Параметры:: text — текст для отображения или null

JTextField

public JTextField(int columns)

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

Параметры:: columns — число столбцов, используемое для расчета предпочтительной ширины; если для числа столбцов задано значение 0, предпочтительная ширина будет определяться естественным образом реализацией компонента

JTextField

public JTextField(String text, int columns)

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

Параметры:: text — текст для отображения или null; columns — число столбцов, используемое для расчета предпочтительной ширины; если для числа столбцов задано значение 0, предпочтительная ширина будет определяться естественным образом реализацией компонента

JTextField

public JTextField(Document doc, String text, int columns)

Создает новый JTextField, использующий указанную модель хранения текста и указанное число столбцов. Именно через этот конструктор вызываются остальные конструкторы. Если документ равен null, создается модель по умолчанию.

Параметры:: doc — используемое хранилище текста; если это null, значение по умолчанию будет предоставлено вызовом метода createDefaultModel; text — начальная строка для отображения или null; columns — число столбцов, используемое для расчета предпочтительной ширины >= 0; если для columns задано значение 0, предпочтительная ширина будет определяться естественным образом реализацией компонента
Исключения:: IllegalArgumentException — если columns < 0

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

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()

Возвращает идентификатор класса пользовательского интерфейса.

Переопределяет:

getUIClassID в классе JComponent

Возвращает:

строку "TextFieldUI"

См. также:

setDocument

@BeanProperty(expert=true, description="the text document model") public void setDocument(Document doc)

Связывает редактор с текстовым документом. Текущая зарегистрированная фабрика используется для создания представления документа, которое отображается редактором после повторной проверки. Каждому слушателю передается событие PropertyChange ("document").

Переопределяет:

setDocument в классе JTextComponent

Параметры:

doc — документ для отображения/редактирования

См. также:

isValidateRoot

public boolean isValidateRoot()

Вызовы revalidate, поступающие из самого текстового поля, обрабатываются путем проверки текстового поля, если только оно не содержится в JViewport; в этом случае метод возвращает false.

Переопределяет:

isValidateRoot в классе JComponent

Возвращает:

если родительский элемент этого текстового поля является JViewPort, возвращает false; в противном случае возвращает true

См. также:

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

Возвращает:

размер этого текстового поля

См. также:

setFont

public void setFont(Font f)

Устанавливает текущий шрифт. При этом удаляются кэшированные высота строки и ширина столбца, чтобы изменения нового шрифта отобразились. После установки шрифта вызывается revalidate.

Переопределяет:

setFont в классе JComponent

Параметры:

f — новый шрифт

См. также:

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()

Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа. Экземпляр события создается по мере необходимости. Список слушателей обрабатывается в обратном порядке.

См. также:

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

См. также:

getAction

public Action getAction()

Возвращает текущее Action для источника ActionEvent или null, если Action не задано.

Возвращает:

Action для источника ActionEvent или null

Начиная с версии:

1.3

См. также:

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action a)

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

Параметры:

a — Action, свойства которого используются, или null

Начиная с версии:

1.3

См. также:

actionPropertyChanged

protected void actionPropertyChanged(Action action, String propertyName)

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

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

Параметры:

action — Action, связанное с этим текстовым полем

propertyName — имя изменившегося свойства

Начиная с версии:

1.6

См. также:

createActionPropertyChangeListener

protected PropertyChangeListener createActionPropertyChangeListener(Action a)

Создает и возвращает PropertyChangeListener, который отслеживает изменения указанного Action и обновляет соответствующие свойства.

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

Параметры:

a — действие текстового поля

Возвращает:

PropertyChangeListener, который отслеживает изменения указанного Action и обновляет соответствующие свойства

Начиная с версии:

1.3

См. также:

getActions

@BeanProperty(bound=false) public Action[] getActions()

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

Переопределяет:: getActions в классе JTextComponent
Возвращает:: список команд

postActionEvent

public void postActionEvent()

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

getHorizontalVisibility

@BeanProperty(bound=false) public BoundedRangeModel getHorizontalVisibility()

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

Реализация внешнего вида поля управляет значениями свойств минимального, максимального и текущего диапазона в BoundedRangeModel.

Возвращает:

видимую область

См. также:

getScrollOffset

public int getScrollOffset()

Возвращает смещение прокрутки в пикселях.

Возвращает:: смещение >= 0

setScrollOffset

public void setScrollOffset(int scrollOffset)

Устанавливает смещение прокрутки в пикселях.

Параметры:: scrollOffset — смещение >= 0

scrollRectToVisible

public void scrollRectToVisible(Rectangle r)

Прокручивает поле влево или вправо.

Переопределяет:

scrollRectToVisible в классе JComponent

Параметры:

r — область для прокрутки

См. также:

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

© 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/JTextField.html