Spec-Zone.ru › OpenJDK 17

Класс 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, 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/JPasswordField.html

Spec-Zone.ru

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