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

public class JPasswordField
extends JTextField

JPasswordField представляет собой лёгкий компонент, который позволяет редактировать одну строку текста, где представление показывает, что что-то было введено, но не отображает исходные символы. Дополнительную информацию и примеры можно найти в Руководстве по использованию текстовых полей в Java Tutorial.

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

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

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

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

Вложенные классы

Модификатор и тип	Класс и описание
`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

Поля, унаследованные от интерфейса 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

Поля, унаследованные от интерфейса java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Сводка конструкторов

Конструктор и описание
`JPasswordField()` Создаёт новый `JPasswordField`, с документом по умолчанию, начальной строкой текста и шириной столбца 0.
`JPasswordField(Document doc, String txt, int columns)` Создаёт новый `JPasswordField`, который использует заданную модель хранения текста и указанное число столбцов.
`JPasswordField(int columns)` Создаёт новый пустой `JPasswordField` с указанным числом столбцов.
`JPasswordField(String text)` Создаёт новый `JPasswordField`, инициализированный заданным текстом.
`JPasswordField(String text, 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`	`updateUI()` Перезагружает подключаемый пользовательский интерфейс.

Методы, унаследованные от класса 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, addInputMethodListener, 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, moveCaretPosition, paste, print, print, print, processInputMethodEvent, read, removeCaretListener, removeKeymap, removeNotify, replaceSelection, restoreComposedText, saveComposedText, select, selectAll, setCaret, setCaretColor, setCaretPosition, setComponentOrientation, setDisabledTextColor, setDragEnabled, setDropMode, setEditable, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setText, setUI, viewToModel, write

Методы, унаследованные от класса javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, 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, 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, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, 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, getPeer, 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, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, 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

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

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 платформы 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 платформы v1.2, заменено на getPassword.

Извлекает часть текста, представленного компонентом. Возвращает пустую строку, если длина равна 0.

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

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

getPassword

public char[] getPassword()

Возвращает текст, содержащийся в этом TextComponent. Если базовый документ null, вернёт NullPointerException. Для большей безопасности рекомендуется очистить возвращённый массив символов после использования, установив каждый символ в ноль.

Возвращает:: текст

paramString

protected String paramString()

Возвращает строковое представление этого JPasswordField. Этот метод предназначен только для отладки, и содержимое и формат возвращаемой строки могут варьироваться между реализациями. Возвращаемая строка может быть пустой, но не null.

Переопределяет:: paramString в классе JTextField
Возвращает:: строковое представление этого JPasswordField

getAccessibleContext

public AccessibleContext getAccessibleContext()

Возвращает AccessibleContext связанный с этим JPasswordField. Для полей пароля AccessibleContext представлен в виде AccessibleJPasswordField. Новый экземпляр AccessibleJPasswordField создаётся при необходимости.

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе JTextField
Возвращает:: AccessibleJPasswordField, который служит AccessibleContext этого JPasswordField

© 1993, 2020, 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.