RFR: 8354478: Improve StageStyle documentation [v2]

[Thiago Milczarek Sayao]

On Mon, 14 Apr 2025 23:38:36 GMT, Thiago Milczarek Sayao <tsayao at openjdk.org> wrote:

>> modules/javafx.graphics/src/main/java/javafx/stage/StageStyle.java line 41:
>> 
>>> 39:     /**
>>> 40:      * Defines a {@code Stage} style with no window decorations, such as a title bar,
>>> 41:      * borders, or window controls.
>> 
>> Any particular reason you removed "a solid background" like `DECORATED` has? The previous docs give that detail.
>
> I restored it, but I'm still curious about when the white background should actually be visible. I noticed that on Linux, if a stage is shown without a scene, it behaves oddly—it doesn't render because there's nothing being painted. To fix this, I added a white background as part of the "Linux glass fixes" package I'm working on. I also observed that when a scene is present, a white background gets set automatically. But under what conditions is it actually visible?

A scene with a TRANSPARENT Parent is one scenario.

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

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