javax.swing
類別 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 是一個輕量級元件，允許編輯單行文本，其視圖指示鍵入內容，但不顯示原始字元。有關更多資訊和範例，請參閱 The Java Tutorial 中的 How to Use Text Fields 一節。

JPasswordField 與使用 echoChar 設置的 java.awt.TextField 是根本一致的。單獨提供它可以較方便地安全更改 JTextField 的 UI 而不影響密碼輸入。

註： 預設情況下，JPasswordField 禁用輸入法；否則，當使用輸入法組合時，輸入字元應該是可見的。如果應用程序需要輸入法支持，請使用繼承方法 enableInputMethods(true)。

警告：Swing 不是執行緒安全的。有關更多資訊，請參閱 Swing's Threading Policy。

警告：此類別的序列化物件與以後的 Swing 版本不相容。當前序列化支持適用於短期存儲，或適用於在運行相同 Swing 版本的應用程序之間進行 RMI（Remote Method Invocation，遠端方法調用）。從 1.4 版本開始，已在 java.beans 套件中添加了支持所有 JavaBeans^TM 長期存儲的功能。請參見 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 繼承的欄位

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

從類別 java.awt.Component 繼承的欄位

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，使其具有預設文檔、為 null 的開始文本字元串和為 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() 如果此 JPasswordField 具有為回顯設置的字元，則返回 true。
AccessibleContext	getAccessibleContext() 返回與此 JPasswordField 關聯的 AccessibleContext。
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	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, 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, 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, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, 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, transferFocusBackward, 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, hide, 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, 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；如果將列數設置為 0，則首選寬度將從元件實作自然產生

方法詳細資訊

getUIClassID

public String getUIClassID()

返回呈現此元件的 L&F 類別名。

覆寫：

類別 JTextField 中的 getUIClassID

返回：

字元串 "PasswordFieldUI"

另請參見：

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

重新載入可插入的 UI。用於獲取新介面的鍵是 getUIClassID()。該 UI 的型別是 TextUI。設置該 UI 之後調用 invalidate。

覆寫：

類別 JTextComponent 中的 updateUI

從以下版本開始：

1.6

另請參見：

JComponent.setUI(javax.swing.plaf.ComponentUI), UIManager.getLookAndFeel(), UIManager.getUI(javax.swing.JComponent)

getEchoChar

public char getEchoChar()

返回要用於回顯的字元。預設值為 '*'。預設值根據當前運行的外觀可以有所不同。例如，Metal/Ocean 的預設值為 bullet 字元。

返回：

回顯字元；如果未設置，則返回 0

另請參見：

setEchoChar(char), echoCharIsSet()

setEchoChar

public void setEchoChar(char c)

設置此 JPasswordField 的回顯字元。注意，這僅僅是一個建議，因為安裝的視圖可以使用它所需要的任何圖形技術來表示欄位。將值設置為 0 指示希望按照鍵入查看文本，類似於標準 JTextField 的行為。

參數：

c - 要顯示的回顯字元

另請參見：

echoCharIsSet(), getEchoChar()

echoCharIsSet

public boolean echoCharIsSet()

如果此 JPasswordField 具有為回顯設置的字元，則返回 true。如果回顯字元不為 0，則考慮設置字元。

返回：

如果為回顯設置了字元，則返回 true

另請參見：

setEchoChar(char), getEchoChar()

cut

public void cut()

對當前外觀調用 provideErrorFeedback，這通常啟動錯誤蜂鳴。將關聯模型中的當前選定範圍傳輸到系統剪貼板並從模型中移除內容，這種普通行為對於密碼欄位而言，是不可接受的。

覆寫：

類別 JTextComponent 中的 cut

另請參見：

Toolkit.getSystemClipboard(), Clipboard

copy

public void copy()

對當前外觀調用 provideErrorFeedback，這通常啟動錯誤蜂鳴。將關聯模型中的當前選定範圍傳輸到系統剪貼板並在模型中保留內容，這種普通行為對於密碼欄位而言，是不可接受的。

覆寫：

類別 JTextComponent 中的 copy

另請參見：

Toolkit.getSystemClipboard(), Clipboard

getText

@Deprecated
public String getText()

已過時。 從 Java 2 platform v1.2 開始，由 getPassword 來代替。

返回此 TextComponent 中所包含的文本。如果基礎文檔為 null，則將給出 NullPointerException。

出於安全考慮，此方法已廢棄。使用 getPassword 方法來代替。

覆寫：

類別 JTextComponent 中的 getText

返回：

文本

另請參見：

JTextComponent.setText(java.lang.String)

getText

@Deprecated
public String getText(int offs,
                                 int len)
               throws BadLocationException

已過時。 從 Java 2 platform v1.2 開始，由 getPassword 來代替。

獲取由元件表示的文本部分。如果長度為 0，則返回空字元串。

出於安全考慮，此方法已廢棄。使用 getPassword 方法來代替。

覆寫：

類別 JTextComponent 中的 getText

參數：

offs - 偏移量，它 >= 0

len - 長度，它 >= 0

返回：

文本

拋出：

BadLocationException - 如果偏移量或長度無效

getPassword

public char[] getPassword()

返回此 TextComponent 中所包含的文本。如果基礎文檔為 null，則將給出 NullPointerException。為了取得較高的安全性，建議將每個字元設置為 0 以便在使用後清除返回的字元陣列。

返回：

文本

paramString

protected String paramString()

返回此 JPasswordField 的字元串表示形式。此方法僅在進行除錯的時候使用，對於各個實作，所返回字元串的內容和格式可能有所不同。返回的字元串可能為空，但不可能為 null。

覆寫：

類別 JTextField 中的 paramString

返回：

此 JPasswordField 的字元串表示形式

getAccessibleContext

public AccessibleContext getAccessibleContext()

返回與此 JPasswordField 關聯的 AccessibleContext。對於密碼欄位，AccessibleContext 採用 AccessibleJPasswordField 的形式。必要時要創建新的 AccessibleJPasswordField 實例。

指定者：

介面 Accessible 中的 getAccessibleContext

覆寫：

類別 JTextField 中的 getAccessibleContext

返回：

一個 AccessibleJPasswordField，它充當此 JPasswordField 的 AccessibleContext