RFR: 8354478: Improve StageStyle documentation

[Andy Goryachev]

On Sun, 13 Apr 2025 15:24:43 GMT, Thiago Milczarek Sayao <tsayao at openjdk.org> wrote:

> Improve StageStyle Documentation
> 
> - Update `StageStyle.UTILITY`:
> Clarified that UTILITY stages may impose platform-specific restrictions on window states, such as preventing maximize, minimize (iconify), and fullscreen operations.
> 
> - Update `StageStyle.UNDECORATED`:
> Improved the description to clarify that although UNDECORATED removes standard window decorations (title bar, borders, and controls), window operations like minimize, maximize, and fullscreen may still be allowed programmatically or via platform-specific functions such as key shortcuts or menu options.
> 
> - Remove mention of solid white background:
> This seems to be not true anymore, even withou a `Scene` (or there's a bug)

modules/javafx.graphics/src/main/java/javafx/stage/StageStyle.java line 35:

> 33: 
> 34:     /**
> 35:      * Defines a normal {@code Stage} style with a solid background and platform decorations.

Should we say the background color is platform-specific, or perhaps identify why it is different?

-------------

PR Review Comment: https://git.openjdk.org/jfx/pull/1776#discussion_r2042288984