MacOS下Java透明像素点击穿透功能失效问题求助

在MacOS系统中，用Java Swing创建的透明覆盖层窗口（比如示例里的JWindow），哪怕窗口背景完全透明，点击透明区域时还是会挡住鼠标，没法和下方窗口交互，Windows系统则没有这个问题。复现问题的最小示例代码如下：

package overlayTest;
import javax.swing.*;
import java.awt.*;
public class OverlayWindowJava {
    public static void main(String[] args) {JWindow jw=new JWindow();
      JPanel jp=new JPanel() {
            @Override
              public void paint(Graphics g) {
              Graphics2D g2=(Graphics2D)g;
              g2.fillOval(40, 40, 20, 20);
            }
          };
          jw.setBackground(new Color(0, 0, 0, 0));
          jp.setBackground(new Color(0, 0, 0, 0));
          jw.setAlwaysOnTop(true);
          jw.setLocation(0, 0);
          jp.setOpaque(false);
          jp.setPreferredSize(Toolkit.getDefaultToolkit().getScreenSize());
          jw.setContentPane(jp);
          jw.getRootPane().putClientProperty("apply.awt.draggableWindowBackground", false);
          jw.pack();
                  //Since this issue involves the window "blocking" the mouse the program will terminate automatically after 10s as a safety mechanism
          new java.util.Timer().schedule(new java.util.TimerTask(){public void run(){System.exit(0);}},10000);
          jw.setVisible(true);
    }
}

解决方案 #

MacOS下要实现透明窗口的鼠标穿透，得用Apple提供的AWT私有API设置窗口属性，同时给窗口设置形状，限定只有绘制内容的区域能接收鼠标事件。修改后的代码如下：

package overlayTest;
import javax.swing.*;
import java.awt.*;
import java.awt.geom.Ellipse2D;

public class OverlayWindowJava {
    public static void main(String[] args) {
        JWindow jw = new JWindow();
        JPanel jp = new JPanel() {
            @Override
            public void paint(Graphics g) {
                Graphics2D g2 = (Graphics2D) g;
                g2.fillOval(40, 40, 20, 20);
            }
        };

        jw.setBackground(new Color(0, 0, 0, 0));
        jp.setBackground(new Color(0, 0, 0, 0));
        jw.setAlwaysOnTop(true);
        jw.setLocation(0, 0);
        jp.setOpaque(false);
        jp.setPreferredSize(Toolkit.getDefaultToolkit().getScreenSize());
        jw.setContentPane(jp);
        
        // MacOS专属设置：开启鼠标穿透
        if (System.getProperty("os.name").toLowerCase().contains("mac")) {
            try {
                // 调用Apple私有API，让窗口无法获得焦点
                Class<?> utilClass = Class.forName("com.apple.eawt.Application");
                Object application = utilClass.getMethod("getApplication").invoke(null);
                utilClass.getMethod("setWindowCanBecomeKey", Window.class, boolean.class)
                        .invoke(application, jw, false);
                
                // 设置窗口形状，只有椭圆区域能接收鼠标事件
                jw.setShape(new Ellipse2D.Double(40, 40, 20, 20));
            } catch (Exception e) {
                e.printStackTrace();
            }
        }

        jw.getRootPane().putClientProperty("apply.awt.draggableWindowBackground", false);
        jw.pack();
        
        // 10秒后自动退出的安全机制
        new java.util.Timer().schedule(new java.util.TimerTask(){
            public void run(){
                System.exit(0);
            }
        },10000);
        
        jw.setVisible(true);
    }
}

关键说明 #

• Apple私有API调用：通过com.apple.eawt.Application的setWindowCanBecomeKey方法，把窗口设为无法获取焦点，这样透明区域的鼠标事件会被系统跳过，直接传递给下方窗口。
• 窗口形状限制：用setShape定义窗口的有效交互范围，只有绘制的椭圆区域会响应点击，其他透明区域完全穿透。
• 跨系统兼容：通过系统属性判断是否为MacOS，避免在其他系统执行无效代码。

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