Fix Windows stuck behind main window in Qt 6.x

david-cattermole · david-cattermole · commit 4b136357ec13 · 2025-06-14T22:40:06.000+10:00
In Maya 2025 and 2026, both of these use Qt 6.x, where as previous Maya
versions used 5.x and 4.x.

It seems that the introduction of Qt 6.x has changed the default
behaviour, where windows do not "stay on top" by default.

Therefore we must hack-around this issue to keep the same behaviour,
using the Qt window flag 'QtCore.Qt.WindowStaysOnTopHint'.
diff --git a/python/mmSolver/tools/aboutwindow/ui/about_window.py b/python/mmSolver/tools/aboutwindow/ui/about_window.py
@@ -44,7 +44,7 @@ def __init__(self, parent=None, name=None):
         self.setupUi(self)
         self.addSubForm(about_layout.AboutLayout)
         self.setWindowTitle(const.WINDOW_TITLE_BAR)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Hide default stuff
         self.baseHideMenuBar()
diff --git a/python/mmSolver/tools/attributebake/ui/attrbake_window.py b/python/mmSolver/tools/attributebake/ui/attrbake_window.py
@@ -64,7 +64,7 @@ def __init__(self, parent=None, name=None):
         self.addSubForm(attrbake_layout.AttributeBakeLayout)
 
         self.setWindowTitle(const.WINDOW_TITLE)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Standard Buttons
         self.baseHideStandardButtons()
diff --git a/python/mmSolver/tools/attributecurvefilterpops/ui/attrcurvefilterpops_window.py b/python/mmSolver/tools/attributecurvefilterpops/ui/attrcurvefilterpops_window.py
@@ -64,7 +64,7 @@ def __init__(self, parent=None, name=None):
         self.addSubForm(layout_.AttributeCurveFilterPopsLayout)
 
         self.setWindowTitle(const.WINDOW_TITLE)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Standard Buttons
         self.baseHideStandardButtons()
diff --git a/python/mmSolver/tools/cameraobjectscaleadjust/ui/cameraobjectscaleadjust_window.py b/python/mmSolver/tools/cameraobjectscaleadjust/ui/cameraobjectscaleadjust_window.py
@@ -62,7 +62,7 @@ def __init__(self, parent=None, name=None):
         self.addSubForm(ui_layout.CameraObjectScaleAdjustLayout)
 
         self.setWindowTitle(const.WINDOW_TITLE)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Standard Buttons
         form = self.getSubForm()
diff --git a/python/mmSolver/tools/centertwodee/ui/centertwodee_window.py b/python/mmSolver/tools/centertwodee/ui/centertwodee_window.py
@@ -87,7 +87,7 @@ def __init__(self, parent=None, name=None):
         self.form.zoom_signal.connect(self.zoom_camera_shape_update)
 
         self.setWindowTitle(const.WINDOW_TITLE)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Standard Buttons
         self.baseHideStandardButtons()
diff --git a/python/mmSolver/tools/channelsen/ui/channelsen_window.py b/python/mmSolver/tools/channelsen/ui/channelsen_window.py
@@ -51,7 +51,7 @@ def __init__(self, parent=None, name=None):
         self.addSubForm(channelsen_layout.ChannelSenLayout)
 
         self.setWindowTitle('Channel Box Sensitivity')
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Standard Buttons
         self.baseHideStandardButtons()
diff --git a/python/mmSolver/tools/convertmarker/ui/convertmarker_window.py b/python/mmSolver/tools/convertmarker/ui/convertmarker_window.py
@@ -61,7 +61,7 @@ def __init__(self, parent=None, name=None):
         self.addSubForm(convertmarker_layout.ConvertMarkerLayout)
 
         self.setWindowTitle(const.WINDOW_TITLE)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Standard Buttons
         self.baseHideStandardButtons()
diff --git a/python/mmSolver/tools/createcontroller2/ui/createcontroller_window.py b/python/mmSolver/tools/createcontroller2/ui/createcontroller_window.py
@@ -63,7 +63,7 @@ def __init__(self, parent=None, name=None):
         self.addSubForm(createcontroller_layout.CreateControllerLayout)
 
         self.setWindowTitle(WINDOW_TITLE)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Standard Buttons
         self.baseHideStandardButtons()
diff --git a/python/mmSolver/tools/createcontroller3beta/ui/createcontroller_window.py b/python/mmSolver/tools/createcontroller3beta/ui/createcontroller_window.py
@@ -116,7 +116,7 @@ def __init__(self, parent=None, name=None):
         self.form = self.getSubForm()
 
         self.setWindowTitle(WINDOW_TITLE)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Hide irrelevant stuff
         self.baseHideStandardButtons()
