JavaFX透明窗口事件穿透问题：如何实现带阴影的圆角自定义窗口

问题背景 #

要创建无系统元素、带圆角和阴影的JavaFX自定义窗口，当前实现：

• 主Stage设为StageStyle.TRANSPARENT，主Scene填充色为Color.TRANSPARENT
• 用StackPane（support-pane）作为外层容器，设置12px内边距且背景透明，内层GridPane（main-pane）设置红色背景、7px圆角和阴影，样式代码如下：

#support-pane { /* StackPane */
    -fx-padding: 12px;
    -fx-background-color: transparent
}

#main-pane { /* GridPane */
    -fx-background-color: red;
    -fx-background-radius: 7px;
    -fx-effect: dropshadow(three-pass-box, rgba(0, 0, 0, 0.4), 10, 0, 3, 3);
}

外层StackPane用于给阴影预留空间，但透明区域会被识别为窗口的一部分，点击该区域会让窗口获取焦点，需要实现透明区域点击穿透，或找到更合理的实现方案。

解决方法 #

方法一：实现透明区域点击穿透 #

给外层StackPane添加事件过滤器，判断点击位置是否落在内层GridPane范围内，若不在则让事件穿透窗口：

StackPane supportPane = (StackPane) scene.lookup("#support-pane");
GridPane mainPane = (GridPane) scene.lookup("#main-pane");

supportPane.addEventFilter(MouseEvent.ANY, event -> {
    Point2D localPoint = mainPane.sceneToLocal(event.getSceneX(), event.getSceneY());
    if (!mainPane.getBoundsInLocal().contains(localPoint)) {
        event.consume();
        // 调用内部API将焦点转移到窗口下方的元素，实现点击穿透
        com.sun.javafx.tk.Toolkit.getToolkit().getPrimaryFocusOwner().requestFocus();
    }
});

注意：com.sun.javafx属于内部API，不同JavaFX版本可能存在兼容性问题，若追求稳定性优先选方法二。

方法二：直接通过主容器实现（推荐） #

从JavaFX 17开始，无需外层透明容器，直接给主容器设置圆角和阴影，调整Stage大小适配容器即可：

1. 保留StageStyle.TRANSPARENT和Scene透明设置
2. 把GridPane作为Scene的根节点，设置内边距、圆角和阴影
3. 调用stage.sizeToScene()让Stage适配容器（包括阴影范围）

示例代码：

GridPane mainPane = new GridPane();
mainPane.setId("main-pane");
mainPane.setPadding(new Insets(12));

Scene scene = new Scene(mainPane, 400, 300);
scene.setFill(Color.TRANSPARENT);

Stage stage = new Stage();
stage.initStyle(StageStyle.TRANSPARENT);
stage.setScene(scene);
stage.sizeToScene();
stage.show();

对应的简化CSS：

#main-pane {
    -fx-background-color: red;
    -fx-background-radius: 7px;
    -fx-effect: dropshadow(three-pass-box, rgba(0, 0, 0, 0.4), 10, 0, 3, 3);
}

这种方式没有多余的透明容器，自然不会出现透明区域响应事件的问题，是更简洁稳定的实现方案。

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