diff options
authorTor Arne Vestbø <>2019-02-13 14:29:32 +0100
committerTor Arne Vestbø <>2019-03-06 09:09:41 +0000
commit7a127fb4b605da6a6f9cc781fe67de7aa00048aa (patch)
parent4eda22ea0db1fc571ae9f44a68825056e6245548 (diff)
Document that dialog parent relationship does not imply stacking order
On macOS, and most probably some X11 window managers, the parent/child relationship of the dialog is not possible to propagate to the platform, and the only determining factor of whether or not the windows stack on top of each other is the modal state of the window. Task-number: QTBUG-34767 Change-Id: I8b4b4910e3f905c44e577544fc347dbded373848 Reviewed-by: Volker Hilsheimer <> Reviewed-by: Topi Reiniö <>
1 files changed, 7 insertions, 0 deletions
diff --git a/src/widgets/dialogs/qdialog.cpp b/src/widgets/dialogs/qdialog.cpp
index c9093095a7..1c10e3e786 100644
--- a/src/widgets/dialogs/qdialog.cpp
+++ b/src/widgets/dialogs/qdialog.cpp
@@ -246,6 +246,13 @@ void QDialogPrivate::deletePlatformHelper()
window-system properties for the widget (in particular it will
reset the Qt::Dialog flag).
+ \note The parent relationship of the dialog does \e{not} imply
+ that the dialog will always be stacked on top of the parent
+ window. To ensure that the dialog is always on top, make the
+ dialog modal. This also applies for child windows of the dialog
+ itself. To ensure that child windows of the dialog stay on top
+ of the dialog, make the child windows modal as well.
\section1 Modal Dialogs
A \b{modal} dialog is a dialog that blocks input to other