Java Swing中JTabbedPane切换标签位置变动的解决方法

问题描述 #

JTabbedPane包含3个标签，选中任意标签时，该标签会自动移至首位，导致所有标签位置变动：

点击前：
点击Store标签后：

尝试查找解决方案但未找到相关案例，现需实现标签位置固定的效果。

补充代码 #

发现设置系统外观的代码会触发该问题，原本使用这段代码是为了让JFileChooser接近Windows样式：

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

public class Main {
    public static void main(String[] args) {
        
        try {
            UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName());
        } catch (UnsupportedLookAndFeelException | ClassNotFoundException | InstantiationException |
                 IllegalAccessException e) {
            throw new RuntimeException(e);
        }

        JFrame frame = new JFrame("Somest");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(200, 200);
        frame.setLocationRelativeTo(null);
        frame.setVisible(true);

        JPanel UpperPanel = new JPanel(new FlowLayout(FlowLayout.LEFT));
        JTabbedPane tabbedPane = new JTabbedPane(JTabbedPane.RIGHT, JTabbedPane.WRAP_TAB_LAYOUT);
        tabbedPane.addTab("Calculation", new JLabel());
        tabbedPane.addTab("Store", new JLabel());
        tabbedPane.addTab("Settings", new JLabel());
        UpperPanel.add(tabbedPane);
        frame.add(UpperPanel);
    }
}

问题原因 #

设置Windows系统外观后，JTabbedPane的默认交互逻辑被修改，开启了选中标签自动移至首位的特性，这是Windows风格下的默认行为。

解决方法 #

方案1：修改UIManager属性禁用重排 #

在设置系统外观后，添加一行代码关闭自动重排特性，这是最简单高效的方法：

UIManager.put("TabbedPane.selectedTabShifted", Boolean.FALSE);

修改后的完整代码：

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

public class Main {
    public static void main(String[] args) {
        
        try {
            UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName());
            // 禁用选中标签移至首位的行为
            UIManager.put("TabbedPane.selectedTabShifted", Boolean.FALSE);
        } catch (UnsupportedLookAndFeelException | ClassNotFoundException | InstantiationException |
                 IllegalAccessException e) {
            throw new RuntimeException(e);
        }

        JFrame frame = new JFrame("Somest");
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.setSize(200, 200);
        frame.setLocationRelativeTo(null);

        JPanel UpperPanel = new JPanel(new FlowLayout(FlowLayout.LEFT));
        JTabbedPane tabbedPane = new JTabbedPane(JTabbedPane.RIGHT, JTabbedPane.WRAP_TAB_LAYOUT);
        tabbedPane.addTab("Calculation", new JLabel());
        tabbedPane.addTab("Store", new JLabel());
        tabbedPane.addTab("Settings", new JLabel());
        UpperPanel.add(tabbedPane);
        frame.add(UpperPanel);

        frame.setVisible(true); // 建议将此方法放在所有组件添加完成后，避免布局异常
    }
}

方案2：自定义TabbedPaneUI（备选） #

如果方案1不生效，可以自定义WindowsTabbedPaneUI，覆盖标签选中时的处理逻辑，避免标签位置变动。示例代码如下：

class FixedTabbedPaneUI extends WindowsTabbedPaneUI {
    @Override
    protected void tabSelected(int index) {
        // 仅切换选中状态，不调整标签位置
        super.tabSelected(index);
        // 重置标签布局，保持原有顺序
        tabPane.invalidate();
        tabPane.validate();
    }
}

使用时设置给JTabbedPane：

tabbedPane.setUI(new FixedTabbedPaneUI());

此方法相对复杂，建议优先使用方案1。

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