Add meta_window_get_transient_for() method

Davyd Madeley · vkareh · commit 4f47c5be6132 · 2018-08-28T09:38:37.000-04:00
NOTE: Patch copied from mutter and adapted for metacity.
diff --git a/src/core/window.c b/src/core/window.c
@@ -8630,6 +8630,29 @@ meta_window_get_xwindow (MetaWindow *window)
   return window->xwindow;
 }
 
+/**
+ * meta_window_get_transient_for:
+ * @window: a #MetaWindow
+ *
+ * Returns the #MetaWindow for the window that is pointed to by the
+ * WM_TRANSIENT_FOR hint on this window (see XGetTransientForHint()
+ * or XSetTransientForHint()). Metacity keeps transient windows above their
+ * parents. A typical usage of this hint is for a dialog that wants to stay
+ * above its associated window.
+ *
+ * Return value: (transfer none): the window this window is transient for, or
+ * %NULL if the WM_TRANSIENT_FOR hint is unset or does not point to a toplevel
+ * window that Metacity knows about.
+ */
+MetaWindow *
+meta_window_get_transient_for (MetaWindow *window)
+{
+  if (window->xtransient_for)
+    return meta_display_lookup_x_window (window->display, window->xtransient_for);
+  else
+    return NULL;
+}
+
 gboolean
 meta_window_is_maximized (MetaWindow *window)
 {
diff --git a/src/include/window.h b/src/include/window.h
@@ -35,6 +35,7 @@ MetaRectangle *meta_window_get_rect (MetaWindow *window);
 MetaScreen *meta_window_get_screen (MetaWindow *window);
 MetaDisplay *meta_window_get_display (MetaWindow *window);
 Window meta_window_get_xwindow (MetaWindow *window);
+MetaWindow *meta_window_get_transient_for (MetaWindow *window);
 gboolean meta_window_is_maximized (MetaWindow *window);
 
 #endif
