首页 > 软件编程 > java > Java Swing自定义复选框

Java Swing自定义复选框CusCheckBox组件(附源码)

2026-05-27 08:35:05 作者：RainCity

Swing 原生 JCheckBox 的复选框图标是系统默认样式,不同操作系统下风格不一致,且无法自定义圆角、颜色、悬停效果等, 下面我们就用Java Swing实现自定义的复选框组件吧

一、背景

Swing 原生 JCheckBox 的复选框图标是系统默认样式，不同操作系统下风格不一致，且无法自定义圆角、颜色、悬停效果等。要实现统一的复选框样式，需要自己绘制图标。CusCheckBox 通过实现 Icon 接口自定义复选框的绘制逻辑，支持圆角、自定义颜色、悬停效果、禁用状态等。

二、核心设计

CusCheckBox 由两个类组成：

CheckBoxIcon：实现 Icon 接口，负责绘制复选框图标（背景、边框、对勾/叉号）
CusCheckBox：继承 JCheckBox，使用 CheckBoxIcon 作为图标，提供丰富的样式设置方法

三、CheckBoxIcon 源码

import lombok.Setter;

import javax.swing.*;
import java.awt.*;

/**
 * 自定义 JCheckBox 图标类
 * 实现 Icon 接口，负责绘制复选框的图标部分
 *
 * 使用示例：
 * CheckBoxIcon icon = new CheckBoxIcon(20, Color.decode("#409EFF"), Color.WHITE);
 */
@Setter
public class CheckBoxIcon implements Icon {
    /** 复选框大小 */
    private int size;
    /** 圆角 */
    private boolean rounded = true;
    /** 圆角半径 */
    private int borderRadius = 8;
    /** 边框宽度 */
    private int borderThickness = 1;
    /** 边框颜色 */
    private Color borderColor = Color.GRAY;
    /** 选中背景颜色 */
    private Color selectedBg;
    /** 对勾颜色 */
    private Color checkColor;
    /** 悬停颜色 */
    private Color hoverColor;
    /** 禁用颜色 */
    private Color disabledColor = Color.decode("#E4E7ED");
    /** 对勾宽度 */
    private float checkThickness = 2.0f;
    /** 是否使用对勾（true=对勾，false=叉号） */
    private boolean useCheckMark = true;
    /** 是否启用 */
    private boolean enabled = true;

    /**
     * 构造函数
     * @param size 图标尺寸
     * @param selectedBg 选中时的背景色
     * @param checkColor 对勾颜色
     */
    public CheckBoxIcon(int size, Color selectedBg, Color checkColor) {
        this.size = Math.max(16, size);
        this.selectedBg = selectedBg;
        this.checkColor = checkColor;
    }

    @Override
    public void paintIcon(Component c, Graphics g, int x, int y) {
        AbstractButton button = (AbstractButton) c;
        ButtonModel model = button.getModel();
        Graphics2D g2 = (Graphics2D) g;
        // 启用抗锯齿
        g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
        // 获取状态
        boolean isSelected = model.isSelected();
        boolean isPressed = model.isPressed();
        boolean isRollover = model.isRollover();
        // 计算实际绘制区域
        int drawWidth = size - 1;
        int drawHeight = size - 1;
        // 根据状态选择颜色
        Color currentBorder = enabled ? borderColor : disabledColor;
        Color currentBg = Color.WHITE;
        if (isSelected) {
            currentBg = enabled ? selectedBg : disabledColor.brighter();
        }
        if (isRollover && !isPressed && enabled && null != hoverColor) {
            currentBg = hoverColor;
        }
        if (isPressed && enabled) {
            currentBg = selectedBg.darker();
        }
        if (!enabled) {
            currentBg = disabledColor;
        }
        // 绘制背景
        g2.setColor(currentBg);
        if (rounded) {
            g2.fillRoundRect(x, y, drawWidth, drawHeight, borderRadius, borderRadius);
        } else {
            g2.fillRect(x, y, drawWidth, drawHeight);
        }
        // 绘制边框
        g2.setColor(currentBorder);
        g2.setStroke(new BasicStroke(borderThickness));
        if (rounded) {
            g2.drawRoundRect(x, y, drawWidth, drawHeight, borderRadius, borderRadius);
        } else {
            g2.drawRect(x, y, drawWidth, drawHeight);
        }
        // 绘制选中标记
        if (isSelected) {
            drawCheckMark(g2, x, y, drawWidth, drawHeight);
        }
    }

    /**
     * 绘制选中标记（对勾或叉号）
     * @param g2 Graphics2D 对象
     * @param x 起始 X 坐标
     * @param y 起始 Y 坐标
     * @param width 绘制宽度
     * @param height 绘制高度
     */
    private void drawCheckMark(Graphics2D g2, int x, int y, int width, int height) {
        Color currentCheckColor = enabled ? checkColor : Color.DARK_GRAY;
        g2.setColor(currentCheckColor);
        g2.setStroke(new BasicStroke(checkThickness, BasicStroke.CAP_ROUND, BasicStroke.JOIN_ROUND));
        // 20% 内边距
        float padding = width * 0.2f;
        int startX = (int) (x + padding);
        int startY = y + height / 2;
        int midX = x + width / 2;
        int midY = (int) (y + height - padding);
        int endX = (int) (x + width - padding);
        int endY = (int) (y + padding);
        if (useCheckMark) {
            // 对勾
            g2.drawLine(startX, startY, midX, midY);
            g2.drawLine(midX, midY, endX, endY);
        } else {
            // 叉号
            g2.drawLine(startX, startY, endX, endY);
            g2.drawLine(startX, endY, endX, startY);
        }
    }

