JavaSwing_2.5: JToggleButton（开关按钮）

不念不忘少年蓝@ 2021-09-22 07:00 437阅读 0赞

本文链接: [http://blog.csdn.net/xietansheng/article/details/74363501][http_blog.csdn.net_xietansheng_article_details_74363501]

[Java Swing 图形界面开发（目录）][Java Swing]

## 1. 概述 ##

官方JavaDocsApi: [javax.swing.JToggleButton][]

`JToggleButton`，开关按钮。JToggleButton 是 JRadioButton, JCheckBox 的父类，主要实现一个按钮的两种状态（选中 和 未选中）来实现开关切换的效果。

**JToggleButton 常用构造方法**:

// 无文本，默认未选中
    JToggleButton()
    
    // 有文本，默认未选中
    JToggleButton(String text)
    
    // 有文本，并指定是否选中
    JToggleButton(String text, boolean selected)

**JToggleButton 常用方法**:

// 设置开关按钮的 文本、字体 和 字体颜色
    void setText(String text)
    void setFont(Font font)
    void setForeground(Color fg)
    
    /* 以下方法定义在 javax.swing.AbstractButton 基类中 */
    
    // 设置开关按钮是否选中状态
    void setSelected(boolean b)
    
    // 判断开关按钮是否选中
    boolean isSelected()
    
    // 设置开关按钮是否可用
    void setEnabled(boolean enable)
    
    // 设置开关按钮在 默认(关)、被选中(开)、不可用 时显示的图片
    void setIcon(Icon defaultIcon)
    void setPressedIcon(Icon pressedIcon)
    void setDisabledIcon(Icon disabledIcon)
    
    // 设置图片和文本之间的间距
    void setIconTextGap(int iconTextGap)

**JToggleButton 常用监听器**:

// 添加状态改变监听器
    void addChangeListener(ChangeListener l)

## 2. 代码实例: 默认的开关按钮 ##

package com.xiets.swing;
    
    import javax.swing.*;
    import javax.swing.event.ChangeEvent;
    import javax.swing.event.ChangeListener;
    
    public class Main { 
    
        public static void main(String[] args) { 
            JFrame jf = new JFrame("测试窗口");
            jf.setSize(250, 250);
            jf.setLocationRelativeTo(null);
            jf.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
    
            JPanel panel = new JPanel();
    
            // 创建开关按钮
            JToggleButton toggleBtn = new JToggleButton("开关按钮");
    
            // 添加 toggleBtn 的状态被改变的监听
            toggleBtn.addChangeListener(new ChangeListener() { 
                @Override
                public void stateChanged(ChangeEvent e) { 
                    // 获取事件源（即开关按钮本身）
                    JToggleButton toggleBtn = (JToggleButton) e.getSource();
                    System.out.println(toggleBtn.getText() + " 是否选中: " + toggleBtn.isSelected());
                }
            });
    
            panel.add(toggleBtn);
    
            jf.setContentPane(panel);
            jf.setVisible(true);
        }
    
    }

结果展示:

![result\_01.gif][result_01.gif]

运行代码，点击开关按钮，查看控制台输出。

## 3. 代码实例: 自定义图片开关 ##

使用下面两个图片分别代表开关按钮的 选中(开) 和 未选中(关) 状态，分别命名为: **toggle\_on.png**，**toggle\_off.png**:

![toggle\_on.png][toggle_on.png]

![toggle\_off.png][toggle_off.png]

package com.xiets.swing;
    
    import javax.swing.*;
    import javax.swing.event.ChangeEvent;
    import javax.swing.event.ChangeListener;
    
    public class Main { 
    
        public static void main(String[] args) { 
            JFrame jf = new JFrame("测试窗口");
            jf.setSize(250, 250);
            jf.setLocationRelativeTo(null);
            jf.setDefaultCloseOperation(WindowConstants.EXIT_ON_CLOSE);
    
            JPanel panel = new JPanel();
    
            // 创建开关按钮
            JToggleButton toggleBtn = new JToggleButton();
    
            // 首先设置不绘制按钮边框
            toggleBtn.setBorderPainted(false);
    
            // 设置 选中(开) 和 未选中(关) 时显示的图片
            toggleBtn.setSelectedIcon(new ImageIcon("toggle_on.png"));
            toggleBtn.setIcon(new ImageIcon("toggle_off.png"));
    
            // 添加 toggleBtn 的状态被改变的监听
            toggleBtn.addChangeListener(new ChangeListener() { 
                @Override
                public void stateChanged(ChangeEvent e) { 
                    // 获取事件源（即开关按钮本身）
                    JToggleButton toggleBtn = (JToggleButton) e.getSource();
                    System.out.println(toggleBtn.getText() + " 是否选中: " + toggleBtn.isSelected());
                }
            });
    
            panel.add(toggleBtn);
    
            jf.setContentPane(panel);
            jf.setVisible(true);
        }
    
    }

结果展示:

![result\_02.gif][result_02.gif]

运行代码，点击开关按钮，查看控制台输出。

--------------------

![18975746.asp][]

[http_blog.csdn.net_xietansheng_article_details_74363501]: http://blog.csdn.net/xietansheng/article/details/74363501
[Java Swing]: http://blog.csdn.net/xietansheng/article/details/72814492
[javax.swing.JToggleButton]: https://docs.oracle.com/javase/8/docs/api/javax/swing/JToggleButton.html
[result_01.gif]: /images/20210920/60fdc293c2684296a776bd75a513a1b4.png
[toggle_on.png]: /images/20210920/4fe569444ae8426b87a1040ed30f651d.png
[toggle_off.png]: /images/20210920/fa348653cf7b47349a5e372e5487fd7b.png
[result_02.gif]: /images/20210920/0a5d8f7a075f4e459c2369992e08b506.png
[18975746.asp]: http://img.users.51.la/18975746.asp