Java开发笔记（一百二十八）Swing的图标

灰太狼 2021-11-30 00:18 354阅读 0赞

前面提过，AWT没提供能够直接显示图像的控件，这无疑是个令人诟病的短板，因为一上来就得由程序员自己去定义新控件，对于初学者来讲很不友好。这个问题在Swing中也解决掉了，不过Swing并未提供单独的图像视图，而是利用标签控件JLabel来显示图像。JLabel的setText方法用来设置标签上的文本，而setIcon方法用来设置标签上的图标，根据两个方法的调用与否状况，标签所展示的内容可分为下列三种情况：  
1、只调用setText方法，未调用setIcon方法，此时标签只显示文本。  
2、只调用setIcon方法，未调用setText方法，此时标签只显示图像。  
3、既调用setText方法，又调用setIcon方法，此时标签同时显示文本和图像，且图像在左边、文本在右边，即左图右文。  
然而setIcon方法的输入参数却是Icon图标类型，并非早前介绍的缓存图像BufferedImage，这意味着需要把缓存图像转换为图标类型。其中的转换过程用到了图像图标工具ImageIcon，由于该工具实现了Icon接口，因此它的实例可以作为setIcon方法的输入参数。通过ImageIcon的构造方法，就能把缓存图像转为图标对象，具体的转换代码如下所示：

// 把图片文件读到缓存图像
    BufferedImage image = ImageIO.read(new File("E:/apple.png"));
    ImageIcon icon = new ImageIcon(image); // 创建一个图标

当然，ImageIcon本身是个图标工具，读取图片文件何必要经过缓存图像倒腾两手呢？直接去指定的文件路径读取便是。于是依据图片文件创建图标对象的代码变成了下面这样：

ImageIcon icon = new ImageIcon("E:/apple.png"); // 创建一个指定路径的图标

可是构造方法传入字符串算什么意思？难道字符串一定是文件路径吗？显然传入字符串的方式并不严谨。更好的做法是传入一个URL地址对象，明明白白地告诉编译器，构造方法的输入参数必须是个合法的文件地址，就像以下代码表达的那样：

ImageIcon icon = new ImageIcon(new URL("file:///E:/apple.png")); // 创建一个指定URL的图标

注意到构建URL对象的时候，文件路径字符串添加了前缀“file:///”，表示该串为本地的文件路径。除了本地文件，URL对象还能用来表达网络文件，只需将网络文件的完整http地址传进去即可，此时根据网络图片创建图标对象的代码示例如下：

ImageIcon icon = new ImageIcon(new URL("https://profile.csdnimg.cn/C/1/5/1_aqi00")); // 创建一个来自网络图片的图标

上述的几种构造方法，都能用来创建图标对象。获取到图标对象之后，就能调用setIcon方法在标签控件显示图像，还能调用setIconTextGap方法设置图标与文字之间的空白距离。  
接下来分别看看在标签上显示图像与文本的组合结果，首先，只显示图像不显示文本，则标签控件的方法调用代码示例如下：

ImageIcon icon = new ImageIcon("E:/apple.png"); // 创建一个指定路径的图标
    label.setIcon(icon); // 设置标签的图标
    label.setText(null); // 设置标签的文本为空，此时不显示文本

运行以上的测试代码，弹出的窗口界面如下图所示，可见标签上的图像居中展示。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpbmxhbnR1_size_16_color_FFFFFF_t_70]  
其次，准备同时显示图像与文本，则标签控件的setIcon方法和setText方法均应指定非空对象，此时调用代码如下所示：

ImageIcon icon = new ImageIcon("E:/apple.png"); // 创建一个指定路径的图标
    label.setIcon(icon); // 设置标签的图标（图标在文字左边）
    label.setIconTextGap(10); // 设置图标与文字之间的间隔大小
    label.setText("这是一个苹果"); // 设置标签的文本

运行以上的测试代码，弹出的窗口界面如下图所示，可见图像和文本都显示了出来。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpbmxhbnR1_size_16_color_FFFFFF_t_70 1]  
再次，不显示图像只显示文本，则标签控件的调用代码如下所示：

label.setIcon(null); // 设置标签的图标为空，此时不显示图像
    label.setText("这是一个苹果"); // 设置标签的文本

运行以上的测试代码，弹出的窗口界面如下图所示，可见JLabel控件变为常规的文本标签了。  
![在这里插入图片描述][20190722213606493.png]

更多Java技术文章参见《[Java开发笔记（序）章节目录][Java]》

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpbmxhbnR1_size_16_color_FFFFFF_t_70]: /images/20211129/1dd2682fb4314fe58b329aa29c464acd.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3BpbmxhbnR1_size_16_color_FFFFFF_t_70 1]: /images/20211129/0fad973e5b754f90b0b4ea1a5569bf41.png
[20190722213606493.png]: /images/20211129/aa47cd2e23b445e78cb13f945b655e97.png
[Java]: https://blog.csdn.net/pinlantu/article/details/83957672