0

0

如何在用户编辑前为 JFormattedTextField 设置非法字符串值

霞舞

霞舞

发布时间:2026-01-14 09:59:11

|

632人浏览过

|

来源于php中文网

原创

如何在用户编辑前为 JFormattedTextField 设置非法字符串值

jformattedtextfield 默认要求 setvalue() 传入与格式器匹配的合法对象(如 number),若需预设非法字符串(如提示文本),应改用 settext(),并配合 setallowsinvalid(true) 和 setcommitsonvalidedit(false) 等设置确保显示与行为符合预期。

JFormattedTextField 的设计初衷是严格校验输入值类型:其 setValue(Object) 方法会尝试将传入对象通过关联的 Formatter(如 NumberFormatter)进行格式化或解析;若对象类型不兼容(例如向 NumberFormatter 传入 String),便会抛出 IllegalArgumentException(如 "Cannot format given Object as a Number")。因此,直接调用 ftf.setValue("I want this...") 必然失败。

正确做法是使用 setText(String) —— 它绕过格式器校验,直接设置显示文本,适用于占位符、初始提示或非法默认值。但仅此还不够,还需合理配置格式器行为:

  • ✅ nfter.setAllowsInvalid(true):允许文本框显示非法内容(否则非法字符串会被自动清空或替换为 null);
  • ✅ nfter.setCommitsOnValidEdit(false):避免在初始化时因非法文本触发 commit 导致值被重置为 null;
  • ⚠️ 避免 setCommitsOnValidEdit(true)(答案中建议有误):该设置会使文本框在每次合法编辑后立即提交值,但初始非法文本无法触发 commit,反而可能导致 getValue() 返回 null,且与“预设非法值”的目标冲突。

以下是修正后的完整示例代码:

萝卜简历
萝卜简历

免费在线AI简历制作工具,帮助求职者轻松完成简历制作。

下载
import javax.swing.*;
import javax.swing.text.NumberFormatter;
import java.text.NumberFormat;
import java.awt.*;

public class MyGUI {
    private JFrame f;
    private JPanel p;
    private JFormattedTextField ftf;
    private NumberFormat nf;
    private NumberFormatter nfter;

    public MyGUI() {
        f = new JFrame("My Window");
        f.setSize(960, 450);
        f.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        f.setLocationRelativeTo(null);

        p = new JPanel();
        p.setLayout(new FlowLayout());
        f.add(p);

        nf = NumberFormat.getInstance();
        nfter = new NumberFormatter(nf);
        nfter.setAllowsInvalid(true);           // 关键:允许显示非法字符串
        nfter.setCommitsOnValidEdit(false);     // 关键:避免非法初始值被清空
        ftf = new JFormattedTextField(nfter);

        // ✅ 使用 setText 设置非法初始文本
        ftf.setText("I want this as my ftf's value before it gets changed");

        p.add(ftf);
        f.setVisible(true); // 建议放在最后,确保组件已添加完毕
    }

    public static void main(String[] args) {
        SwingUtilities.invokeLater(MyGUI::new);
    }
}

注意事项总结:

  • setText() 是设置非法初始值的唯一可靠方式;setValue() 仅适用于合法数据类型(如 setValue(123))。
  • setAllowsInvalid(true) 必须启用,否则非法文本会被格式器自动过滤。
  • setCommitsOnValidEdit(false) 更安全:它让 getValue() 在非法状态下返回 null(可主动判断),而非意外触发无效 commit。
  • 若后续需获取用户输入的有效数值,请在焦点离开或回车事件中调用 ftf.getCommitValue() 或检查 ftf.getValue() 是否为 Number 实例。
  • 所有 Swing 组件操作应在 Event Dispatch Thread 中执行(如 SwingUtilities.invokeLater),避免线程安全问题。

相关专题

更多
数据类型有哪几种
数据类型有哪几种

数据类型有整型、浮点型、字符型、字符串型、布尔型、数组、结构体和枚举等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

301

2023.10.31

php数据类型
php数据类型

本专题整合了php数据类型相关内容,阅读专题下面的文章了解更多详细内容。

222

2025.10.31

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

315

2023.08.02

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

231

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

435

2024.03.01

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

618

2023.07.31

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

430

2024.06.27

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

254

2023.08.03

Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

36

2026.01.14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 2.5万人学习

C# 教程
C# 教程

共94课时 | 6.7万人学习

Java 教程
Java 教程

共578课时 | 45.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号