在 JavaFX27+ 环境中使用原生窗口装饰

[Glavo]

No description provided.

[Glavo]

发现一个问题。启用系统原生装饰后窗口本身会变成白底，导致我们无法给窗口裁切圆角。我想想有什么解决办法吗。

[3gf8jv4dv]

Windows 11 感觉良好

[3gf8jv4dv]

默认窗口大小可能要增大点，否则……

[3gf8jv4dv]

系统深色模式、启动器深色模式，打开启动器会闪过一瞬白窗口。能否实现黑窗口呢？

[Glavo]

系统深色模式、启动器深色模式，打开启动器会闪过一瞬白窗口。能否实现黑窗口呢？

看起来用户代码无法控制这个行为。

[Glavo]

系统深色模式、启动器深色模式，打开启动器会闪过一瞬白窗口。能否实现黑窗口呢？

openjdk/jfx#2316

[fishdry1000]

这个pr顺带解决了能把窗口拖到任务栏下面然后拿不回来的问题

[ToobLac]

openjdk/jfx#2316

那岂不是要等到 JFX 28 才行

[ToobLac]

2026-09-20.21.17.47.mov

环境：macOS 26.6.2

目前来看这个功能还是很不完善

[3gf8jv4dv]

我觉得在 Windows 11 上是一个质的改变。

不过……有做成选项的可能吗？

[ToobLac]

我觉得在 Windows 11 上是一个质的改变。

具体体现在什么地方呢？我手头没设备体验不了

不过……有做成选项的可能吗？

这个应该还是比较好实现的

[3gf8jv4dv]

具体体现在什么地方呢？我手头没设备体验不了

1. 我比较中意 Windows 11 的窗口风格和阴影效果。之前的窗口风格和阴影与 Windows 11 格格不入，现在和原生窗口一样的圆角和阴影看着很舒服。
2. 之前的阴影是自绘的，截图不便，现在方便多了。可以参考我上面发的截图，和我以前发的截图进行比对。
3. 之前的窗口动画是 Glavo 自己弄出来的，同样与 Windows 11 格格不入，甚至有一些怪癖。现在和原生窗口一致了。
4. 如 fishdry1000 上面所述，解决了一些怪癖。
5. 在原生窗口实现上，最大化/全屏功能得到了完善。双击标题栏最大化/还原，和原生窗口完全一致。印象中，之前应该有一些零散的对最大化/全屏功能的 吐槽 反馈。
   ……

总的来说，对 Windows 11 用户来说应该是个值得分享的事。

[3gf8jv4dv]

Uhm，遗憾的是有一个和旧窗口不一样的行为。

app 内出现一个对话框时

• 旧窗口可以拖曳窗口内、对话框以外的任何区域拖动窗口
• 原生窗口无法拖动窗口

[fishdry1000]

当前的行为只会在手动使用 JFX27+ 环境中出现。希望能在第一次打开 HMCL 时自动下载 JFX 时就下载 JFX27，使用旧版本 JFX 时主动提示升级，因为正如 3gf8jv4dv 所说，使用原生窗口装饰在 Windows 上的体检提升明显。

[fishdry1000]

找到很多这个 pr 能够解决或者相关的 issue ，做在这里一个汇总

已测试：

• [Bug] 在Win11 Pro 25H2下HMCL从任务栏中唤起时动画不正常 #6882 （缺少动画问题）
• HMCL窗口最小化错误 #4073
• 在 Windows 11 的部分场景下，窗口在拖动后立即进行双击最大化操作，可能导致最大化后窗口位置异常 #5189
• [Feature] 优化HMCL脱离可控制视窗的应对措施 #5891
• [Feature] 添加截图功能 #4924 （多余阴影）
• [Feature] #6433

未测试：

• [Bug] debian13 kde wayland拖动显示错误 #6189
• [Bug] HMCL因未知问题飞到屏幕外无法拉回屏幕内 #5492
• [Bug] HMCL最小化任务栏后无法在通过任何方式在打开 #5483

[Glavo]

不过……有做成选项的可能吗？

可能会引入一个环境变量来控制行为。

我计划默认情况下 HMCL 会探测当前环境是否满足一个保守的条件（系统为 Windows 或 macOS，对于 Windows 平台必须是浅色模式），此时才会启用原生窗口装饰。通过环境变量可以跳过这个检测，强制启用/禁止使用原生窗口装饰（当然必须满足 JavaFX 27+ 且关闭窗口透明这个硬性条件）。

Linux 平台看起来难以控制原生的窗口裁切，使用原生窗口装饰的话很难绘制圆角，所以默认不会启用这项功能。

[3gf8jv4dv]

对于 Windows 平台必须是浅色模式

这个条件没必要吧，如果是窗口闪白还在接受范围内