JavaTM 2 Platform
Standard Ed. 6

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 套件中添加了支持所有 JavaBeansTM 長期存儲的功能。請參見 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,它充當此 JPasswordFieldAccessibleContext

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only