Spec-Zone.ru › OpenJDK 21

Класс JPasswordField

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.text.JTextComponent
javax.swing.JTextField
javax.swing.JPasswordField
Все реализуемые интерфейсы:
ImageObserver, MenuContainer, Serializable, Accessible, Scrollable, SwingConstants 
@JavaBean(description="Allows the editing of a line of text but doesn\'t show the characters.") public class JPasswordField extends JTextField
JPasswordField — это лёгкий компонент, который позволяет редактировать одну строку текста, при этом отображение показывает, что что-то было введено, но не показывает исходные символы. Дополнительную информацию и примеры можно найти в Руководстве по использованию текстовых полей в Java Tutorial.

JPasswordField предназначен для совместимости с java.awt.TextField при использовании echoChar. Он предоставляется отдельно, чтобы упростить безопасное изменение пользовательского интерфейса для JTextField без влияния на ввод паролей.

ПРИМЕЧАНИЕ: По умолчанию JPasswordField отключает методы ввода; в противном случае символы ввода могут быть видны во время их составления с помощью методов ввода. Если приложение требует поддержки методов ввода, используйте унаследованный метод enableInputMethods(true).

Предупреждение: JPasswordField не отображает исходные введённые символы, а вместо этого отображает альтернативный текст или графику. Однако это не предотвращает появление пароля в оперативной памяти системы. Для обработки конфиденциальной информации, такой как текст пароля, обратитесь к соответствующему разделу в Рекомендациях по защищенному программированию.

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

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

С:
1.2

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

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

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

JTextField.AccessibleJTextField

Вложенные классы/интерфейсы, объявленные в классе 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

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

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

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

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

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

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

Модификатор и тип Метод Описание
void copy()
Вызывает provideErrorFeedback на текущем внешнем виде, что обычно приводит к звуковому сигналу ошибки.
void cut()
Вызывает provideErrorFeedback на текущем внешнем виде, что обычно приводит к звуковому сигналу ошибки.
boolean echoCharIsSet()
Возвращает true, если у этого JPasswordField есть набор символов для эха.
AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанное с этим JPasswordField.
char getEchoChar()
Возвращает символ, который используется для эха.
char[] getPassword()
Возвращает текст, содержащийся в этом TextComponent.
String getText()
Устарело.
Начиная с Java 2 платформы v1.2, заменено на getPassword.
String getText(int offs, int len)
Устарело.
Начиная с Java 2 платформы v1.2, заменено на getPassword.
String getUIClassID()
Возвращает имя класса L&F, который отображает этот компонент.
protected String paramString()
Возвращает строковое представление этого JPasswordField.
void setEchoChar(char c)
Устанавливает символ эха для этого JPasswordField.
void setText(String t)
Устанавливает текст этого TextComponent на указанный текст.
void updateUI()
Перезагружает подключаемый UI.

Методы, объявленные в классе javax.swing.JTextField

actionPropertyChanged, addActionListener, configurePropertiesFromAction, createActionPropertyChangeListener, createDefaultModel, fireActionPerformed, getAction, getActionListeners, getActions, getColumns, getColumnWidth, getHorizontalAlignment, getHorizontalVisibility, getPreferredSize, getScrollOffset, isValidateRoot, postActionEvent, removeActionListener, scrollRectToVisible, setAction, setActionCommand, setColumns, setDocument, setFont, setHorizontalAlignment, setScrollOffset

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

addCaretListener, addKeymap, 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, 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, setUI, 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

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

JPasswordField

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

JPasswordField

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

JPasswordField

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

JPasswordField

public JPasswordField(String text, int columns)
Создаёт новый JPasswordField с заданным текстом и количеством столбцов. Модель документа установлена по умолчанию.
Параметры:
text - отображаемый текст, null если отсутствует
columns - количество столбцов >= 0

JPasswordField

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

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

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()
Возвращает имя класса L&F, отображающего этот компонент.
Переопределяет:
getUIClassID в классе JTextField
Возвращает:
строку "PasswordFieldUI"
См. также:
  • JComponent.getUIClassID()
  • UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()
Перезагружает подключаемый UI. Ключ, используемый для извлечения нового интерфейса, — getUIClassID(). Тип UI — TextUI. invalidate вызывается после установки UI.
Переопределяет:
updateUI в классе JTextComponent
С:
1.6
См. также:
  • JComponent.setUI(javax.swing.plaf.ComponentUI)
  • UIManager.getLookAndFeel()
  • UIManager.getUI(javax.swing.JComponent)

getEchoChar

