[gtk+/wip/action-helper: 2/5] GtkApplication: add 'active-window' property

[Ryan Lortie <ryanl src gnome org>]

commit b6a4e3b7ee79997157db612c2386e568510eae21
Author: Ryan Lortie <desrt desrt ca>
Date:   Sat Jun 16 22:42:58 2012 -0400

    GtkApplication: add 'active-window' property

 gtk/gtkapplication.c |   35 ++++++++++++++++++++++++++++++++++-
 gtk/gtkapplication.h |    3 +++
 2 files changed, 37 insertions(+), 1 deletions(-)
---
diff --git a/gtk/gtkapplication.c b/gtk/gtkapplication.c
index 49b331f..f533e78 100644
--- a/gtk/gtkapplication.c
+++ b/gtk/gtkapplication.c
@@ -131,7 +131,8 @@ enum {
   PROP_ZERO,
   PROP_REGISTER_SESSION,
   PROP_APP_MENU,
-  PROP_MENUBAR
+  PROP_MENUBAR,
+  PROP_ACTIVE_WINDOW
 };
 
 G_DEFINE_TYPE (GtkApplication, gtk_application, G_TYPE_APPLICATION)
@@ -399,6 +400,8 @@ gtk_application_focus_in_event_cb (GtkWindow      *window,
       priv->windows = g_list_concat (link, priv->windows);
     }
 
+  g_object_notify (G_OBJECT (application), "active-window");
+
 #ifdef GDK_WINDOWING_QUARTZ
   gtk_application_focus_changed (application, window);
 #endif
@@ -749,6 +752,13 @@ gtk_application_class_init (GtkApplicationClass *class)
                          P_("The GMenuModel for the menubar"),
                          G_TYPE_MENU_MODEL,
                          G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
+
+  g_object_class_install_property (object_class, PROP_ACTIVE_WINDOW,
+    g_param_spec_object ("active-window",
+                         P_("Active window"),
+                         P_("The window which most recently had focus"),
+                         GTK_TYPE_WINDOW,
+                         G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
 }
 
 /**
@@ -910,6 +920,29 @@ gtk_application_get_window_by_id (GtkApplication *application,
 }
 
 /**
+ * gtk_application_get_active_window:
+ * @application: a #GtkApplication
+ *
+ * Gets the "active" window for the application.
+ *
+ * The active window is the one that was most recently focused (within
+ * the application).  This window may not have the focus at the moment
+ * if another application has it -- this is just the most
+ * recently-focused window within this application.
+ *
+ * Returns: (transfer none): the active window
+ *
+ * Since: 3.6
+ **/
+GtkWindow *
+gtk_application_get_active_window (GtkApplication *application)
+{
+  g_return_val_if_fail (GTK_IS_APPLICATION (application), NULL);
+
+  return application->priv->windows ? application->priv->windows->data : NULL;
+}
+
+/**
  * gtk_application_add_accelerator:
  * @application: a #GtkApplication
  * @accelerator: accelerator string
diff --git a/gtk/gtkapplication.h b/gtk/gtkapplication.h
index 21cd389..d354562 100644
--- a/gtk/gtkapplication.h
+++ b/gtk/gtkapplication.h
@@ -119,6 +119,9 @@ GDK_AVAILABLE_IN_3_6
 GtkWindow *      gtk_application_get_window_by_id   (GtkApplication             *application,
                                                      guint                       id);
 
+GDK_AVAILABLE_IN_3_6
+GtkWindow *      gtk_application_get_active_window  (GtkApplication             *application);
+
 G_END_DECLS
 
 #endif /* __GTK_APPLICATION_H__ */