Spec-Zone.ru › OpenJDK 24

Класс 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 platform v1.2, заменено на getPassword.
String getText(int offs, int len)
Устаревшее.
С версии Java 2 platform 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 с документом по умолчанию, начальным текстом по умолчанию и шириной в 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.
Overrides:
paramString в классе JTextField
Returns:
строковое представление этого JPasswordField

getAccessibleContext

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

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

Spec-Zone.ru

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