Module  java.desktop
软件包  javax.swing

Class JPasswordField

  • All Implemented Interfaces:
    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是一个轻量级组件，允许编辑单行文本，其中视图表示已打字，但不显示原始字符。 您可以在“Java教程”一节中的 How to Use Text Fields中找到更多信息和示例。

    JPasswordField旨在是源兼容java.awt.TextField与用于echoChar集。 它分开提供，以便更容易地安全地更改JTextField的UI，而不会影响密码条目。

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

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

    警告：此类的序列化对象与将来的Swing版本不兼容。 当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。 从1.4版本开始，所有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 ，它使用给定的文本存储模型和给定的列数。 这是其他构造函数通过其提供的构造函数。 回音字符设置为'*'，但可以通过当前的“外观”来改变。 如果文档模型为null ，则将创建默认文档。
        参数
        doc - 要使用的文本存储
        txt - 要显示的文本，如果没有， null
        columns - 用于计算首选宽度> = 0的列数; 如果列设置为零，则首选宽度将是组件实现的任何自然结果

    • 方法详细信息

      • getEchoChar

        public char getEchoChar​()
        返回要用于回显的字符。 默认值为'*'。 根据当前运行的外观和感觉，默认值可能会有所不同。 例如，Metal / Ocean的默认值是一个子弹字符。
        结果
        回波字符，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​()
        已过时。 从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 - offset> = 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