-/* GTK - The GIMP Toolkit
- *
- * Copyright (C) 2010 Red Hat, Inc.
+/*
+ * Copyright © 2010 Codethink Limited
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
- * version 2 of the License, or (at your option) any later version.
+ * version 2 of the licence, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
- * License along with this library; if not, write to the
- * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
- * Boston, MA 02111-1307, USA.
+ * License along with this library. If not, see <http://www.gnu.org/licenses/>.
*
- * Author: Colin Walters <walters@verbum.org>
- */
-
-/*
- * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
- * file for a list of people on the GTK+ Team. See the ChangeLog
- * files for a list of changes. These files are distributed with
- * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
+ * Author: Ryan Lortie <desrt@desrt.ca>
*/
#include "config.h"
+#include "gtkapplication.h"
+
#include <stdlib.h>
+#ifdef HAVE_UNISTD_H
#include <unistd.h>
+#endif
+#include <string.h>
-#include "gtkapplication.h"
-#include "gtkmain.h"
+#include "gtkapplicationprivate.h"
+#include "gtkclipboard.h"
#include "gtkmarshalers.h"
+#include "gtkmain.h"
+#include "gtkrecentmanager.h"
+#include "gtkaccelmapprivate.h"
+#include "gactionmuxer.h"
#include "gtkintl.h"
-#include "gtkprivate.h"
-#include "gtkalias.h"
+#ifdef GDK_WINDOWING_QUARTZ
+#include "gtkquartz-menu.h"
+#import <Cocoa/Cocoa.h>
+#include <Carbon/Carbon.h>
+#include "gtkmessagedialog.h"
+#endif
#include <gdk/gdk.h>
#ifdef GDK_WINDOWING_X11
* of a GTK+ application in a convenient fashion, without enforcing
* a one-size-fits-all application model.
*
- * Currently, GtkApplication handles application uniqueness, provides
- * some basic scriptability by exporting 'actions', implements some
- * standard actions itself (such as 'Quit') and provides a main window
- * whose life-cycle is automatically tied to the life-cycle of your
- * application.
+ * Currently, GtkApplication handles GTK+ initialization, application
+ * uniqueness, session management, provides some basic scriptability and
+ * desktop shell integration by exporting actions and menus and manages a
+ * list of toplevel windows whose life-cycle is automatically tied to the
+ * life-cycle of your application.
+ *
+ * While GtkApplication works fine with plain #GtkWindows, it is recommended
+ * to use it together with #GtkApplicationWindow.
+ *
+ * When GDK threads are enabled, GtkApplication will acquire the GDK
+ * lock when invoking actions that arrive from other processes. The GDK
+ * lock is not touched for local action invocations. In order to have
+ * actions invoked in a predictable context it is therefore recommended
+ * that the GDK lock be held while invoking actions locally with
+ * g_action_group_activate_action(). The same applies to actions
+ * associated with #GtkApplicationWindow and to the 'activate' and
+ * 'open' #GApplication methods.
+ *
+ * To set an application menu on a GtkApplication, use
+ * gtk_application_set_app_menu(). The #GMenuModel that this function
+ * expects is usually constructed using #GtkBuilder, as seen in the
+ * following example. To set a menubar that will be automatically picked
+ * up by #GApplicationWindows, use gtk_application_set_menubar(). GTK+
+ * makes these menus appear as expected, depending on the platform
+ * the application is running on.
+ *
+ * <figure label="Menu integration in OS X">
+ * <graphic fileref="bloatpad-osx.png" format="PNG"/>
+ * </figure>
+ *
+ * <figure label="Menu integration in GNOME">
+ * <graphic fileref="bloatpad-gnome.png" format="PNG"/>
+ * </figure>
+ *
+ * <figure label="Menu integration in Xfce">
+ * <graphic fileref="bloatpad-xfce.png" format="PNG"/>
+ * </figure>
*
* <example id="gtkapplication"><title>A simple application</title>
* <programlisting>
- * <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="text" href="../../../../gtk/tests/gtk-example-application.c">
+ * <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="text" href="../../../../examples/bloatpad.c">
* <xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback>
* </xi:include>
* </programlisting>
* </example>
+ *
+ * GtkApplication optionally registers with a session manager
+ * of the users session (if you set the #GtkApplication:register-session
+ * property) and offers various functionality related to the session
+ * life-cycle.
+ *
+ * An application can block various ways to end the session with
+ * the gtk_application_inhibit() function. Typical use cases for
+ * this kind of inhibiting are long-running, uninterruptible operations,
+ * such as burning a CD or performing a disk backup. The session
+ * manager may not honor the inhibitor, but it can be expected to
+ * inform the user about the negative consequences of ending the
+ * session while inhibitors are present.
*/
-enum
-{
- PROP_0,
- PROP_WINDOW
+
+enum {
+ WINDOW_ADDED,
+ WINDOW_REMOVED,
+ LAST_SIGNAL
};
-enum
-{
- ACTIVATED,
- QUIT,
- ACTION,
+static guint gtk_application_signals[LAST_SIGNAL];
- LAST_SIGNAL
+enum {
+ PROP_ZERO,
+ PROP_REGISTER_SESSION,
+ PROP_APP_MENU,
+ PROP_MENUBAR
};
-static guint gtk_application_signals[LAST_SIGNAL] = { 0 };
+G_DEFINE_TYPE (GtkApplication, gtk_application, G_TYPE_APPLICATION)
struct _GtkApplicationPrivate
{
- GtkActionGroup *main_actions;
+ GList *windows;
+
+ gboolean register_session;
+
+ GMenuModel *app_menu;
+ GMenuModel *menubar;
+
+#ifdef GDK_WINDOWING_X11
+ GDBusConnection *session_bus;
+ const gchar *application_id;
+ gchar *object_path;
- GtkWindow *default_window;
- GSList *windows;
+ gchar *app_menu_path;
+ guint app_menu_id;
+
+ gchar *menubar_path;
+ guint menubar_id;
+
+ guint next_id;
+
+ GDBusProxy *sm_proxy;
+ GDBusProxy *client_proxy;
+ gchar *app_id;
+ gchar *client_path;
+#endif
+
+#ifdef GDK_WINDOWING_QUARTZ
+ GActionMuxer *muxer;
+ GMenu *combined;
+
+ GSList *inhibitors;
+ gint quit_inhibit;
+ guint next_cookie;
+#endif
};
-G_DEFINE_TYPE (GtkApplication, gtk_application, G_TYPE_APPLICATION)
+#ifdef GDK_WINDOWING_X11
+static void
+gtk_application_x11_publish_menu (GtkApplication *application,
+ const gchar *type,
+ GMenuModel *model,
+ guint *id,
+ gchar **path)
+{
+ gint i;
+
+ /* unexport any existing menu */
+ if (*id)
+ {
+ g_dbus_connection_unexport_menu_model (application->priv->session_bus, *id);
+ g_free (*path);
+ *path = NULL;
+ *id = 0;
+ }
+
+ /* export the new menu, if there is one */
+ if (model != NULL)
+ {
+ /* try getting the preferred name */
+ *path = g_strconcat (application->priv->object_path, "/menus/", type, NULL);
+ *id = g_dbus_connection_export_menu_model (application->priv->session_bus, *path, model, NULL);
+
+ /* keep trying until we get a working name... */
+ for (i = 0; *id == 0; i++)
+ {
+ g_free (*path);
+ *path = g_strdup_printf ("%s/menus/%s%d", application->priv->object_path, type, i);
+ *id = g_dbus_connection_export_menu_model (application->priv->session_bus, *path, model, NULL);
+ }
+ }
+}
static void
-process_timestamp_from_platform_data (GVariant *platform_data)
+gtk_application_set_app_menu_x11 (GtkApplication *application,
+ GMenuModel *app_menu)
{
- /* TODO - extract timestamp from here, update GDK time */
+ gtk_application_x11_publish_menu (application, "appmenu", app_menu,
+ &application->priv->app_menu_id,
+ &application->priv->app_menu_path);
}
-static gboolean
-gtk_application_default_quit (GtkApplication *application)
+static void
+gtk_application_set_menubar_x11 (GtkApplication *application,
+ GMenuModel *menubar)
+{
+ gtk_application_x11_publish_menu (application, "menubar", menubar,
+ &application->priv->menubar_id,
+ &application->priv->menubar_path);
+}
+
+static void
+gtk_application_window_added_x11 (GtkApplication *application,
+ GtkWindow *window)
+{
+ if (application->priv->session_bus == NULL)
+ return;
+
+ if (GTK_IS_APPLICATION_WINDOW (window))
+ {
+ GtkApplicationWindow *app_window = GTK_APPLICATION_WINDOW (window);
+ gboolean success;
+
+ /* GtkApplicationWindow associates with us when it is first created,
+ * so surely it's not realized yet...
+ */
+ g_assert (!gtk_widget_get_realized (GTK_WIDGET (window)));
+
+ do
+ {
+ gchar *window_path;
+ guint window_id;
+
+ window_id = application->priv->next_id++;
+ window_path = g_strdup_printf ("%s/window/%d", application->priv->object_path, window_id);
+ success = gtk_application_window_publish (app_window, application->priv->session_bus, window_path);
+ g_free (window_path);
+ }
+ while (!success);
+ }
+}
+
+static void
+gtk_application_window_removed_x11 (GtkApplication *application,
+ GtkWindow *window)
+{
+ if (application->priv->session_bus == NULL)
+ return;
+
+ if (GTK_IS_APPLICATION_WINDOW (window))
+ gtk_application_window_unpublish (GTK_APPLICATION_WINDOW (window));
+}
+
+static gchar *
+object_path_from_appid (const gchar *appid)
+{
+ gchar *appid_path, *iter;
+
+ appid_path = g_strconcat ("/", appid, NULL);
+ for (iter = appid_path; *iter; iter++)
+ {
+ if (*iter == '.')
+ *iter = '/';
+
+ if (*iter == '-')
+ *iter = '_';
+ }
+
+ return appid_path;
+}
+
+static void gtk_application_startup_session_dbus (GtkApplication *app);
+
+static void
+gtk_application_startup_x11 (GtkApplication *application)
+{
+ const gchar *application_id;
+
+ application_id = g_application_get_application_id (G_APPLICATION (application));
+ application->priv->session_bus = g_bus_get_sync (G_BUS_TYPE_SESSION, NULL, NULL);
+ application->priv->object_path = object_path_from_appid (application_id);
+
+ gtk_application_startup_session_dbus (GTK_APPLICATION (application));
+}
+
+static void
+gtk_application_shutdown_x11 (GtkApplication *application)
+{
+ g_free (application->priv->object_path);
+ application->priv->object_path = NULL;
+ g_clear_object (&application->priv->session_bus);
+
+ g_clear_object (&application->priv->sm_proxy);
+ g_clear_object (&application->priv->client_proxy);
+ g_free (application->priv->app_id);
+ g_free (application->priv->client_path);
+}
+
+const gchar *
+gtk_application_get_dbus_object_path (GtkApplication *application)
+{
+ return application->priv->object_path;
+}
+
+const gchar *
+gtk_application_get_app_menu_object_path (GtkApplication *application)
+{
+ return application->priv->app_menu_path;
+}
+
+const gchar *
+gtk_application_get_menubar_object_path (GtkApplication *application)
+{
+ return application->priv->menubar_path;
+}
+
+#endif
+
+#ifdef GDK_WINDOWING_QUARTZ
+
+typedef struct {
+ guint cookie;
+ GtkApplicationInhibitFlags flags;
+ char *reason;
+ GtkWindow *window;
+} GtkApplicationQuartzInhibitor;
+
+static void
+gtk_application_quartz_inhibitor_free (GtkApplicationQuartzInhibitor *inhibitor)
+{
+ g_free (inhibitor->reason);
+ g_clear_object (&inhibitor->window);
+ g_slice_free (GtkApplicationQuartzInhibitor, inhibitor);
+}
+
+static void
+gtk_application_menu_changed_quartz (GObject *object,
+ GParamSpec *pspec,
+ gpointer user_data)
+{
+ GtkApplication *application = GTK_APPLICATION (object);
+ GMenu *combined;
+
+ combined = g_menu_new ();
+ g_menu_append_submenu (combined, "Application", gtk_application_get_app_menu (application));
+ g_menu_append_section (combined, NULL, gtk_application_get_menubar (application));
+
+ gtk_quartz_set_main_menu (G_MENU_MODEL (combined), G_ACTION_OBSERVABLE (application->priv->muxer));
+}
+
+static void gtk_application_startup_session_quartz (GtkApplication *app);
+
+static void
+gtk_application_startup_quartz (GtkApplication *application)
+{
+ [NSApp finishLaunching];
+
+ application->priv->muxer = g_action_muxer_new ();
+ g_action_muxer_insert (application->priv->muxer, "app", G_ACTION_GROUP (application));
+
+ g_signal_connect (application, "notify::app-menu", G_CALLBACK (gtk_application_menu_changed_quartz), NULL);
+ g_signal_connect (application, "notify::menubar", G_CALLBACK (gtk_application_menu_changed_quartz), NULL);
+ gtk_application_menu_changed_quartz (G_OBJECT (application), NULL, NULL);
+
+ gtk_application_startup_session_quartz (application);
+}
+
+static void
+gtk_application_shutdown_quartz (GtkApplication *application)
+{
+ g_signal_handlers_disconnect_by_func (application, gtk_application_menu_changed_quartz, NULL);
+
+ g_object_unref (application->priv->muxer);
+ application->priv->muxer = NULL;
+
+ g_slist_free_full (application->priv->inhibitors,
+ (GDestroyNotify) gtk_application_quartz_inhibitor_free);
+ application->priv->inhibitors = NULL;
+}
+
+static void
+gtk_application_focus_changed (GtkApplication *application,
+ GtkWindow *window)
{
- gtk_main_quit ();
- return TRUE;
+ if (G_IS_ACTION_GROUP (window))
+ g_action_muxer_insert (application->priv->muxer, "win", G_ACTION_GROUP (window));
+ else
+ g_action_muxer_remove (application->priv->muxer, "win");
}
+#endif
static gboolean
-gtk_application_default_quit_with_data (GApplication *application,
- GVariant *platform_data)
+gtk_application_focus_in_event_cb (GtkWindow *window,
+ GdkEventFocus *event,
+ GtkApplication *application)
{
- gboolean result;
+ GtkApplicationPrivate *priv = application->priv;
+ GList *link;
- process_timestamp_from_platform_data (platform_data);
-
- g_signal_emit (application, gtk_application_signals[QUIT], 0, &result);
+ /* Keep the window list sorted by most-recently-focused. */
+ link = g_list_find (priv->windows, window);
+ if (link != NULL && link != priv->windows)
+ {
+ priv->windows = g_list_remove_link (priv->windows, link);
+ priv->windows = g_list_concat (link, priv->windows);
+ }
+
+#ifdef GDK_WINDOWING_QUARTZ
+ gtk_application_focus_changed (application, window);
+#endif
+
+ return FALSE;
+}
- return result;
+static void
+gtk_application_startup (GApplication *application)
+{
+ G_APPLICATION_CLASS (gtk_application_parent_class)
+ ->startup (application);
+
+ gtk_init (0, 0);
+
+#ifdef GDK_WINDOWING_X11
+ gtk_application_startup_x11 (GTK_APPLICATION (application));
+#endif
+
+#ifdef GDK_WINDOWING_QUARTZ
+ gtk_application_startup_quartz (GTK_APPLICATION (application));
+#endif
}
static void
-gtk_application_default_run (GApplication *application)
+gtk_application_shutdown (GApplication *application)
{
- gtk_main ();
+#ifdef GDK_WINDOWING_X11
+ gtk_application_shutdown_x11 (GTK_APPLICATION (application));
+#endif
+
+#ifdef GDK_WINDOWING_QUARTZ
+ gtk_application_shutdown_quartz (GTK_APPLICATION (application));
+#endif
+
+ /* Try storing all clipboard data we have */
+ _gtk_clipboard_store_all ();
+
+ /* Synchronize the recent manager singleton */
+ _gtk_recent_manager_sync ();
+
+ G_APPLICATION_CLASS (gtk_application_parent_class)
+ ->shutdown (application);
}
static void
-gtk_application_default_prepare_activation (GApplication *application,
- GVariant *arguments,
- GVariant *platform_data)
+gtk_application_add_platform_data (GApplication *application,
+ GVariantBuilder *builder)
+{
+ const gchar *startup_id;
+
+ startup_id = getenv ("DESKTOP_STARTUP_ID");
+
+ if (startup_id && g_utf8_validate (startup_id, -1, NULL))
+ g_variant_builder_add (builder, "{sv}", "desktop-startup-id",
+ g_variant_new_string (startup_id));
+}
+
+static void
+gtk_application_before_emit (GApplication *application,
+ GVariant *platform_data)
{
GVariantIter iter;
- gchar *key;
+ const gchar *key;
GVariant *value;
+ gdk_threads_enter ();
+
g_variant_iter_init (&iter, platform_data);
- while (g_variant_iter_next (&iter, "{&sv}", &key, &value))
+ while (g_variant_iter_loop (&iter, "{&sv}", &key, &value))
{
- if (strcmp (key, "startup-notification-id") == 0 &&
- g_variant_is_of_type (value, G_VARIANT_TYPE_STRING))
- gdk_notify_startup_complete_with_id (g_variant_get_string (value, NULL));
+#ifdef GDK_WINDOWING_X11
+ if (strcmp (key, "desktop-startup-id") == 0)
+ {
+ GdkDisplay *display;
+ const gchar *id;
+
+ display = gdk_display_get_default ();
+ id = g_variant_get_string (value, NULL);
+ if (GDK_IS_X11_DISPLAY (display))
+ gdk_x11_display_set_startup_notification_id (display, id);
+ }
+#endif
+ }
+}
+
+static void
+gtk_application_after_emit (GApplication *application,
+ GVariant *platform_data)
+{
+ gdk_notify_startup_complete ();
+
+ gdk_threads_leave ();
+}
+
+static void
+gtk_application_init (GtkApplication *application)
+{
+ application->priv = G_TYPE_INSTANCE_GET_PRIVATE (application,
+ GTK_TYPE_APPLICATION,
+ GtkApplicationPrivate);
+}
+
+static void
+gtk_application_window_added (GtkApplication *application,
+ GtkWindow *window)
+{
+ GtkApplicationPrivate *priv = application->priv;
+
+ priv->windows = g_list_prepend (priv->windows, window);
+ gtk_window_set_application (window, application);
+ g_application_hold (G_APPLICATION (application));
+
+ g_signal_connect (window, "focus-in-event",
+ G_CALLBACK (gtk_application_focus_in_event_cb),
+ application);
+
+#ifdef GDK_WINDOWING_X11
+ gtk_application_window_added_x11 (application, window);
+#endif
+}
+
+static void
+gtk_application_window_removed (GtkApplication *application,
+ GtkWindow *window)
+{
+ GtkApplicationPrivate *priv = application->priv;
+
+#ifdef GDK_WINDOWING_X11
+ gtk_application_window_removed_x11 (application, window);
+#endif
+
+ g_signal_handlers_disconnect_by_func (window,
+ gtk_application_focus_in_event_cb,
+ application);
+
+ g_application_release (G_APPLICATION (application));
+ priv->windows = g_list_remove (priv->windows, window);
+ gtk_window_set_application (window, NULL);
+}
+
+static void
+extract_accel_from_menu_item (GMenuModel *model,
+ gint item,
+ GtkApplication *app)
+{
+ GMenuAttributeIter *iter;
+ const gchar *key;
+ GVariant *value;
+ const gchar *accel = NULL;
+ const gchar *action = NULL;
+ GVariant *target = NULL;
+
+ iter = g_menu_model_iterate_item_attributes (model, item);
+ while (g_menu_attribute_iter_get_next (iter, &key, &value))
+ {
+ if (g_str_equal (key, "action") && g_variant_is_of_type (value, G_VARIANT_TYPE_STRING))
+ action = g_variant_get_string (value, NULL);
+ else if (g_str_equal (key, "accel") && g_variant_is_of_type (value, G_VARIANT_TYPE_STRING))
+ accel = g_variant_get_string (value, NULL);
+ else if (g_str_equal (key, "target"))
+ target = g_variant_ref (value);
g_variant_unref (value);
}
-
- g_signal_emit (G_OBJECT (application), gtk_application_signals[ACTIVATED], 0, arguments);
+ g_object_unref (iter);
+
+ if (accel && action)
+ gtk_application_add_accelerator (app, accel, action, target);
+
+ if (target)
+ g_variant_unref (target);
+}
+
+static void
+extract_accels_from_menu (GMenuModel *model,
+ GtkApplication *app)
+{
+ gint i;
+ GMenuLinkIter *iter;
+ const gchar *key;
+ GMenuModel *m;
+
+ for (i = 0; i < g_menu_model_get_n_items (model); i++)
+ {
+ extract_accel_from_menu_item (model, i, app);
+
+ iter = g_menu_model_iterate_item_links (model, i);
+ while (g_menu_link_iter_get_next (iter, &key, &m))
+ {
+ extract_accels_from_menu (m, app);
+ g_object_unref (m);
+ }
+ g_object_unref (iter);
+ }
}
static void
-gtk_application_default_activated (GtkApplication *application,
- GVariant *arguments)
+gtk_application_get_property (GObject *object,
+ guint prop_id,
+ GValue *value,
+ GParamSpec *pspec)
{
- GtkApplication *app = GTK_APPLICATION (application);
+ GtkApplication *application = GTK_APPLICATION (object);
+
+ switch (prop_id)
+ {
+ case PROP_REGISTER_SESSION:
+ g_value_set_boolean (value, application->priv->register_session);
+ break;
- /* TODO: should we raise the last focused window instead ? */
- if (app->priv->default_window != NULL)
- gtk_window_present (app->priv->default_window);
+ case PROP_APP_MENU:
+ g_value_set_object (value, gtk_application_get_app_menu (application));
+ break;
+
+ case PROP_MENUBAR:
+ g_value_set_object (value, gtk_application_get_menubar (application));
+ break;
+
+ default:
+ G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+ break;
+ }
}
static void
-gtk_application_default_action (GtkApplication *application,
- const gchar *action_name)
+gtk_application_set_property (GObject *object,
+ guint prop_id,
+ const GValue *value,
+ GParamSpec *pspec)
{
- GtkAction *action;
+ GtkApplication *application = GTK_APPLICATION (object);
- action = gtk_action_group_get_action (application->priv->main_actions, action_name);
- if (action)
+ switch (prop_id)
{
- gtk_action_activate (action);
+ case PROP_REGISTER_SESSION:
+ application->priv->register_session = g_value_get_boolean (value);
+ break;
+
+ case PROP_APP_MENU:
+ gtk_application_set_app_menu (application, g_value_get_object (value));
+ break;
+
+ case PROP_MENUBAR:
+ gtk_application_set_menubar (application, g_value_get_object (value));
+ break;
+
+ default:
+ G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+ break;
}
}
-
+
static void
-gtk_application_default_action_with_data (GApplication *application,
- const gchar *action_name,
- GVariant *platform_data)
+gtk_application_finalize (GObject *object)
{
- process_timestamp_from_platform_data (platform_data);
+ GtkApplication *application = GTK_APPLICATION (object);
+
+ g_clear_object (&application->priv->app_menu);
+ g_clear_object (&application->priv->menubar);
- g_signal_emit (application, gtk_application_signals[ACTION], g_quark_from_string (action_name));
+ G_OBJECT_CLASS (gtk_application_parent_class)
+ ->finalize (object);
}
-static GVariant *
-gtk_application_format_activation_data (void)
+static void
+gtk_application_class_init (GtkApplicationClass *class)
{
- const gchar *startup_id = NULL;
- GdkDisplay *display = gdk_display_get_default ();
- GVariantBuilder builder;
+ GObjectClass *object_class = G_OBJECT_CLASS (class);
+ GApplicationClass *application_class = G_APPLICATION_CLASS (class);
+
+ object_class->get_property = gtk_application_get_property;
+ object_class->set_property = gtk_application_set_property;
+ object_class->finalize = gtk_application_finalize;
- g_variant_builder_init (&builder, G_VARIANT_TYPE ("a{sv}"));
+ application_class->add_platform_data = gtk_application_add_platform_data;
+ application_class->before_emit = gtk_application_before_emit;
+ application_class->after_emit = gtk_application_after_emit;
+ application_class->startup = gtk_application_startup;
+ application_class->shutdown = gtk_application_shutdown;
- /* try and get the startup notification id from GDK, the environment
- * or, if everything else failed, fake one.
+ class->window_added = gtk_application_window_added;
+ class->window_removed = gtk_application_window_removed;
+
+ g_type_class_add_private (class, sizeof (GtkApplicationPrivate));
+
+ /**
+ * GtkApplication::window-added:
+ * @application: the #GtkApplication which emitted the signal
+ * @window: the newly-added #GtkWindow
+ *
+ * Emitted when a #GtkWindow is added to @application through
+ * gtk_application_add_window().
+ *
+ * Since: 3.2
*/
-#ifdef GDK_WINDOWING_X11
- startup_id = gdk_x11_display_get_startup_notification_id (display);
-#endif /* GDK_WINDOWING_X11 */
+ gtk_application_signals[WINDOW_ADDED] =
+ g_signal_new ("window-added", GTK_TYPE_APPLICATION, G_SIGNAL_RUN_FIRST,
+ G_STRUCT_OFFSET (GtkApplicationClass, window_added),
+ NULL, NULL,
+ g_cclosure_marshal_VOID__OBJECT,
+ G_TYPE_NONE, 1, GTK_TYPE_WINDOW);
+
+ /**
+ * GtkApplication::window-removed:
+ * @application: the #GtkApplication which emitted the signal
+ * @window: the #GtkWindow that is being removed
+ *
+ * Emitted when a #GtkWindow is removed from @application,
+ * either as a side-effect of being destroyed or explicitly
+ * through gtk_application_remove_window().
+ *
+ * Since: 3.2
+ */
+ gtk_application_signals[WINDOW_REMOVED] =
+ g_signal_new ("window-removed", GTK_TYPE_APPLICATION, G_SIGNAL_RUN_FIRST,
+ G_STRUCT_OFFSET (GtkApplicationClass, window_removed),
+ NULL, NULL,
+ g_cclosure_marshal_VOID__OBJECT,
+ G_TYPE_NONE, 1, GTK_TYPE_WINDOW);
- if (startup_id)
- g_variant_builder_add (&builder, "{sv}", "startup-notification-id",
- g_variant_new ("s", startup_id));
- return g_variant_builder_end (&builder);
+ /**
+ * GtkApplication:register-session:
+ *
+ * Set this property to %TRUE to register with the session manager.
+ *
+ * Since: 3.4
+ */
+ g_object_class_install_property (object_class, PROP_REGISTER_SESSION,
+ g_param_spec_boolean ("register-session",
+ P_("Register session"),
+ P_("Register with the session manager"),
+ FALSE, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
+
+ g_object_class_install_property (object_class, PROP_APP_MENU,
+ g_param_spec_object ("app-menu",
+ P_("Application menu"),
+ P_("The GMenuModel for the application menu"),
+ G_TYPE_MENU_MODEL,
+ G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
+
+ g_object_class_install_property (object_class, PROP_MENUBAR,
+ g_param_spec_object ("menubar",
+ P_("Menubar"),
+ P_("The GMenuModel for the menubar"),
+ G_TYPE_MENU_MODEL,
+ G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
}
/**
* gtk_application_new:
- * @argc: (allow-none) (inout): System argument count
- * @argv: (allow-none) (inout): System argument vector
- * @appid: System-dependent application identifier
+ * @application_id: the application id
+ * @flags: the application flags
+ *
+ * Creates a new #GtkApplication instance.
*
- * Create a new #GtkApplication, or if one has already been initialized
- * in this process, return the existing instance. This function will as
- * a side effect initialize the display system; see gtk_init().
+ * This function calls g_type_init() for you. gtk_init() is called
+ * as soon as the application gets registered as the primary instance.
*
- * For the behavior if this application is running in another process,
- * see g_application_new().
+ * Concretely, gtk_init() is called in the default handler for the
+ * startup() signal. Therefore, #GtkApplication subclasses should
+ * chain up in their startup() handler before using any GTK+ API.
*
- * Returns: (transfer full): A newly-referenced #GtkApplication
+ * Note that commandline arguments are not passed to gtk_init().
+ * All GTK+ functionality that is available via commandline arguments
+ * can also be achieved by setting suitable environment variables
+ * such as <envar>G_DEBUG</envar>, so this should not be a big
+ * problem. If you absolutely must support GTK+ commandline arguments,
+ * you can explicitly call gtk_init() before creating the application
+ * instance.
+ *
+ * The application id must be valid. See g_application_id_is_valid().
+ *
+ * Returns: a new #GtkApplication instance
*
* Since: 3.0
*/
-GtkApplication*
-gtk_application_new (gint *argc,
- gchar ***argv,
- const gchar *appid)
+GtkApplication *
+gtk_application_new (const gchar *application_id,
+ GApplicationFlags flags)
{
- GtkApplication *app;
- gint argc_for_app;
- gchar **argv_for_app;
- GVariant *platform_data;
+ g_return_val_if_fail (g_application_id_is_valid (application_id), NULL);
- gtk_init (argc, argv);
+ g_type_init ();
- if (argc)
- argc_for_app = *argc;
- else
- argc_for_app = 0;
- if (argv)
- argv_for_app = *argv;
- else
- argv_for_app = NULL;
-
- app = g_object_new (GTK_TYPE_APPLICATION, "application-id", appid, NULL);
+ return g_object_new (GTK_TYPE_APPLICATION,
+ "application-id", application_id,
+ "flags", flags,
+ NULL);
+}
- platform_data = gtk_application_format_activation_data ();
- g_application_register_with_data (G_APPLICATION (app), argc_for_app, argv_for_app,
- platform_data);
- g_variant_unref (platform_data);
+/**
+ * gtk_application_add_window:
+ * @application: a #GtkApplication
+ * @window: a #GtkWindow
+ *
+ * Adds a window from @application.
+ *
+ * This call is equivalent to setting the #GtkWindow:application
+ * property of @window to @application.
+ *
+ * Normally, the connection between the application and the window
+ * will remain until the window is destroyed, but you can explicitly
+ * remove it with gtk_application_remove_window().
+ *
+ * GTK+ will keep the application running as long as it has
+ * any windows.
+ *
+ * Since: 3.0
+ **/
+void
+gtk_application_add_window (GtkApplication *application,
+ GtkWindow *window)
+{
+ g_return_if_fail (GTK_IS_APPLICATION (application));
- return app;
+ if (!g_list_find (application->priv->windows, window))
+ g_signal_emit (application,
+ gtk_application_signals[WINDOW_ADDED], 0, window);
}
-static void
-on_action_sensitive (GtkAction *action,
- GParamSpec *pspec,
- GtkApplication *app)
+/**
+ * gtk_application_remove_window:
+ * @application: a #GtkApplication
+ * @window: a #GtkWindow
+ *
+ * Remove a window from @application.
+ *
+ * If @window belongs to @application then this call is equivalent to
+ * setting the #GtkWindow:application property of @window to
+ * %NULL.
+ *
+ * The application may stop running as a result of a call to this
+ * function.
+ *
+ * Since: 3.0
+ **/
+void
+gtk_application_remove_window (GtkApplication *application,
+ GtkWindow *window)
{
- g_application_set_action_enabled (G_APPLICATION (app),
- gtk_action_get_name (action),
- gtk_action_get_sensitive (action));
+ g_return_if_fail (GTK_IS_APPLICATION (application));
+
+ if (g_list_find (application->priv->windows, window))
+ g_signal_emit (application,
+ gtk_application_signals[WINDOW_REMOVED], 0, window);
}
/**
- * gtk_application_set_action_group:
- * @app: A #GtkApplication
- * @group: A #GtkActionGroup
+ * gtk_application_get_windows:
+ * @application: a #GtkApplication
+ *
+ * Gets a list of the #GtkWindows associated with @application.
*
- * Set @group as this application's global action group.
- * This will ensure the operating system interface uses
- * these actions as follows:
+ * The list is sorted by most recently focused window, such that the first
+ * element is the currently focused window. (Useful for choosing a parent
+ * for a transient window.)
*
- * <itemizedlist>
- * <listitem>In GNOME 2 this exposes the actions for scripting.</listitem>
- * <listitem>In GNOME 3, this function populates the application menu.</listitem>
- * <listitem>In Windows prior to version 7, this function does nothing.</listitem>
- * <listitem>In Windows 7, this function adds "Tasks" to the Jump List.</listitem>
- * <listitem>In Mac OS X, this function extends the Dock menu.</listitem>
- * </itemizedlist>
+ * The list that is returned should not be modified in any way. It will
+ * only remain valid until the next focus change or window creation or
+ * deletion.
*
- * It is an error to call this function more than once.
+ * Returns: (element-type GtkWindow) (transfer none): a #GList of #GtkWindow
*
* Since: 3.0
+ **/
+GList *
+gtk_application_get_windows (GtkApplication *application)
+{
+ g_return_val_if_fail (GTK_IS_APPLICATION (application), NULL);
+
+ return application->priv->windows;
+}
+
+/**
+ * gtk_application_add_accelerator:
+ * @application: a #GtkApplication
+ * @accelerator: accelerator string
+ * @action_name: the name of the action to activate
+ * @parameter: (allow-none): parameter to pass when activating the action,
+ * or %NULL if the action does not accept an activation parameter
+ *
+ * Installs an accelerator that will cause the named action
+ * to be activated when the key combination specificed by @accelerator
+ * is pressed.
+ *
+ * @accelerator must be a string that can be parsed by
+ * gtk_accelerator_parse(), e.g. "<Primary>q" or "<Control><Alt>p".
+ *
+ * @action_name must be the name of an action as it would be used
+ * in the app menu, i.e. actions that have been added to the application
+ * are referred to with an "app." prefix, and window-specific actions
+ * with a "win." prefix.
+ *
+ * GtkApplication also extracts accelerators out of 'accel' attributes
+ * in the #GMenuModels passed to gtk_application_set_app_menu() and
+ * gtk_application_set_menubar(), which is usually more convenient
+ * than calling this function for each accelerator.
+ *
+ * Since: 3.4
*/
void
-gtk_application_set_action_group (GtkApplication *app,
- GtkActionGroup *group)
+gtk_application_add_accelerator (GtkApplication *application,
+ const gchar *accelerator,
+ const gchar *action_name,
+ GVariant *parameter)
{
- GList *actions, *iter;
+ gchar *accel_path;
+ guint accel_key;
+ GdkModifierType accel_mods;
+
+ g_return_if_fail (GTK_IS_APPLICATION (application));
- g_return_if_fail (GTK_IS_APPLICATION (app));
- g_return_if_fail (app->priv->main_actions == NULL);
+ /* Call this here, since gtk_init() is only getting called in startup() */
+ _gtk_accel_map_init ();
- app->priv->main_actions = g_object_ref (group);
- actions = gtk_action_group_list_actions (group);
- for (iter = actions; iter; iter = iter->next)
+ gtk_accelerator_parse (accelerator, &accel_key, &accel_mods);
+
+ if (accel_key == 0)
{
- GtkAction *action = iter->data;
- g_application_add_action (G_APPLICATION (app),
- gtk_action_get_name (action),
- gtk_action_get_tooltip (action));
- g_signal_connect (action, "notify::sensitive",
- G_CALLBACK (on_action_sensitive), app);
+ g_warning ("Failed to parse accelerator: '%s'\n", accelerator);
+ return;
}
- g_list_free (actions);
+
+ accel_path = _gtk_accel_path_for_action (action_name, parameter);
+
+ if (gtk_accel_map_lookup_entry (accel_path, NULL))
+ gtk_accel_map_change_entry (accel_path, accel_key, accel_mods, TRUE);
+ else
+ gtk_accel_map_add_entry (accel_path, accel_key, accel_mods);
+
+ g_free (accel_path);
}
-static gboolean
-gtk_application_on_window_destroy (GtkWidget *window,
- gpointer user_data)
+/**
+ * gtk_application_remove_accelerator:
+ * @application: a #GtkApplication
+ * @action_name: the name of the action to activate
+ * @parameter: (allow-none): parameter to pass when activating the action,
+ * or %NULL if the action does not accept an activation parameter
+ *
+ * Removes an accelerator that has been previously added
+ * with gtk_application_add_accelerator().
+ *
+ * Since: 3.4
+ */
+void
+gtk_application_remove_accelerator (GtkApplication *application,
+ const gchar *action_name,
+ GVariant *parameter)
{
- GtkApplication *app = GTK_APPLICATION (user_data);
+ gchar *accel_path;
- app->priv->windows = g_slist_remove (app->priv->windows, window);
+ g_return_if_fail (GTK_IS_APPLICATION (application));
- if (app->priv->windows == NULL)
- gtk_application_quit (app);
+ accel_path = _gtk_accel_path_for_action (action_name, parameter);
- return FALSE;
-}
+ if (!gtk_accel_map_lookup_entry (accel_path, NULL))
+ {
+ g_warning ("No accelerator found for '%s'\n", accel_path);
+ g_free (accel_path);
+ return;
+ }
-static gchar *default_title;
+ gtk_accel_map_change_entry (accel_path, 0, 0, FALSE);
+ g_free (accel_path);
+}
/**
- * gtk_application_add_window:
- * @app: a #GtkApplication
- * @window: a toplevel window to add to @app
+ * gtk_application_set_app_menu:
+ * @application: a #GtkApplication
+ * @app_menu: (allow-none): a #GMenuModel, or %NULL
*
- * Adds a window to the #GtkApplication.
+ * Sets or unsets the application menu for @application.
*
- * If the user closes all of the windows added to @app, the default
- * behaviour is to call gtk_application_quit().
+ * The application menu is a single menu containing items that typically
+ * impact the application as a whole, rather than acting on a specific
+ * window or document. For example, you would expect to see
+ * "Preferences" or "Quit" in an application menu, but not "Save" or
+ * "Print".
*
- * If your application uses only a single toplevel window, you can
- * use gtk_application_get_window().
+ * If supported, the application menu will be rendered by the desktop
+ * environment.
*
- * Since: 3.0
+ * Since: 3.4
*/
void
-gtk_application_add_window (GtkApplication *app,
- GtkWindow *window)
+gtk_application_set_app_menu (GtkApplication *application,
+ GMenuModel *app_menu)
{
- app->priv->windows = g_slist_prepend (app->priv->windows, window);
+ g_return_if_fail (GTK_IS_APPLICATION (application));
- if (gtk_window_get_title (window) == NULL && default_title != NULL)
- gtk_window_set_title (window, default_title);
+ if (app_menu != application->priv->app_menu)
+ {
+ if (application->priv->app_menu != NULL)
+ g_object_unref (application->priv->app_menu);
- g_signal_connect (window, "destroy",
- G_CALLBACK (gtk_application_on_window_destroy), app);
+ application->priv->app_menu = app_menu;
+
+ if (application->priv->app_menu != NULL)
+ g_object_ref (application->priv->app_menu);
+
+ extract_accels_from_menu (app_menu, application);
+
+#ifdef GDK_WINDOWING_X11
+ gtk_application_set_app_menu_x11 (application, app_menu);
+#endif
+
+ g_object_notify (G_OBJECT (application), "app-menu");
+ }
}
/**
- * gtk_application_get_window:
- * @app: a #GtkApplication
+ * gtk_application_get_app_menu:
+ * @application: a #GtkApplication
*
- * A simple #GtkApplication has a "default window". This window should
- * act as the primary user interaction point with your application.
- * The window returned by this function is of type #GTK_WINDOW_TYPE_TOPLEVEL
- * and its properties such as "title" and "icon-name" will be initialized
- * as appropriate for the platform.
+ * Returns the menu model that has been set with
+ * gtk_application_set_app_menu().
*
- * If the user closes this window, and your application hasn't created
- * any other windows, the default action will be to call gtk_application_quit().
+ * Returns: (transfer none): the application menu of @application
*
- * If your application has more than one toplevel window (e.g. an
- * single-document-interface application with multiple open documents),
- * or if you are constructing your toplevel windows yourself (e.g. using
- * #GtkBuilder), use gtk_application_add_window() instead.
- *
- * Returns: (transfer none): The default #GtkWindow for this application
- *
- * Since: 3.0
+ * Since: 3.4
*/
-GtkWindow *
-gtk_application_get_window (GtkApplication *app)
+GMenuModel *
+gtk_application_get_app_menu (GtkApplication *application)
{
- if (app->priv->default_window != NULL)
- return app->priv->default_window;
-
- app->priv->default_window = GTK_WINDOW (gtk_window_new (GTK_WINDOW_TOPLEVEL));
- g_object_ref_sink (app->priv->default_window);
+ g_return_val_if_fail (GTK_IS_APPLICATION (application), NULL);
- gtk_application_add_window (app, app->priv->default_window);
-
- return app->priv->default_window;
+ return application->priv->app_menu;
}
/**
- * gtk_application_run:
- * @app: a #GtkApplication
+ * gtk_application_set_menubar:
+ * @application: a #GtkApplication
+ * @menubar: (allow-none): a #GMenuModel, or %NULL
*
- * Runs the main loop; see g_application_run().
- * The default implementation for #GtkApplication uses gtk_main().
+ * Sets or unsets the menubar for windows of @application.
*
- * Since: 3.0
+ * This is a menubar in the traditional sense.
+ *
+ * Depending on the desktop environment, this may appear at the top of
+ * each window, or at the top of the screen. In some environments, if
+ * both the application menu and the menubar are set, the application
+ * menu will be presented as if it were the first item of the menubar.
+ * Other environments treat the two as completely separate -- for
+ * example, the application menu may be rendered by the desktop shell
+ * while the menubar (if set) remains in each individual window.
+ *
+ * Since: 3.4
*/
void
-gtk_application_run (GtkApplication *app)
+gtk_application_set_menubar (GtkApplication *application,
+ GMenuModel *menubar)
{
- g_application_run (G_APPLICATION (app));
+ g_return_if_fail (GTK_IS_APPLICATION (application));
+
+ if (menubar != application->priv->menubar)
+ {
+ if (application->priv->menubar != NULL)
+ g_object_unref (application->priv->menubar);
+
+ application->priv->menubar = menubar;
+
+ if (application->priv->menubar != NULL)
+ g_object_ref (application->priv->menubar);
+
+ extract_accels_from_menu (menubar, application);
+
+#ifdef GDK_WINDOWING_X11
+ gtk_application_set_menubar_x11 (application, menubar);
+#endif
+
+ g_object_notify (G_OBJECT (application), "menubar");
+ }
}
/**
- * gtk_application_quit:
- * @app: a #GtkApplication
+ * gtk_application_get_menubar:
+ * @application: a #GtkApplication
*
- * Request the application exit. This function invokes
- * g_application_quit_with_data(), which normally will
- * in turn cause @app to emit #GtkApplication::quit.
+ * Returns the menu model that has been set with
+ * gtk_application_set_menubar().
*
- * To control an application's quit behavior (for example, to ask for
- * files to be saved), connect to the #GtkApplication::quit signal
- * handler.
+ * Returns: (transfer none): the menubar for windows of @application
*
- * Since: 3.0
+ * Since: 3.4
*/
-void
-gtk_application_quit (GtkApplication *app)
+GMenuModel *
+gtk_application_get_menubar (GtkApplication *application)
{
- GVariantBuilder builder;
- GVariant *platform_data;
+ g_return_val_if_fail (GTK_IS_APPLICATION (application), NULL);
- g_variant_builder_init (&builder, G_VARIANT_TYPE ("a{sv}"));
- g_variant_builder_add (&builder, "{sv}",
- "timestamp",
- g_variant_new ("u",
- gtk_get_current_event_time ()));
- platform_data = g_variant_builder_end (&builder);
-
- g_application_quit_with_data (G_APPLICATION (app), platform_data);
-
- g_variant_unref (platform_data);
+ return application->priv->menubar;
}
+#if defined(GDK_WINDOWING_X11)
+
+/* D-Bus Session Management
+ *
+ * The protocol and the D-Bus API are described here:
+ * http://live.gnome.org/SessionManagement/GnomeSession
+ * http://people.gnome.org/~mccann/gnome-session/docs/gnome-session.html
+ */
+
static void
-gtk_application_get_property (GObject *object,
- guint prop_id,
- GValue *value,
- GParamSpec *pspec)
+unregister_client (GtkApplication *app)
{
- GtkApplication *app = GTK_APPLICATION (object);
+ GError *error = NULL;
- switch (prop_id)
+ g_debug ("Unregistering client");
+
+ g_dbus_proxy_call_sync (app->priv->sm_proxy,
+ "UnregisterClient",
+ g_variant_new ("(o)", app->priv->client_path),
+ G_DBUS_CALL_FLAGS_NONE,
+ G_MAXINT,
+ NULL,
+ &error);
+
+ if (error)
{
- case PROP_WINDOW:
- g_value_set_object (value, gtk_application_get_window (app));
- break;
- default:
- G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+ g_warning ("Failed to unregister client: %s", error->message);
+ g_error_free (error);
}
+
+ g_clear_object (&app->priv->client_proxy);
+
+ g_free (app->priv->client_path);
+ app->priv->client_path = NULL;
}
static void
-gtk_application_set_property (GObject *object,
- guint prop_id,
- const GValue *value,
- GParamSpec *pspec)
+gtk_application_quit_response (GtkApplication *application,
+ gboolean will_quit,
+ const gchar *reason)
{
- GtkApplication *app = GTK_APPLICATION (object);
-
- g_assert (app != NULL);
-
- switch (prop_id)
+ g_debug ("Calling EndSessionResponse %d '%s'", will_quit, reason);
+
+ g_dbus_proxy_call (application->priv->client_proxy,
+ "EndSessionResponse",
+ g_variant_new ("(bs)", will_quit, reason ? reason : ""),
+ G_DBUS_CALL_FLAGS_NONE,
+ G_MAXINT,
+ NULL, NULL, NULL);
+}
+static void
+client_proxy_signal (GDBusProxy *proxy,
+ const gchar *sender_name,
+ const gchar *signal_name,
+ GVariant *parameters,
+ GtkApplication *app)
+{
+ if (strcmp (signal_name, "QueryEndSession") == 0)
+ {
+ g_debug ("Received QueryEndSession");
+ gtk_application_quit_response (app, TRUE, NULL);
+ }
+ else if (strcmp (signal_name, "CancelEndSession") == 0)
+ {
+ g_debug ("Received CancelEndSession");
+ }
+ else if (strcmp (signal_name, "EndSession") == 0)
+ {
+ g_debug ("Received EndSession");
+ gtk_application_quit_response (app, TRUE, NULL);
+ unregister_client (app);
+ g_application_quit (G_APPLICATION (app));
+ }
+ else if (strcmp (signal_name, "Stop") == 0)
{
- default:
- G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+ g_debug ("Received Stop");
+ unregister_client (app);
+ g_application_quit (G_APPLICATION (app));
}
}
static void
-setup_default_window_decorations (void)
+gtk_application_startup_session_dbus (GtkApplication *app)
{
- const gchar *pid;
- const gchar *filename;
- GKeyFile *keyfile;
- gchar *title;
- gchar *icon_name;
+ static gchar *client_id;
+ GError *error = NULL;
+ GVariant *res;
+
+ if (app->priv->session_bus == NULL)
+ return;
+
+ if (client_id == NULL)
+ {
+ const gchar *desktop_autostart_id;
+
+ desktop_autostart_id = g_getenv ("DESKTOP_AUTOSTART_ID");
+ /* Unset DESKTOP_AUTOSTART_ID in order to avoid child processes to
+ * use the same client id.
+ */
+ g_unsetenv ("DESKTOP_AUTOSTART_ID");
+ client_id = g_strdup (desktop_autostart_id ? desktop_autostart_id : "");
+ }
+
+ g_debug ("Connecting to session manager");
+
+ app->priv->sm_proxy = g_dbus_proxy_new_sync (app->priv->session_bus,
+ G_DBUS_PROXY_FLAGS_DO_NOT_LOAD_PROPERTIES |
+ G_DBUS_PROXY_FLAGS_DO_NOT_CONNECT_SIGNALS,
+ NULL,
+ "org.gnome.SessionManager",
+ "/org/gnome/SessionManager",
+ "org.gnome.SessionManager",
+ NULL,
+ &error);
+ if (error)
+ {
+ g_warning ("Failed to get a session proxy: %s", error->message);
+ g_error_free (error);
+ return;
+ }
- pid = g_getenv ("GIO_LAUNCHED_DESKTOP_FILE_PID");
- filename = g_getenv ("GIO_LAUNCHED_DESKTOP_FILE");
+ /* FIXME: should we reuse the D-Bus application id here ? */
+ app->priv->app_id = g_strdup (g_get_prgname ());
- keyfile = g_key_file_new ();
+ if (!app->priv->register_session)
+ return;
- if (pid != NULL && filename != NULL && atoi (pid) == getpid () &&
- g_key_file_load_from_file (keyfile, filename, 0, NULL))
+ g_debug ("Registering client '%s' '%s'", app->priv->app_id, client_id);
+
+ res = g_dbus_proxy_call_sync (app->priv->sm_proxy,
+ "RegisterClient",
+ g_variant_new ("(ss)", app->priv->app_id, client_id),
+ G_DBUS_CALL_FLAGS_NONE,
+ G_MAXINT,
+ NULL,
+ &error);
+
+ if (error)
{
- title = g_key_file_get_locale_string (keyfile, G_KEY_FILE_DESKTOP_GROUP, G_KEY_FILE_DESKTOP_KEY_NAME, NULL, NULL);
- icon_name = g_key_file_get_string (keyfile, G_KEY_FILE_DESKTOP_GROUP, G_KEY_FILE_DESKTOP_KEY_ICON, NULL);
+ g_warning ("Failed to register client: %s", error->message);
+ g_error_free (error);
+ g_clear_object (&app->priv->sm_proxy);
+ return;
+ }
- if (default_title == NULL)
- default_title = title;
+ g_variant_get (res, "(o)", &app->priv->client_path);
+ g_variant_unref (res);
- if (gtk_window_get_default_icon_name () == NULL)
- gtk_window_set_default_icon_name (icon_name);
+ g_debug ("Registered client at '%s'", app->priv->client_path);
- g_free (icon_name);
+ app->priv->client_proxy = g_dbus_proxy_new_sync (app->priv->session_bus, 0,
+ NULL,
+ "org.gnome.SessionManager",
+ app->priv->client_path,
+ "org.gnome.SessionManager.ClientPrivate",
+ NULL,
+ &error);
+ if (error)
+ {
+ g_warning ("Failed to get client proxy: %s", error->message);
+ g_error_free (error);
+ g_clear_object (&app->priv->sm_proxy);
+ g_free (app->priv->client_path);
+ app->priv->client_path = NULL;
+ return;
}
- g_key_file_free (keyfile);
+ g_signal_connect (app->priv->client_proxy, "g-signal", G_CALLBACK (client_proxy_signal), app);
}
-static void
-gtk_application_init (GtkApplication *application)
+
+
+/**
+ * GtkApplicationInhibitFlags:
+ * @GTK_APPLICATION_INHIBIT_LOGOUT: Inhibit ending the user session
+ * by logging out or by shutting down the computer
+ * @GTK_APPLICATION_INHIBIT_SWITCH: Inhibit user switching
+ * @GTK_APPLICATION_INHIBIT_SUSPEND: Inhibit suspending the
+ * session or computer
+ * @GTK_APPLICATION_INHIBIT_IDLE: Inhibit the session being
+ * marked as idle (and possibly locked)
+ *
+ * Types of user actions that may be blocked by gtk_application_inhibit().
+ *
+ * Since: 3.4
+ */
+
+/**
+ * gtk_application_inhibit:
+ * @application: the #GApplication
+ * @window: (allow-none): a #GtkWindow, or %NULL
+ * @flags: what types of actions should be inhibited
+ * @reason: (allow-none): a short, human-readable string that explains
+ * why these operations are inhibited
+ *
+ * Inform the session manager that certain types of actions should be
+ * inhibited. This is not guaranteed to work on all platforms and for
+ * all types of actions.
+ *
+ * Applications should invoke this method when they begin an operation
+ * that should not be interrupted, such as creating a CD or DVD. The
+ * types of actions that may be blocked are specified by the @flags
+ * parameter. When the application completes the operation it should
+ * call g_application_uninhibit() to remove the inhibitor. Note that
+ * an application can have multiple inhibitors, and all of the must
+ * be individually removed. Inhibitors are also cleared when the
+ * application exits.
+ *
+ * Applications should not expect that they will always be able to block
+ * the action. In most cases, users will be given the option to force
+ * the action to take place.
+ *
+ * Reasons should be short and to the point.
+ *
+ * If @window is given, the session manager may point the user to
+ * this window to find out more about why the action is inhibited.
+ *
+ * Returns: A non-zero cookie that is used to uniquely identify this
+ * request. It should be used as an argument to g_application_uninhibit()
+ * in order to remove the request. If the platform does not support
+ * inhibiting or the request failed for some reason, 0 is returned.
+ *
+ * Since: 3.4
+ */
+guint
+gtk_application_inhibit (GtkApplication *application,
+ GtkWindow *window,
+ GtkApplicationInhibitFlags flags,
+ const gchar *reason)
{
- application->priv = G_TYPE_INSTANCE_GET_PRIVATE (application, GTK_TYPE_APPLICATION, GtkApplicationPrivate);
+ GVariant *res;
+ GError *error = NULL;
+ guint cookie;
+ guint xid;
+
+ g_return_val_if_fail (GTK_IS_APPLICATION (application), 0);
+ g_return_val_if_fail (!g_application_get_is_remote (G_APPLICATION (application)), 0);
+ g_return_val_if_fail (application->priv->sm_proxy != NULL, 0);
- setup_default_window_decorations ();
+ if (window != NULL)
+ xid = GDK_WINDOW_XID (gtk_widget_get_window (GTK_WIDGET (window)));
+ else
+ xid = 0;
+
+ res = g_dbus_proxy_call_sync (application->priv->sm_proxy,
+ "Inhibit",
+ g_variant_new ("(susu)",
+ application->priv->app_id,
+ xid,
+ reason,
+ flags),
+ G_DBUS_CALL_FLAGS_NONE,
+ G_MAXINT,
+ NULL,
+ &error);
+ if (error)
+ {
+ g_warning ("Calling Inhibit failed: %s", error->message);
+ g_error_free (error);
+ return 0;
+ }
+
+ g_variant_get (res, "(u)", &cookie);
+ g_variant_unref (res);
+
+ return cookie;
}
+/**
+ * gtk_application_uninhibit:
+ * @application: the #GApplication
+ * @cookie: a cookie that was returned by g_application_inhibit()
+ *
+ * Removes an inhibitor that has been established with g_application_inhibit().
+ * Inhibitors are also cleared when the application exits.
+ *
+ * Since: 3.4
+ */
+void
+gtk_application_uninhibit (GtkApplication *application,
+ guint cookie)
+{
+ g_return_if_fail (GTK_IS_APPLICATION (application));
+ g_return_if_fail (!g_application_get_is_remote (G_APPLICATION (application)));
+ g_return_if_fail (application->priv->sm_proxy != NULL);
+
+ g_dbus_proxy_call (application->priv->sm_proxy,
+ "Uninhibit",
+ g_variant_new ("(u)", cookie),
+ G_DBUS_CALL_FLAGS_NONE,
+ G_MAXINT,
+ NULL, NULL, NULL);
+}
-static GObject*
-gtk_application_constructor (GType type,
- guint n_construct_properties,
- GObjectConstructParam *construct_params)
+/**
+ * gtk_application_is_inhibited:
+ * @application: the #GApplication
+ * @flags: what types of actions should be queried
+ *
+ * Determines if any of the actions specified in @flags are
+ * currently inhibited (possibly by another application).
+ *
+ * Returns: %TRUE if any of the actions specified in @flags are inhibited
+ *
+ * Since: 3.4
+ */
+gboolean
+gtk_application_is_inhibited (GtkApplication *application,
+ GtkApplicationInhibitFlags flags)
{
- GObject *object;
+ GVariant *res;
+ GError *error = NULL;
+ gboolean inhibited;
+
+ g_return_val_if_fail (GTK_IS_APPLICATION (application), FALSE);
+ g_return_val_if_fail (!g_application_get_is_remote (G_APPLICATION (application)), FALSE);
+ g_return_val_if_fail (application->priv->sm_proxy != NULL, FALSE);
+
+ res = g_dbus_proxy_call_sync (application->priv->sm_proxy,
+ "IsInhibited",
+ g_variant_new ("(u)", flags),
+ G_DBUS_CALL_FLAGS_NONE,
+ G_MAXINT,
+ NULL,
+ &error);
+ if (error)
+ {
+ g_warning ("Calling IsInhibited failed: %s", error->message);
+ g_error_free (error);
+ return FALSE;
+ }
+
+ g_variant_get (res, "(b)", &inhibited);
+ g_variant_unref (res);
- /* Last ditch effort here */
- gtk_init (0, NULL);
+ return inhibited;
+}
- object = (* G_OBJECT_CLASS (gtk_application_parent_class)->constructor) (type,
- n_construct_properties,
- construct_params);
+#elif defined(GDK_WINDOWING_QUARTZ)
- return object;
+/* OS X implementation copied from EggSMClient, but simplified since
+ * it doesn't need to interact with the user.
+ */
+
+static gboolean
+idle_will_quit (gpointer data)
+{
+ GtkApplication *app = data;
+
+ if (app->priv->quit_inhibit == 0)
+ g_application_quit (G_APPLICATION (app));
+ else
+ {
+ GtkApplicationQuartzInhibitor *inhibitor;
+ GSList *iter;
+ GtkWidget *dialog;
+
+ for (iter = app->priv->inhibitors; iter; iter = iter->next)
+ {
+ inhibitor = iter->data;
+ if (inhibitor->flags & GTK_APPLICATION_INHIBIT_LOGOUT)
+ break;
+ }
+ g_assert (inhibitor != NULL);
+
+ dialog = gtk_message_dialog_new (inhibitor->window,
+ GTK_DIALOG_MODAL,
+ GTK_MESSAGE_ERROR,
+ GTK_BUTTONS_OK,
+ _("%s cannot quit at this time:\n\n%s"),
+ g_get_application_name (),
+ inhibitor->reason);
+ g_signal_connect_swapped (dialog,
+ "response",
+ G_CALLBACK (gtk_widget_destroy),
+ dialog);
+ gtk_widget_show_all (dialog);
+ }
+
+ return G_SOURCE_REMOVE;
+}
+
+static pascal OSErr
+quit_requested (const AppleEvent *aevt,
+ AppleEvent *reply,
+ long refcon)
+{
+ GtkApplication *app = GSIZE_TO_POINTER ((gsize)refcon);
+
+ /* Don't emit the "quit" signal immediately, since we're
+ * called from a weird point in the guts of gdkeventloop-quartz.c
+ */
+ g_idle_add_full (G_PRIORITY_DEFAULT, idle_will_quit, app, NULL);
+
+ return app->priv->quit_inhibit == 0 ? noErr : userCanceledErr;
}
static void
-gtk_application_class_init (GtkApplicationClass *klass)
+gtk_application_startup_session_quartz (GtkApplication *app)
{
- GObjectClass *gobject_class;
- GApplicationClass *application_class;
+ if (app->priv->register_session)
+ AEInstallEventHandler (kCoreEventClass, kAEQuitApplication,
+ NewAEEventHandlerUPP (quit_requested),
+ (long)GPOINTER_TO_SIZE (app), false);
+}
- gobject_class = G_OBJECT_CLASS (klass);
- application_class = G_APPLICATION_CLASS (klass);
+guint
+gtk_application_inhibit (GtkApplication *application,
+ GtkWindow *window,
+ GtkApplicationInhibitFlags flags,
+ const gchar *reason)
+{
+ GtkApplicationQuartzInhibitor *inhibitor;
- gobject_class->constructor = gtk_application_constructor;
- gobject_class->get_property = gtk_application_get_property;
- gobject_class->set_property = gtk_application_set_property;
+ g_return_val_if_fail (GTK_IS_APPLICATION (application), 0);
+ g_return_val_if_fail (flags != 0, 0);
- application_class->run = gtk_application_default_run;
- application_class->quit_with_data = gtk_application_default_quit_with_data;
- application_class->action_with_data = gtk_application_default_action_with_data;
- application_class->prepare_activation = gtk_application_default_prepare_activation;
+ inhibitor = g_slice_new (GtkApplicationQuartzInhibitor);
+ inhibitor->cookie = ++application->priv->next_cookie;
+ inhibitor->flags = flags;
+ inhibitor->reason = g_strdup (reason);
+ inhibitor->window = window ? g_object_ref (window) : NULL;
- klass->quit = gtk_application_default_quit;
- klass->action = gtk_application_default_action;
+ application->priv->inhibitors = g_slist_prepend (application->priv->inhibitors, inhibitor);
- klass->activated = gtk_application_default_activated;
+ if (flags & GTK_APPLICATION_INHIBIT_LOGOUT)
+ application->priv->quit_inhibit++;
- /**
- * GtkApplication::activated:
- * @arguments: A #GVariant with the signature "aay"
- *
- * This signal is emitted when a non-primary process for a given
- * application is invoked while your application is running; for
- * example, when a file browser launches your program to open a
- * file. The raw operating system arguments are passed in the
- * variant @arguments.
- */
+ return inhibitor->cookie;
+}
- gtk_application_signals[ACTIVATED] =
- g_signal_new (g_intern_static_string ("activated"),
- G_OBJECT_CLASS_TYPE (klass),
- G_SIGNAL_RUN_LAST,
- G_STRUCT_OFFSET (GtkApplicationClass, activated),
- NULL, NULL,
- g_cclosure_marshal_VOID__BOXED,
- G_TYPE_NONE, 1,
- G_TYPE_VARIANT);
+void
+gtk_application_uninhibit (GtkApplication *application,
+ guint cookie)
+{
+ GSList *iter;
- /**
- * GtkApplication::quit:
- * @application: the object on which the signal is emitted
- *
- * This signal is emitted when a quit is initiated. See also
- * the #GApplication::quit-with-data signal which may in
- * turn trigger this signal.
- *
- * The default handler for this signal exits the mainloop of the
- * application.
- *
- * Returns: %TRUE if the signal has been handled, %FALSE to continue
- * signal emission
- */
- gtk_application_signals[QUIT] =
- g_signal_new (g_intern_static_string ("quit"),
- G_OBJECT_CLASS_TYPE (klass),
- G_SIGNAL_RUN_LAST,
- G_STRUCT_OFFSET (GtkApplicationClass, quit),
- g_signal_accumulator_true_handled, NULL,
- _gtk_marshal_BOOLEAN__VOID,
- G_TYPE_BOOLEAN, 0);
+ for (iter = application->priv->inhibitors; iter; iter = iter->next)
+ {
+ GtkApplicationQuartzInhibitor *inhibitor = iter->data;
+
+ if (inhibitor->cookie == cookie)
+ {
+ if (inhibitor->flags & GTK_APPLICATION_INHIBIT_LOGOUT)
+ application->priv->quit_inhibit--;
+ gtk_application_quartz_inhibitor_free (inhibitor);
+ application->priv->inhibitors = g_slist_delete_link (application->priv->inhibitors, iter);
+ return;
+ }
+ }
- /**
- * GtkApplication::action:
- * @application: the object on which the signal is emitted
- * @name: The name of the activated action
- *
- * This signal is emitted when an action is activated. The action name
- * is passed as the first argument, but also as signal detail, so it
- * is possible to connect to this signal for individual actions.
- *
- * See also the #GApplication::action-with-data signal which may in
- * turn trigger this signal.
- *
- * The signal is never emitted for disabled actions.
- */
- gtk_application_signals[ACTION] =
- g_signal_new (g_intern_static_string ("action"),
- G_OBJECT_CLASS_TYPE (klass),
- G_SIGNAL_RUN_FIRST | G_SIGNAL_NO_RECURSE | G_SIGNAL_DETAILED,
- G_STRUCT_OFFSET (GtkApplicationClass, action),
- NULL, NULL,
- g_cclosure_marshal_VOID__STRING,
- G_TYPE_NONE, 1,
- G_TYPE_STRING);
-
- g_type_class_add_private (gobject_class, sizeof (GtkApplicationPrivate));
+ g_warning ("Invalid inhibitor cookie");
}
-#define __GTK_APPLICATION_C__
-#include "gtkaliasdef.c"
+gboolean
+gtk_application_is_inhibited (GtkApplication *application,
+ GtkApplicationInhibitFlags flags)
+{
+ if (flags & GTK_APPLICATION_INHIBIT_LOGOUT)
+ return application->priv->quit_inhibit > 0;
+
+ return FALSE;
+}
+
+#else
+
+/* Trivial implementation.
+ *
+ * For the inhibit API on Windows, see
+ * http://msdn.microsoft.com/en-us/library/ms700677%28VS.85%29.aspx
+ */
+
+guint
+gtk_application_inhibit (GtkApplication *application,
+ GtkWindow *window,
+ GtkApplicationInhibitFlags flags,
+ const gchar *reason)
+{
+ return 0;
+}
+
+void
+gtk_application_uninhibit (GtkApplication *application,
+ guint cookie)
+{
+}
+
+gboolean
+gtk_application_is_inhibited (GtkApplication *application,
+ GtkApplicationInhibitFlags flags)
+{
+ return FALSE;
+}
+
+#endif
projects / ~andy / gtk / blobdiff