    @Override
    public int getIconWidth() {
        return size;
    }

    @Override
    public int getIconHeight() {
        return size;
    }

    /**
     * 设置图标尺寸
     * @param size 尺寸
     */
    public void setSize(int size) {
        this.size = Math.max(16, size);
    }
}

四、CusCheckBox 源码

import javax.swing.*;
import java.awt.*;

/**
 * 自定义复选框
 * 通过自定义 Icon 实现统一的复选框样式
 *
 * 使用示例：
 * CusCheckBox checkBox = new CusCheckBox("同意协议");
 * checkBox.setSelected(true);
 * checkBox.setHoverColor(Color.LIGHT_GRAY);
 */
public class CusCheckBox extends JCheckBox {
    /** 默认尺寸 */
    private static final int DEFAULT_SIZE = 20;
    /** 默认选中背景颜色 */
    private static final Color DEFAULT_BG = Color.decode("#409EFF");
    /** 默认选中对勾颜色 */
    private static final Color DEFAULT_CHECK = Color.WHITE;
    /** 内部图标实例 */
    private final CheckBoxIcon icon;

    /**
     * 默认构造函数
     * @param text 复选框文本
     */
    public CusCheckBox(String text) {
        this(text, DEFAULT_SIZE, DEFAULT_BG, DEFAULT_CHECK, false);
    }

    /**
     * 指定选中状态
     * @param text 复选框文本
     * @param selected 是否选中
     */
    public CusCheckBox(String text, boolean selected) {
        this(text, DEFAULT_SIZE, DEFAULT_BG, DEFAULT_CHECK, selected);
    }

    /**
     * 指定尺寸
     * @param text 复选框文本
     * @param size 图标尺寸
     */
    public CusCheckBox(String text, int size) {
        this(text, size, DEFAULT_BG, DEFAULT_CHECK, false);
    }

    /**
     * 指定尺寸和选中状态
     * @param text 复选框文本
     * @param size 图标尺寸
     * @param selected 是否选中
     */
    public CusCheckBox(String text, int size, boolean selected) {
        this(text, size, DEFAULT_BG, DEFAULT_CHECK, selected);
    }

    /**
     * 指定颜色
     * @param text 复选框文本
     * @param bg 选中时背景色
     * @param check 对勾颜色
     */
    public CusCheckBox(String text, Color bg, Color check) {
        this(text, DEFAULT_SIZE, bg, check, false);
    }

    /**
     * 指定颜色和选中状态
     * @param text 复选框文本
     * @param bg 选中时背景色
     * @param check 对勾颜色
     * @param selected 是否选中
     */
    public CusCheckBox(String text, Color bg, Color check, boolean selected) {
        this(text, DEFAULT_SIZE, bg, check, selected);
    }

    /**
     * 指定尺寸和颜色
     * @param text 复选框文本
     * @param size 图标尺寸
     * @param bg 选中时背景色
     * @param check 对勾颜色
     */
    public CusCheckBox(String text, int size, Color bg, Color check) {
        this(text, size, bg, check, false);
    }

    /**
     * 完整构造函数
     * @param text 复选框文本
     * @param size 图标尺寸
     * @param bg 选中时背景色
     * @param check 对勾颜色
     * @param selected 是否选中
     */
    public CusCheckBox(String text, int size, Color bg, Color check, boolean selected) {
        super(text);
        // 创建自定义图标
        this.icon = new CheckBoxIcon(size, bg, check);
        // 设置图标（选中和未选中共用同一个图标实例，通过状态区分绘制）
        this.setIcon(icon);
        this.setSelectedIcon(icon);
        // 设置选中状态
        this.setSelected(selected);
        // 设置文本颜色和字体
        this.setForeground(Color.BLACK);
        this.setFont(new Font("Microsoft YaHei", Font.PLAIN, 16));
        // 设置透明背景，让父容器背景显示
        this.setOpaque(false);
        // 禁用默认内容区域填充
        this.setContentAreaFilled(false);
        // 禁用边框绘制
        this.setBorderPainted(false);
        // 图标与文字间距
        this.setIconTextGap(10);
    }

    /**
     * 获取自定义图标
     * @return 图标对象
     */
    @Override
    public CheckBoxIcon getIcon() {
        return icon;
    }

    /**
     * 设置图标尺寸
     * @param size 尺寸
     */
    public void setIconSize(int size) {
        icon.setSize(size);
        revalidate();
        repaint();
    }