diff --git a/python/mmSolver/tools/imagecacheprefs/ui/imagecacheprefs_window.py b/python/mmSolver/tools/imagecacheprefs/ui/imagecacheprefs_window.py
@@ -65,7 +65,7 @@ def __init__(self, parent=None, name=None):
         self.addSubForm(imagecacheprefs_layout.ImageCachePrefsLayout)
 
         self.setWindowTitle(const.WINDOW_TITLE)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Standard Buttons
         self.baseHideStandardButtons()
diff --git a/python/mmSolver/tools/loadmarker/ui/loadmarker_window.py b/python/mmSolver/tools/loadmarker/ui/loadmarker_window.py
@@ -152,7 +152,7 @@ def __init__(self, parent=None, name=None):
         self.addSubForm(loadmarker_layout.LoadMarkerLayout)
 
         self.setWindowTitle(const.WINDOW_TITLE)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Standard Buttons
         self.baseHideStandardButtons()
diff --git a/python/mmSolver/tools/meshfrompoints/ui/meshfrompoints_window.py b/python/mmSolver/tools/meshfrompoints/ui/meshfrompoints_window.py
@@ -63,7 +63,7 @@ def __init__(self, parent=None, name=None):
         self.addSubForm(meshfrompoints_layout.MeshFromPointsLayout)
 
         self.setWindowTitle(const.WINDOW_TITLE)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Hide irrelevant stuff
         self.baseHideStandardButtons()
diff --git a/python/mmSolver/tools/raycastmarker/ui/raycastmarker_window.py b/python/mmSolver/tools/raycastmarker/ui/raycastmarker_window.py
@@ -61,7 +61,7 @@ def __init__(self, parent=None, name=None):
         self.addSubForm(layout.RayCastMarkerLayout)
 
         self.setWindowTitle(const.WINDOW_TITLE)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Standard Buttons
         self.baseHideStandardButtons()
diff --git a/python/mmSolver/tools/removesolvernodes/ui/removesolvernodes_window.py b/python/mmSolver/tools/removesolvernodes/ui/removesolvernodes_window.py
@@ -283,7 +283,7 @@ def __init__(self, parent=None, name=None):
         self.addSubForm(removesolvernodes_layout.RemoveSolverNodesLayout)
 
         self.setWindowTitle(const.WINDOW_TITLE)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Standard Buttons
         self.baseHideStandardButtons()
diff --git a/python/mmSolver/tools/reparent2/ui/reparent2_window.py b/python/mmSolver/tools/reparent2/ui/reparent2_window.py
@@ -62,7 +62,7 @@ def __init__(self, parent=None, name=None):
         self.addSubForm(layout.Reparent2Layout)
 
         self.setWindowTitle(const.WINDOW_TITLE)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Standard Buttons
         self.baseHideStandardButtons()
diff --git a/python/mmSolver/tools/screenspacerigbake/ui/screenspacerigbake_window.py b/python/mmSolver/tools/screenspacerigbake/ui/screenspacerigbake_window.py
@@ -61,7 +61,7 @@ def __init__(self, parent=None, name=None):
         self.addSubForm(ui_layout.ScreenSpaceRigBakeLayout)
 
         self.setWindowTitle(const.WINDOW_TITLE)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Hide irrelevant stuff
         form = self.getSubForm()
diff --git a/python/mmSolver/tools/setcameraoriginframe/ui/originframe_window.py b/python/mmSolver/tools/setcameraoriginframe/ui/originframe_window.py
@@ -61,7 +61,7 @@ def __init__(self, parent=None, name=None):
         self.addSubForm(originframe_layout.OriginFrameLayout)
 
         self.setWindowTitle(const.WINDOW_TITLE)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Standard Buttons
         self.baseHideStandardButtons()
diff --git a/python/mmSolver/tools/smoothkeyframes/ui/smoothkeys_window.py b/python/mmSolver/tools/smoothkeyframes/ui/smoothkeys_window.py
@@ -61,7 +61,7 @@ def __init__(self, parent=None, name=None):
         self.addSubForm(smoothkeys_layout.SmoothKeysLayout)
 
         self.setWindowTitle(const.WINDOW_TITLE)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Standard Buttons
         self.baseHideStandardButtons()
diff --git a/python/mmSolver/tools/solver/ui/solver_window.py b/python/mmSolver/tools/solver/ui/solver_window.py
@@ -70,6 +70,7 @@ def __init__(self, parent=None, name=None):
         s = time.time()
         s1 = time.time()
         super(SolverWindow, self).__init__(parent, name=name)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
         self.setupUi(self)
         self.addSubForm(solver_layout.SolverLayout)
         self.setStatusLine(const.STATUS_READY)
