* When invoking an action by calling g_action_group_activate_action() on
* the application, it is always invoked in the primary instance.
*
+ * There is a number of different entry points into a #GApplication:
+ * <itemizedlist>
+ * <listitem>via 'Activate' (i.e. just starting the application)</listitem>
+ * <listitem>via 'Open' (i.e. opening some files)</listitem>
+ * <listitem>via activating an action</listitem>
+ * </itemizedlist>
+ * The #GApplication::startup signal lets you handle the application
+ * initialization for all of these in a single place.
+ *
* <example id="gapplication-example-open"><title>Opening files with a GApplication</title>
* <programlisting>
* <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="text" href="../../../../gio/tests/gapplication-example-open.c">
static void
activate (GApplication *application)
{
- g_application_hold (application);
g_print ("activated\n");
- g_application_release (application);
}
static void
{
GApplication *application = data;
- g_application_hold (application);
g_print ("action %s activated\n", g_action_get_name (action));
- g_application_release (application);
}
static void
GVariant *state;
gboolean b;
- g_application_hold (application);
g_print ("action %s activated\n", g_action_get_name (action));
state = g_action_get_state (action);
g_variant_unref (state);
g_action_set_state (action, g_variant_new_boolean (!b));
g_print ("state change %d -> %d\n", b, !b);
-
- g_application_release (application);
}
static void
gint argc;
gint i;
- g_application_hold (application);
-
argv = g_application_command_line_get_arguments (cmdline, &argc);
g_application_command_line_print (cmdline,
g_strfreev (argv);
- g_application_release (application);
-
return 0;
}
gint argc;
gint i;
- g_application_hold (application);
-
argv = g_application_command_line_get_arguments (cmdline, &argc);
for (i = 0; i < argc; i++)
g_strfreev (argv);
- g_application_release (application);
-
return 0;
}
static void
activate (GApplication *application)
{
- g_application_hold (application);
g_print ("activated\n");
- g_application_release (application);
+
+ /* Note: when doing a longer-lasting action here that returns
+ * to the mainloop, you should use g_application_hold() and
+ * g_application_release() to keep the application alive until
+ * the action is completed.
+ */
}
static void
{
gint i;
- g_application_hold (application);
-
for (i = 0; i < n_files; i++)
{
gchar *uri = g_file_get_uri (files[i]);
g_free (uri);
}
- g_application_release (application);
+ /* Note: when doing a longer-lasting action here that returns
+ * to the mainloop, you should use g_application_hold() and
+ * g_application_release() to keep the application alive until
+ * the action is completed.
+ */
}
int