public char getEchoChar()
Возвращает символ, используемый для отображения. По умолчанию — '*'. По умолчанию может отличаться в зависимости от текущего внешнего вида. Например, в Metal/Ocean по умолчанию используется символ пули.
Возвращает:
символ отображения, 0, если не задан
См. также:
  • setEchoChar(char)
  • echoCharIsSet()

setEchoChar

@BeanProperty(bound=false, visualUpdate=true, description="character to display in place of the real characters") public void setEchoChar(char c)
Устанавливает символ отображения для этого JPasswordField. Обратите внимание, что это в основном рекомендация, так как установленная форма может использовать любые графические приёмы для представления поля. Установка значения 0 означает, что вы хотите видеть текст вводимым, подобно поведению стандартного JTextField.
Параметры:
c - символ отображения
См. также:
  • echoCharIsSet()
  • getEchoChar()

echoCharIsSet

public boolean echoCharIsSet()
Возвращает true, если у этого JPasswordField задан символ для отображения. Символ считается установленным, если символ отображения не равен 0.
Возвращает:
true, если символ отображения установлен
См. также:
  • setEchoChar(char)
  • getEchoChar()

cut

public void cut()
Вызывает provideErrorFeedback в текущем внешнем виде, что обычно приводит к звуковому сигналу ошибки. Стандартное поведение перемещения выделенного диапазона в связанной модели текста в буфер обмена и удаления содержимого из модели неприемлемо для поля пароля.
Переопределяет:
cut в классе JTextComponent
См. также:
  • Toolkit.getSystemClipboard()
  • Clipboard

copy

public void copy()
Вызывает provideErrorFeedback в текущем внешнем виде, что обычно приводит к звуковому сигналу ошибки. Стандартное поведение передачи выделенного диапазона в связанной модели текста в буфер обмена и сохранения содержимого в модели неприемлемо для поля пароля.
Переопределяет:
copy в классе JTextComponent
См. также:
  • Toolkit.getSystemClipboard()
  • Clipboard

getText

@Deprecated public String getText()
Устарело.
Начиная с Java 2 platform v1.2, заменено на getPassword.
Возвращает текст, содержащийся в этом TextComponent. Если базовый документ null, вернёт NullPointerException.

По соображениям безопасности этот метод устарел. Используйте метод * getPassword вместо этого.

Переопределяет:
getText в классе JTextComponent
Возвращает:
текст
См. также:
  • JTextComponent.setText(java.lang.String)

getText

@Deprecated public String getText(int offs, int len) throws BadLocationException
Устарело.
Начиная с Java 2 platform v1.2, заменено на getPassword.
Извлекает часть текста, представленного компонентом. Возвращает пустую строку, если длина равна 0.

По соображениям безопасности этот метод устарел. Используйте метод getPassword вместо этого.

Переопределяет:
getText в классе JTextComponent
Параметры:
offs - смещение >= 0
len - длина >= 0
Возвращает:
текст
Исключения:
BadLocationException - если смещение или длина неверны

setText

@BeanProperty(bound=false, description="the text of this component") public void setText(String t)
Описание скопировано из класса: JTextComponent
Устанавливает текст этого TextComponent на указанный текст. Если текст null или пуст, это эквивалентно простому удалению старого текста. При вставке текста конечное положение курсора определяется реализацией класса курсора.

Обратите внимание, что текст не является связанной собственностью, поэтому при его изменении не генерируется PropertyChangeEvent . Чтобы прослушивать изменения текста, используйте DocumentListener.

Переопределяет:
setText в классе JTextComponent
Параметры:
t - новый устанавливаемый текст
См. также:
  • JTextComponent.getText(int, int)
  • DefaultCaret

getPassword

@BeanProperty(bound=false) public char[] getPassword()
Возвращает текст, содержащийся в этом TextComponent. Если базовый документ null, вернёт NullPointerException. Для большей безопасности рекомендуется очищать возвращаемый массив символов после использования, устанавливая каждый символ в ноль.
Возвращает:
текст

paramString

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

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
Возвращает AccessibleContext , связанное с этим JPasswordField. Для полей паролей AccessibleContext представлено в виде AccessibleJPasswordField. Новый экземпляр AccessibleJPasswordField создаётся при необходимости.
Определено в:
getAccessibleContext в интерфейсе Accessible
Переопределено в:
getAccessibleContext в классе JTextField
Возвращает:
объект AccessibleJPasswordField, который является AccessibleContext этого JPasswordField

© 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/JPasswordField.html

Spec-Zone.ru

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