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,且与“预设非法值”的目标冲突。

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

PixVerse
PixVerse

PixVerse是一款强大的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),避免线程安全问题。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

338

2023.10.31

php数据类型
php数据类型

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

225

2025.10.31

c语言 数据类型
c语言 数据类型

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

138

2026.02.12

string转int
string转int

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

1051

2023.08.02

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

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

254

2023.09.22

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

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

1110

2024.03.01

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

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

888

2023.07.31

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

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

464

2024.06.27

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

49

2026.03.13

热门下载

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

精品课程

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

共23课时 | 4.4万人学习

C# 教程
C# 教程

共94课时 | 11.4万人学习

Java 教程
Java 教程

共578课时 | 82.3万人学习

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

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