模块  java.desktop
软件包  javax.swing

Class 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是一个轻量级组件，允许编辑单行文本，其中视图指示键入的内容，但不显示原始字符。 您可以在How to Use Text Fields （ The Java Tutorial中的一节）中找到更多信息和示例。

    JPasswordField旨在与echoChar设置的java.awt.TextField源兼容。 它是单独提供的，可以更轻松地安全地更改JTextField的UI，而不会影响密码输入。

    注意：默认情况下，JPasswordField禁用输入方法; 否则，输入字符在使用输入法编写时可以显示。 如果应用程序需要输入方法支持，请使用继承的方法enableInputMethods(true) 。

    警告： Swing不是线程安全的。 有关更多信息，请参阅Swing's Threading Policy 。

    警告：此类的序列化对象与以后的Swing版本不兼容。 当前的序列化支持适用于运行相同版本Swing的应用程序之间的短期存储或RMI。 从1.4开始， java.beans软件包中添加了对所有JavaBeans java.beans长期存储的支持。 请参阅XMLEncoder 。

    从以下版本开始：
    1.2
    另请参见：
    Serialized Form

    • 构造方法详细信息

      • 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 ，它使用给定的文本存储模型和给定的列数。 这是其他构造函数通过其提供的构造函数。 echo字符设置为'*'，但可以通过当前外观更改。 如果文档模型为null ，则将创建默认模型。
        参数
        doc - 要使用的文本存储
        txt - 要显示的文本，如果没有， null
        columns - 用于计算首选宽度的列数> = 0; 如果列设置为零，则首选宽度将是组件实现自然产生的任何宽度

    • 方法详细信息

      • getEchoChar

        public char getEchoChar()
        返回用于回显的字符。 默认值为“*”。 默认值可能会有所不同，具体取决于当前运行的外观。 例如，Metal / Ocean的默认值是项目符号。
        结果
        echo字符，如果未设置则为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()
        如果此JPasswordField具有用于回显的字符集，则返回true。 如果回声字符不为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()
        Deprecated.
        As of Java 2 platform v1.2, replaced by getPassword.
        返回此TextComponent包含的文本。 如果基础文件是null ，则会给出NullPointerException 。

        出于安全原因，不推荐使用此方法。 请改用* getPassword方法。

        重写：
        getText类 JTextComponent
        结果
        文本
        另请参见：
        JTextComponent.setText(java.lang.String)

      • getText

        @Deprecated
public String getText​(int offs,
                      int len)
               throws BadLocationException
        Deprecated.
        As of Java 2 platform v1.2, replaced by getPassword.
        获取组件表示的部分文本。 如果length为0，则返回空字符串。

        出于安全原因，不推荐使用此方法。 请改用getPassword方法。

        重写：
        getText在类 JTextComponent
        参数
        offs - 偏移量> = 0
        len - 长度> = 0
        结果
        文本
        异常
        BadLocationException - 如果偏移量或长度无效

      • getPassword

        @BeanProperty(bound=false)
public char[] getPassword()
        返回此TextComponent包含的文本。 如果基础文件是null ，则会给出NullPointerException 。 为了提高安全性，建议在使用后通过将每个字符设置为零来清除返回的字符数组。
        结果
        文本

      • paramString

        protected String paramString()
        返回此JPasswordField的字符串表示JPasswordField 。 此方法仅用于调试目的，返回字符串的内容和格式可能因实现而异。 返回的字符串可能为空，但可能不是null 。
        重写：
        paramString在类 JTextField
        结果
        此 JPasswordField的字符串表示 JPasswordField

      • getAccessibleContext

        @BeanProperty(bound=false)
public AccessibleContext getAccessibleContext()
        返回与AccessibleContext相关联的JPasswordField 。 对于密码字段，该AccessibleContext需要一个形式AccessibleJPasswordField 。 如有必要，将创建一个新的AccessibleJPasswordField实例。
        Specified by:
        getAccessibleContext ，界面 Accessible
        重写：
        getAccessibleContext在类 JTextField
        结果
        AccessibleJPasswordField ，作为 AccessibleContext的 JPasswordField