Java Swing中GridBagLayout下JCheckBox与JLabel垂直对齐问题

要精准调整JCheckBox的复选框（图标）和文本的垂直偏移，核心是自定义UI来控制组件内部的绘制位置，以下是具体实现方案：

自定义CheckBoxUI实现精准偏移 #

通过重写BasicCheckBoxUI的paint方法，分别调整图标和文本的绘制Y坐标，实现独立偏移：

import javax.swing.*;
import javax.swing.plaf.basic.BasicCheckBoxUI;
import java.awt.*;

public class OffsetCheckBoxUI extends BasicCheckBoxUI {
    private final int iconYOffset; // 复选框图标垂直偏移量
    private final int textYOffset; // 文本垂直偏移量

    public OffsetCheckBoxUI(int iconYOffset, int textYOffset) {
        this.iconYOffset = iconYOffset;
        this.textYOffset = textYOffset;
    }

    @Override
    public void paint(Graphics g, JComponent c) {
        AbstractButton checkBox = (AbstractButton) c;
        Insets insets = checkBox.getInsets();
        Icon icon = checkBox.getIcon();

        // 绘制偏移后的复选框图标
        if (icon != null) {
            int iconX = insets.left;
            int iconY = insets.top + iconYOffset;
            icon.paintIcon(c, g, iconX, iconY);
        }

        // 绘制偏移后的文本
        String text = checkBox.getText();
        if (text != null && !text.isBlank()) {
            FontMetrics fm = g.getFontMetrics();
            int textX = insets.left;
            if (icon != null) {
                textX += icon.getIconWidth() + checkBox.getIconTextGap();
            }
            // 文本绘制的Y坐标基于字体基线，加上偏移量
            int textY = insets.top + fm.getAscent() + textYOffset;
            g.drawString(text, textX, textY);
        }

        // 保留焦点框绘制（如果组件需要焦点样式）
        if (checkBox.hasFocus() && checkBox.isFocusPainted()) {
            Icon defaultIcon = getDefaultIcon();
            paintFocus(g, checkBox, defaultIcon.getIconWidth(), defaultIcon.getIconHeight(), 0, 0);
        }
    }
}

使用方式 #

在创建JCheckBox时，直接设置自定义UI即可：

// 创建复选框，设置自定义UI：复选框下移2像素，文本下移4像素
JCheckBox checkBox = new JCheckBox("示例选项");
checkBox.setUI(new OffsetCheckBoxUI(2, 4));

// 配合GridBagLayout使用时，保持原有的GridBagConstraints配置即可
GridBagConstraints gbc = new GridBagConstraints();
gbc.gridx = 0;
gbc.gridy = 0;
gbc.anchor = GridBagConstraints.BASELINE; // 保持基线对齐
container.add(checkBox, gbc);

// 对应的JLabel保持原有配置，即可实现对齐
JLabel label = new JLabel("对比文本");
gbc.gridx = 1;
container.add(label, gbc);

注意事项 #

• 自定义UI会覆盖系统默认的外观样式，如果需要适配不同LookAndFeel，可根据当前UI类型做兼容处理。
• 若只需要整体偏移（图标和文本同步下移），可简化使用空边框：checkBox.setBorder(BorderFactory.createEmptyBorder(2, 0, 0, 0));，但无法实现图标和文本的独立偏移。

内容的提问来源于stack exchange，提问作者Edward Eddy67716