diff --git a/python/mmSolver/tools/surfacecluster/ui/surfacecluster_window.py b/python/mmSolver/tools/surfacecluster/ui/surfacecluster_window.py
@@ -61,7 +61,7 @@ def __init__(self, parent=None, name=None):
         self.addSubForm(surfacecluster_layout.SurfaceClusterLayout)
 
         self.setWindowTitle(const.WINDOW_TITLE)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Standard Buttons
         self.baseHideStandardButtons()
diff --git a/python/mmSolver/tools/sysinfowindow/ui/sysinfo_window.py b/python/mmSolver/tools/sysinfowindow/ui/sysinfo_window.py
@@ -48,7 +48,7 @@ def __init__(self, parent=None, name=None):
         self.setupUi(self)
         self.addSubForm(sysinfo_layout.SysInfoLayout)
         self.setWindowTitle(const.WINDOW_TITLE_BAR)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Hide default stuff
         self.baseHideMenuBar()
diff --git a/python/mmSolver/tools/userprefswindow/ui/pref_window.py b/python/mmSolver/tools/userprefswindow/ui/pref_window.py
@@ -58,7 +58,7 @@ def __init__(self, parent=None, name=None):
         self.setupUi(self)
         self.addSubForm(pref_layout.PrefLayout)
         self.setWindowTitle(const.WINDOW_TITLE_BAR)
-        self.setWindowFlags(QtCore.Qt.Tool)
+        self.setWindowType(qtpyutils.WINDOW_TYPE_DIALOG)
 
         # Hide default stuff
         self.baseHideStandardButtons()
diff --git a/python/mmSolver/ui/base_maya_window.py b/python/mmSolver/ui/base_maya_window.py
@@ -151,6 +151,29 @@ def getSubForm(self):
         """
         return self.subForm
 
+    def setWindowType(self, value):
+        assert value in qtpyutils.WINDOW_TYPES
+
+        flags = self.windowFlags()
+        if value == qtpyutils.WINDOW_TYPE_TOOL:
+            flags |= QtCore.Qt.Tool
+        elif value == qtpyutils.WINDOW_TYPE_DIALOG:
+            flags |= QtCore.Qt.Dialog
+
+        stay_on_top_types = [qtpyutils.WINDOW_TYPE_TOOL, qtpyutils.WINDOW_TYPE_DIALOG]
+        if value in stay_on_top_types:
+            # NOTE: Qt 6.x (released in Maya 2025) seems to have
+            # changed behaviour, where windows with the
+            # 'QtCore.Qt.Tool' flag do not "stay on top" by default,
+            # but in Qt 4.x and 5.x it did. Therefore we must
+            # hack-around this issue to keep the same behaviour.
+            stay_on_top = maya.cmds.about(qtVersion=True).startswith('6.')
+            if stay_on_top:
+                flags |= QtCore.Qt.WindowStaysOnTopHint
+
+        self.setWindowFlags(flags)
+        return
+
     def showEvent(self, event):
         super(BaseMayaWindow, self).showEvent(event)
         path = self._settings_path
diff --git a/python/mmSolver/ui/qtpyutils.py b/python/mmSolver/ui/qtpyutils.py
@@ -32,6 +32,30 @@
 BINDING_ORDER = ['PySide6', 'PySide2', 'PyQt5', 'PySide', 'PyQt4']
 
 
+# "Window types" are a value used to group multiple windows together
+# and apply a group of settings which are set by the mmSolver base
+# window class ('mmSolver.ui.base_maya_window.BaseMayaWindow').
+#
+# Tool windows are "often a small window with a smaller than usual
+# title bar and decoration, typically used for collections of tool
+# buttons."
+WINDOW_TYPE_TOOL = 'tool_window'
+#
+# Dialog windows are "a window that should be decorated as a dialog
+# (i.e., typically no maximize or minimize buttons in the title
+# bar). This is the default type for QDialog."
+WINDOW_TYPE_DIALOG = 'dialog_window'
+#
+# Main windows are windows "usually with a window system frame and a
+# title bar, irrespective of whether the widget has a parent or not."
+WINDOW_TYPE_MAIN = 'main_window'
+WINDOW_TYPES = [
+    WINDOW_TYPE_TOOL,
+    WINDOW_TYPE_DIALOG,
+    WINDOW_TYPE_MAIN,
+]
+
+
 def override_binding_order(binding_order=None):
     """
     Change the expected order of Qt bindings used by Qt.py.
