如何使用JavaFX精准捕获应用程序窗口完整截图？

问题出在你获取的Window坐标和尺寸包含了操作系统的窗口边框（标题栏、侧边栏等），而Robot.getScreenCapture()会按照你传入的矩形区域完整截取屏幕，所以才会出现截图范围偏大、坐标偏移的情况。

解决思路 #

JavaFX的Window类提供了getInsets()方法，能获取窗口边框的上下左右边距。我们只需要用整个窗口的坐标和尺寸减去这些边距，就能得到Scene内容区域的精准位置和大小。

修正后的代码 #

Scene scene = primaryStage.getScene();
Window appWindow = scene.getWindow();

// 必须确保窗口已显示，否则Insets可能返回全0的无效值
if (!appWindow.isShowing()) {
    appWindow.show();
}

// 获取窗口边框的边距
Insets insets = appWindow.getInsets();
// 计算内容区域的真实坐标和尺寸
double contentStartX = appWindow.getX() + insets.getLeft();
double contentStartY = appWindow.getY() + insets.getTop();
double contentWidth = appWindow.getWidth() - insets.getLeft() - insets.getRight();
double contentHeight = appWindow.getHeight() - insets.getTop() - insets.getBottom();

Rectangle2D contentRect = new Rectangle2D(contentStartX, contentStartY, contentWidth, contentHeight);

Robot robot = new Robot();
WritableImage image = robot.getScreenCapture(null, contentRect, true);

注意事项 #

• 窗口显示状态：一定要在窗口显示（show()调用后）再获取Insets，否则系统还未渲染窗口边框，会返回全0的边距值，导致计算无效。
• 兼容性：该方法兼容窗口最大化、全屏等状态，此时Insets会自动返回0，不会影响截图范围。
• 坐标精度：Window的坐标和尺寸是double类型，Rectangle2D会自动处理为屏幕像素对应的整数区域，无需手动转换。

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