    /**
     * 设置选中时的背景色
     * @param color 颜色
     */
    public void setSelectedBackground(Color color) {
        icon.setSelectedBg(color);
        repaint();
    }

    /**
     * 设置对勾颜色
     * @param color 颜色
     */
    public void setCheckColor(Color color) {
        icon.setCheckColor(color);
        repaint();
    }

    /**
     * 设置边框颜色
     * @param color 颜色
     */
    public void setBorderColor(Color color) {
        icon.setBorderColor(color);
        repaint();
    }

    /**
     * 设置是否圆角
     * @param rounded 是否圆角
     */
    public void setRounded(boolean rounded) {
        icon.setRounded(rounded);
        repaint();
    }

    /**
     * 设置圆角半径
     * @param radius 半径
     */
    public void setBorderRadius(int radius) {
        icon.setRounded(true);
        icon.setBorderRadius(radius);
        repaint();
    }

    /**
     * 设置边框粗细
     * @param thickness 粗细
     */
    public void setBorderThickness(int thickness) {
        icon.setBorderThickness(thickness);
        repaint();
    }

    /**
     * 设置对勾线条粗细
     * @param thickness 粗细
     */
    public void setCheckThickness(float thickness) {
        icon.setCheckThickness(thickness);
        repaint();
    }

    /**
     * 设置使用对勾还是叉号
     * @param useCheckMark true=对勾，false=叉号
     */
    public void setUseCheckMark(boolean useCheckMark) {
        icon.setUseCheckMark(useCheckMark);
        repaint();
    }

    /**
     * 设置悬停时的背景色
     * @param color 颜色
     */
    public void setHoverColor(Color color) {
        icon.setHoverColor(color);
        repaint();
    }

    /**
     * 重写 setEnabled 以同步图标状态
     * @param enabled 是否启用
     */
    @Override
    public void setEnabled(boolean enabled) {
        super.setEnabled(enabled);
        if (icon != null) {
            icon.setEnabled(enabled);
            repaint();
        }
    }
}

五、核心功能说明

图标绘制（CheckBoxIcon）：

paintIcon：核心绘制方法，根据按钮状态（选中/悬停/按下/禁用）绘制不同样式
drawCheckMark：绘制对勾或叉号，支持线条粗细和颜色定制
支持圆角/直角、边框颜色/粗细、背景色、悬停色、禁用色等配置

复选框封装（CusCheckBox）：

使用 CheckBoxIcon 替换原生图标
提供多个构造函数简化使用（尺寸/颜色/选中状态组合）
提供样式设置方法（圆角、颜色、悬停、对勾样式等）
透明背景，便于融入父容器

六、使用示例

6.1 基本用法

CusCheckBox checkBox = new CusCheckBox("同意用户协议");
panel.add(checkBox);

6.2 指定选中状态

CusCheckBox checkBox = new CusCheckBox("记住密码", true);
panel.add(checkBox);

6.3 自定义颜色和尺寸

CusCheckBox checkBox = new CusCheckBox("自定义样式", 24, Color.decode("#67C23A"), Color.WHITE);
checkBox.setHoverColor(Color.decode("#E6F7E6"));
panel.add(checkBox);

6.4 圆角半径调整

CusCheckBox checkBox = new CusCheckBox("圆角复选框");
checkBox.setBorderRadius(12);
panel.add(checkBox);

6.5 使用叉号代替对勾

CusCheckBox checkBox = new CusCheckBox("拒绝");
checkBox.setUseCheckMark(false);
checkBox.setSelectedBackground(Color.decode("#F56C6C"));
panel.add(checkBox);

6.6 禁用状态

CusCheckBox checkBox = new CusCheckBox("不可选");
checkBox.setEnabled(false);
panel.add(checkBox);

6.7 监听选中事件

CusCheckBox checkBox = new CusCheckBox("接收通知");
checkBox.addItemListener(e -> {
    boolean selected = e.getStateChange() == ItemEvent.SELECTED;
    System.out.println("选中状态：" + selected);
});

七、注意事项

con 共用：选中和未选中共用同一个 CheckBoxIcon 实例，通过 ButtonModel.isSelected() 区分绘制状态
透明背景：setOpaque(false) 和 setContentAreaFilled(false) 确保背景不覆盖父容器
字体设置：代码中使用 Microsoft YaHei，非 Windows 系统需替换为 DejaVu Sans 或 Serif
颜色默认值：默认主题色为 #409EFF（Element UI 风格），可根据项目调整
图标尺寸：最小值限制为 16px，避免过小无法交互

八、小结

CusCheckBox 通过自定义 Icon 实现了样式统一的复选框组件。核心思路是：

实现 Icon 接口，重写 paintIcon 方法自绘图标
根据按钮状态（选中/悬停/禁用/按下）绘制不同样式
通过多个构造函数和 setter 方法提供灵活配置

这种实现方式可以推广到其他自定义组件（如单选框、开关等）。

以上就是Java Swing自定义复选框CusCheckBox组件(附源码)的详细内容，更多关于Java Swing自定义复选框的资料请关注脚本之家其它相关文章！