JDK-8241676 : Release Note: Deprecated NSWindowStyleMaskTexturedBackground
  • Type: Sub-task
  • Component: client-libs
  • Sub-Component: javax.swing
  • Affected Version: 8u261,11.0.8-oracle,12
  • Priority: P4
  • Status: Closed
  • Resolution: Delivered
  • Submitted: 2020-03-26
  • Updated: 2025-08-19
  • Resolved: 2021-12-02
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 11 JDK 12 JDK 8
11.0.8-oracleResolved 12Resolved 8u261Resolved
Related Reports
Relates :  
JDK-8211301 - [macos] support full window content options
Description
After an upgrade of the macOS SDK used to build the JDK, the behavior of the `apple.awt.brushMetalLook` and `textured` Swing properties has changed. When these properties are set, the title of the frame is still visible.
It is recommended that the `apple.awt.transparentTitleBar` property be set to `true` to make the title of the frame invisible again. The `apple.awt.fullWindowContent` property can also be used.

Please note that `Textured window` support was implemented by using the `NSTexturedBackgroundWindowMask` value of `NSWindowStyleMask`. However, this was deprecated in macOS 10.12 along with `NSWindowStyleMaskTexturedBackground`, which was deprecated in macOS 10.14. 

For additional information, refer to the following documentation:
 - `apple.awt.brushMetalLook`:  https://developer.apple.com/documentation/appkit/nstexturedbackgroundwindowmask?language=objc
 - `apple.awt.transparentTitleBar`: https://developer.apple.com/documentation/appkit/nswindow/1419167-titlebarappearstransparent?language=objc
 - `apple.awt.fullWindowContent`: https://developer.apple.com/documentation/appkit/nsfullsizecontentviewwindowmask