RFR: 8313424: JavaFX controls in the title bar [v19]

[Michael Strauß]

On Tue, 5 Nov 2024 15:56:24 GMT, Andy Goryachev <angorya at openjdk.org> wrote:

>> `WindowControlsOverlay` is not API, it's an implementation detail and as such must not be documented in `cssref.html`. This is by design: currently, this feature has a minimal API with just three new API elements: `StageStyle.EXTENDED`, `HeaderBar`, and `HeaderBarBase`. If we allowed app developers to customize window buttons, the API would explode in size and the specification burden would be immense. Let's not go there.
>
> I am confused.  Can it be customized with a style sheet?  If so, it should be documented, no?

It can't be customized by users, as there is no API for that. There wouldn't be a platform-independent way to do that, because we're not using `WindowControlsOverlay` on macOS in the first place.

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

PR Review Comment: https://git.openjdk.org/jfx/pull/1605#discussion_r1829620784