Класс 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 обрабатывается. Это совместимо с тем, как текстовые поля 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.

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

С:

1.2

См. также:

END_OF_DOCUMENT_MARKER

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

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

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

JTextComponent.AccessibleJTextComponent, JTextComponent.DropLocation, JTextComponent.KeyBinding

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

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

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

Поля, объявленные в классе javax.swing.text.JTextComponent

DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY

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

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

Поля, объявленные в интерфейсе javax.swing.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)`	Устанавливает смещение прокрутки в пикселях.

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

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

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

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

Методы, объявленные в классе java.lang.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 - количество столбцов для расчета предпочтительной ширины; если columns равен нулю, предпочтительная ширина будет такой, которая естественным образом получается из реализации компонента

JTextField

public JTextField(String text, int columns)

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

Параметры:: text - отображаемый текст или null; columns - количество столбцов для расчета предпочтительной ширины; если 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()

Получает идентификатор класса пользовательского интерфейса.

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

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

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

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

postActionEvent

public void postActionEvent()

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

getHorizontalVisibility

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

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

Реализация вид и ощущения полей управляет значениями свойств minimum, maximum и extent на 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, 2023, 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/21/docs/api/java.desktop/javax/swing/JTextField.html