Spec-Zone.ru › OpenJDK 17

Класс 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 Tutorial.

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

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

JTextField

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

JTextField

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

JTextField

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

JTextField

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

JTextField

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

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

getUIClassID

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

setDocument

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

isValidateRoot

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

getHorizontalAlignment

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

setHorizontalAlignment

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

createDefaultModel

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

getColumns

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

setColumns

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

getColumnWidth

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

getPreferredSize

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

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()
Получает список команд для редактора. Это список команд, поддерживаемых подключенным пользовательским интерфейсом, дополненный набором команд, которые поддерживает сам редактор. Они полезны для привязки к событиям, например, в ключевой раскладке.
Переопределяет:
getActions в классе JTextComponent
Возвращает:
список команд

postActionEvent

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

getHorizontalVisibility

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

Реализация виджета поля управляет значениями свойств min, max и 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, 2021, 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/17/docs/api/java.desktop/javax/swing/JTextField.html

Spec-Zone.ru

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