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。

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

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。