Clarify that FramelessWindowHint does not guarantee fixed sized windows

Depending on the window manager or operating system the act of making
a window borderless may also affect the ability for the user to move or
resize a window interactively. However, this is a side effect of making
a window borderless, and should not be relied on. The correct way to
ensure a window has a fixed size it to use setMinimum/MaximumSize.

Fixes: QTBUG-103503
Fixes: QTBUG-106710
Pick-to: 6.4
Change-Id: I6d82380f5a9af1f08b12cb445792ecbf71bb0377
Reviewed-by: Volker Hilsheimer <volker.hilsheimer@qt.io>
bb10
Tor Arne Vestbø 2022-09-19 19:42:03 +02:00
parent dc1f931a91
commit 9796670732
1 changed files with 8 additions and 2 deletions

View File

@ -2213,11 +2213,17 @@
you call QWidget::activateWindow() manually).
\value FramelessWindowHint Produces a borderless window.
The user cannot move or resize a borderless window via the window
system. On X11, the result of the flag is dependent on the window manager and its
On X11, the result of the flag is dependent on the window manager and its
ability to understand Motif and/or NETWM hints. Most existing
modern window managers can handle this.
\note If the window manager relies on the frame to interactively manipulate
the window, the user can no longer move or resize the window via the window
system, but this side effect should not be relied on. To produce a fixed
size window that can not be resized, please set QWindow::setMinimumSize()
and QWindow::setMaximumSize() to the same size.
\value NoDropShadowWindowHint Disables window drop shadow on supporting platforms.
The \c CustomizeWindowHint flag is used to enable customization of