不使用JLayeredPane实现JComponent拖拽时保持底层层级的问题咨询

JPanel本身继承自Container类，原生支持Z序调整能力，不需要依赖JLayeredPane即可实现moveToBack的等价效果。 #

核心问题说明 #

你当前代码无法生效的核心原因有两个：

1. Z序规则搞反：setComponentZOrder(组件, 索引)的索引值越大，组件层级越低，索引为0代表最上层，索引等于容器内组件总数-1代表最底层。你之前设置bottomZOrder = 0反而会把背景组件放到最上层。
2. Swing默认存在点击组件自动置前逻辑：只要组件获得焦点/被点击，就会自动调整到最上层，这个默认行为需要手动覆盖。

实现方案 #

方案1：拖拽过程中强制固定Z序（最稳妥） #

每次拖拽更新位置后，立刻把背景组件设置到最底层即可，修改后的示例代码如下：

import java.awt.Component;
import java.awt.Container;
import java.awt.event.MouseEvent;
import java.awt.event.MouseListener;
import java.awt.event.MouseMotionListener;
import javax.swing.JButton;
import javax.swing.JFrame;

public class OverlapTester extends JFrame {
    public static final long serialVersionUID = 172L;

    public static void main(String[] args) {
        OverlapTester frame = new OverlapTester();
        frame.initialize();
    }

    public void initialize() {
        setLayout(null);
        
        JButton bottom = new JButton("bottom");
        JButton top = new JButton("top");
        bottom.setBounds(0,0,100,100);
        top.setBounds(0,0,50,50);
        
        // 先加底层组件，再加上层组件，初始层级符合预期
        add(bottom);
        add(top);
        
        // 记录拖拽时的坐标偏移
        int[] pressOffset = new int[2];
        bottom.addMouseListener(new MouseListener(){
            @Override
            public void mousePressed(MouseEvent e) {
                pressOffset[0] = e.getX();
                pressOffset[1] = e.getY();
                fixToBottom(e.getComponent());
            }
            @Override public void mouseClicked(MouseEvent e) {fixToBottom(e.getComponent());}
            @Override public void mouseReleased(MouseEvent e) {fixToBottom(e.getComponent());}
            @Override public void mouseEntered(MouseEvent e) {fixToBottom(e.getComponent());}
            @Override public void mouseExited(MouseEvent e) {fixToBottom(e.getComponent());}
        });
        
        bottom.addMouseMotionListener(new MouseMotionListener(){
            @Override
            public void mouseDragged(MouseEvent e) {
                JButton source = (JButton) e.getComponent();
                // 更新组件位置
                source.setLocation(
                    source.getX() + e.getX() - pressOffset[0],
                    source.getY() + e.getY() - pressOffset[1]
                );
                // 位置更新后立刻固定到底层
                fixToBottom(source);
            }
            @Override public void mouseMoved(MouseEvent e) {}
        });
        
        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        setExtendedState(MAXIMIZED_BOTH);
        setVisible(true);
    }
    
    // 把指定组件固定到父容器最底层
    private void fixToBottom(Component comp) {
        Container parent = comp.getParent();
        parent.setComponentZOrder(comp, parent.getComponentCount() - 1);
    }
}

方案2：禁止背景组件获得焦点（轻量适配） #

如果不想每个事件都调整Z序，可以直接给背景组件设置禁用焦点，大部分场景下也能阻止默认的自动置前行为：

bottom.setFocusable(false);
bottom.setRequestFocusEnabled(false);

两种方案可以结合使用，稳定性更高。

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