Spec-Zone.ru › OpenJDK 24

Класс 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 — это лёгкий компонент, который позволяет редактировать одну строку текста. Сведения о текстовых полях и примеры их использования см. в Руководстве по текстовым полям в Руководстве по 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
См. также:
  • setActionCommand(java.lang.String)
  • JPasswordField
  • addActionListener(java.awt.event.ActionListener)

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

Модификатор и тип Класс Описание
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
Имя действия для отправки уведомления о том, что содержимое поля было принято. Обычно оно привязано к нажатию клавиши Enter.
См. также:
  • Значения константных полей

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

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"
См. также:
  • JComponent.getUIClassID()
  • UIDefaults.getUI(javax.swing.JComponent)

setDocument

@BeanProperty(expert=true, description="the text document model") public void setDocument(Document doc)
Связывает редактор с документом текста. Текущий зарегистрированный фабричный метод используется для построения представления для документа, которое отображается редактором после перевалидации. Событие изменения свойства ("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(java.awt.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 - удаляемый обработчик событий действия
END_OF_DOCUMENT_MARKER

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(javax.swing.Action)
  • createActionPropertyChangeListener(javax.swing.Action)
  • actionPropertyChanged(javax.swing.Action, java.lang.String)

getAction

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

configurePropertiesFromAction

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

actionPropertyChanged

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

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

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

createActionPropertyChangeListener

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

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

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

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.

Возвращает:
видимость
См. также:
  • 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

© 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/JTextField.html

Spec-Zone.ru

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