summaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authorAndy Shaw <andy.shaw@qt.io>2021-05-31 15:39:11 +0200
committerQt Cherry-pick Bot <cherrypick_bot@qt-project.org>2021-06-08 11:16:50 +0000
commitf09f330ea68d7f2e45246b79cab72de11bbdf5c5 (patch)
treef19adaa495f06c6cb344c2d48504d8d5bde10931 /src
parentf8238c302fbcd116414c25582d8c999e34a1f00a (diff)
Doc: Add a note about a limitation in QDockWidget on macOS
Change-Id: I3599304d2dab9a6e64f110644b22e65494f3c0a8 Reviewed-by: Richard Moe Gustavsen <richard.gustavsen@qt.io> (cherry picked from commit e5aada1ba7133dedc7ec00e67c5cca68186b738d) Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
Diffstat (limited to 'src')
-rw-r--r--src/widgets/widgets/qdockwidget.cpp5
1 files changed, 5 insertions, 0 deletions
diff --git a/src/widgets/widgets/qdockwidget.cpp b/src/widgets/widgets/qdockwidget.cpp
index 5016235755..6675d7a6bd 100644
--- a/src/widgets/widgets/qdockwidget.cpp
+++ b/src/widgets/widgets/qdockwidget.cpp
@@ -1233,6 +1233,11 @@ void QDockWidgetPrivate::setWindowState(bool floating, bool unplug, const QRect
on whether it is docked; a docked QDockWidget has no frame and a smaller title
bar.
+ \note On macOS, if the QDockWidget has a native window handle (for example,
+ if winId() is called on it or the child widget), then due to a limitation it will not be
+ possible to drag the dock widget when undocking. Starting the drag will undock
+ the dock widget, but a second drag will be needed to move the dock widget itself.
+
\sa QMainWindow, {Dock Widgets Example}
*/