luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-10-31 16:32:18 +01:00
Code Issues Packages Projects Releases Wiki Activity
Files
bfc4dee85fe6928f9d700bccfd9ebe63aa7c75a2
glib/gio/gapplication.h

264 lines
15 KiB
C
Raw Normal View History

new GApplication implementation
2010-10-06 13:08:26 -04:00
/*
* Copyright © 2010 Codethink Limited
Merge the wip/gapplication branch This adds a GApplication object to GIO, which is the core of an application support class, supporting - uniqueness - exporting actions (simple scripting) - standard actions (quit, activate) The implementation for Linux uses D-Bus, takes a name on the session bus, and exports a org.gtk.Application interface. Implementations for Win32 and OS X are still missing.
2010-06-07 13:25:39 -04:00
*
gio: Add SPDX license headers automatically Add SPDX license (but not copyright) headers to all files which follow a certain pattern in their existing non-machine-readable header comment. This commit was entirely generated using the command: ``` git ls-files gio/*.[ch] | xargs perl -0777 -pi -e 's/\n \*\n \* This library is free software; you can redistribute it and\/or\n \* modify it under the terms of the GNU Lesser General Public/\n \*\n \* SPDX-License-Identifier: LGPL-2.1-or-later\n \*\n \* This library is free software; you can redistribute it and\/or\n \* modify it under the terms of the GNU Lesser General Public/igs' ``` Signed-off-by: Philip Withnall <pwithnall@endlessos.org> Helps: #1415
2022-05-18 09:12:45 +01:00
* SPDX-License-Identifier: LGPL-2.1-or-later
*
gio/: LGPLv2+ -> LGPLv2.1+ Sub-directories inside gio/ already processed in a previous commit: - fam/ - gdbus-2.0/ (which contains only codegen/) - gvdb/ - inotify/ - tests/ - win32/ - xdgmime/ Other sub-directories inside gio/: - completion/: no license headers - kqueue/: not LGPL, BSD-style license https://bugzilla.gnome.org/show_bug.cgi?id=776504
2017-05-27 18:21:30 +02:00
* 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.1 of the License, or (at your option) any later version.
Merge the wip/gapplication branch This adds a GApplication object to GIO, which is the core of an application support class, supporting - uniqueness - exporting actions (simple scripting) - standard actions (quit, activate) The implementation for Linux uses D-Bus, takes a name on the session bus, and exports a org.gtk.Application interface. Implementations for Win32 and OS X are still missing.
2010-06-07 13:25:39 -04:00
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General
Updated FSF's address
2014-01-23 12:58:29 +01:00
* Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
Merge the wip/gapplication branch This adds a GApplication object to GIO, which is the core of an application support class, supporting - uniqueness - exporting actions (simple scripting) - standard actions (quit, activate) The implementation for Linux uses D-Bus, takes a name on the session bus, and exports a org.gtk.Application interface. Implementations for Win32 and OS X are still missing.
2010-06-07 13:25:39 -04:00
*
new GApplication implementation
2010-10-06 13:08:26 -04:00
* Authors: Ryan Lortie <desrt@desrt.ca>
Merge the wip/gapplication branch This adds a GApplication object to GIO, which is the core of an application support class, supporting - uniqueness - exporting actions (simple scripting) - standard actions (quit, activate) The implementation for Linux uses D-Bus, takes a name on the session bus, and exports a org.gtk.Application interface. Implementations for Win32 and OS X are still missing.
2010-06-07 13:25:39 -04:00
*/
Move single-include guards inside include guards gcc has optimizations for include guards that only work if they are outermost in the the header. https://bugzilla.gnome.org/show_bug.cgi?id=689810
2012-12-27 23:43:14 -05:00
#ifndef __G_APPLICATION_H__
#define __G_APPLICATION_H__
Merge the wip/gapplication branch This adds a GApplication object to GIO, which is the core of an application support class, supporting - uniqueness - exporting actions (simple scripting) - standard actions (quit, activate) The implementation for Linux uses D-Bus, takes a name on the session bus, and exports a org.gtk.Application interface. Implementations for Win32 and OS X are still missing.
2010-06-07 13:25:39 -04:00
#if !defined (__GIO_GIO_H_INSIDE__) && !defined (GIO_COMPILATION)
#error "Only <gio/gio.h> can be included directly."
#endif
#include <gio/giotypes.h>
G_BEGIN_DECLS
new GApplication implementation
2010-10-06 13:08:26 -04:00
#define G_TYPE_APPLICATION (g_application_get_type ())
#define G_APPLICATION(inst) (G_TYPE_CHECK_INSTANCE_CAST ((inst), \
G_TYPE_APPLICATION, GApplication))
#define G_APPLICATION_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), \
G_TYPE_APPLICATION, GApplicationClass))
#define G_IS_APPLICATION(inst) (G_TYPE_CHECK_INSTANCE_TYPE ((inst), G_TYPE_APPLICATION))
#define G_IS_APPLICATION_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), G_TYPE_APPLICATION))
#define G_APPLICATION_GET_CLASS(inst) (G_TYPE_INSTANCE_GET_CLASS ((inst), \
G_TYPE_APPLICATION, GApplicationClass))
Merge the wip/gapplication branch This adds a GApplication object to GIO, which is the core of an application support class, supporting - uniqueness - exporting actions (simple scripting) - standard actions (quit, activate) The implementation for Linux uses D-Bus, takes a name on the session bus, and exports a org.gtk.Application interface. Implementations for Win32 and OS X are still missing.
2010-06-07 13:25:39 -04:00
new GApplication implementation
2010-10-06 13:08:26 -04:00
typedef struct _GApplicationPrivate GApplicationPrivate;
typedef struct _GApplicationClass GApplicationClass;
Merge the wip/gapplication branch This adds a GApplication object to GIO, which is the core of an application support class, supporting - uniqueness - exporting actions (simple scripting) - standard actions (quit, activate) The implementation for Linux uses D-Bus, takes a name on the session bus, and exports a org.gtk.Application interface. Implementations for Win32 and OS X are still missing.
2010-06-07 13:25:39 -04:00
struct _GApplication
{
/*< private >*/
GObject parent_instance;
GApplicationPrivate *priv;
};
struct _GApplicationClass
{
/*< private >*/
GObjectClass parent_class;
/*< public >*/
/* signals */
GApplication: reduce GVariant abuse Don't use GVariant* as the representation for the argument array.
2010-10-19 19:38:00 +02:00
void (* startup) (GApplication *application);
new GApplication implementation
2010-10-06 13:08:26 -04:00
GApplication: reduce GVariant abuse Don't use GVariant* as the representation for the argument array.
2010-10-19 19:38:00 +02:00
void (* activate) (GApplication *application);
new GApplication implementation
2010-10-06 13:08:26 -04:00
GApplication: reduce GVariant abuse Don't use GVariant* as the representation for the argument array.
2010-10-19 19:38:00 +02:00
void (* open) (GApplication *application,
GFile **files,
gint n_files,
const gchar *hint);
new GApplication implementation
2010-10-06 13:08:26 -04:00
GApplication: reduce GVariant abuse Don't use GVariant* as the representation for the argument array.
2010-10-19 19:38:00 +02:00
int (* command_line) (GApplication *application,
GApplicationCommandLine *command_line);
Merge the wip/gapplication branch This adds a GApplication object to GIO, which is the core of an application support class, supporting - uniqueness - exporting actions (simple scripting) - standard actions (quit, activate) The implementation for Linux uses D-Bus, takes a name on the session bus, and exports a org.gtk.Application interface. Implementations for Win32 and OS X are still missing.
2010-06-07 13:25:39 -04:00
/* vfuncs */
Annotate GApplication::local_command_line Also add some documentation. https://bugzilla.gnome.org/show_bug.cgi?id=690670
2012-12-27 20:55:30 +01:00
/**
* GApplicationClass::local_command_line:
* @application: a #GApplication
* @arguments: (inout) (array zero-terminated=1): array of command line arguments
* @exit_status: (out): exit status to fill after processing the command line.
*
* This virtual function is always invoked in the local instance. It
* gets passed a pointer to a %NULL-terminated copy of @argv and is
* expected to remove arguments that it handled (shifting up remaining
* arguments).
*
* The last argument to local_command_line() is a pointer to the @status
* variable which can used to set the exit status that is returned from
* g_application_run().
*
* See g_application_run() for more details on #GApplication startup.
*
* Returns: %TRUE if the commandline has been completely handled
*/
GApplication: reduce GVariant abuse Don't use GVariant* as the representation for the argument array.
2010-10-19 19:38:00 +02:00
gboolean (* local_command_line) (GApplication *application,
gchar ***arguments,
int *exit_status);
gapplication: Validate types of well-known platform data keys The platform data comes from the parent process, which should normally be considered trusted (if we don’t trust it, it can do all sorts of other things to mess this process up, such as setting `LD_LIBRARY_PATH`). However, it can also come from any process which calls `CommandLine` over D-Bus, so always has to be able to handle untrusted input. In particular, `v`-typed `GVariant`s must always have their dynamic type validated before having values of a static type retrieved from them. Includes unit tests. Signed-off-by: Philip Withnall <pwithnall@endlessos.org> Helps: #1904
2022-11-10 23:12:49 +00:00
/* @platform_data comes from an external process and is untrusted. All value types
* must be validated before being used. */
GApplication: reduce GVariant abuse Don't use GVariant* as the representation for the argument array.
2010-10-19 19:38:00 +02:00
void (* before_emit) (GApplication *application,
GVariant *platform_data);
gapplication: Validate types of well-known platform data keys The platform data comes from the parent process, which should normally be considered trusted (if we don’t trust it, it can do all sorts of other things to mess this process up, such as setting `LD_LIBRARY_PATH`). However, it can also come from any process which calls `CommandLine` over D-Bus, so always has to be able to handle untrusted input. In particular, `v`-typed `GVariant`s must always have their dynamic type validated before having values of a static type retrieved from them. Includes unit tests. Signed-off-by: Philip Withnall <pwithnall@endlessos.org> Helps: #1904
2022-11-10 23:12:49 +00:00
/* Same as for @before_emit. */
GApplication: reduce GVariant abuse Don't use GVariant* as the representation for the argument array.
2010-10-19 19:38:00 +02:00
void (* after_emit) (GApplication *application,
GVariant *platform_data);
void (* add_platform_data) (GApplication *application,
GVariantBuilder *builder);
void (* quit_mainloop) (GApplication *application);
void (* run_mainloop) (GApplication *application);
GApplication: introduce ::shutdown Introduce ::shutdown as a dual to ::startup. https://bugzilla.gnome.org/show_bug.cgi?id=643934
2011-09-14 13:42:35 -04:00
void (* shutdown) (GApplication *application);
Merge the wip/gapplication branch This adds a GApplication object to GIO, which is the core of an application support class, supporting - uniqueness - exporting actions (simple scripting) - standard actions (quit, activate) The implementation for Linux uses D-Bus, takes a name on the session bus, and exports a org.gtk.Application interface. Implementations for Win32 and OS X are still missing.
2010-06-07 13:25:39 -04:00
application: Add dbus register/unregister hooks When the application is using its D-Bus backend, it is useful to be able to export extra D-Bus objects at the right time, i.e. *before* the application tries to own the bus name. This is accomplished here by adding a hook in GApplicationClass for this; and a corresponding hook that will be called on unregistration to undo whatever the register hook did. Bug #675509.
2012-05-05 16:52:28 +02:00
gboolean (* dbus_register) (GApplication *application,
GDBusConnection *connection,
const gchar *object_path,
GError **error);
void (* dbus_unregister) (GApplication *application,
GDBusConnection *connection,
const gchar *object_path);
GApplication: parse command line options Add support for parsing command line options with GApplication. You can add GOptionGroup and GOptionEntry using two new APIs: g_application_add_option_group() and g_application_add_main_option_entries(). Also add a "handle-local-options" signal that allows handling of commandline arguments in the local process without having to override local_command_line. As a special feature, you can have a %NULL @arg_data in a GOptionEntry which will cause the argument to be stored in a GVariantDict. This dictionary is available for inspection and modification by the "handle-local-options" signal and can be forwarded to the primary instance in cases of command line invocation (where it can be fetched using g_application_command_line_get_options()). https://bugzilla.gnome.org/show_bug.cgi?id=721977
2014-01-12 18:14:30 -05:00
gint (* handle_local_options)(GApplication *application,
GVariantDict *options);
GApplication: Add a way to replace a unique instance While uniqueness is great, sometimes you want to restart a newer version of the same app. These two flags make that possible. We also add a ::name-lost signal, that is emitted when it happens. The default handler for this signal just calls g_application_quit(), but applications may want to connect and do cleanup or state-saving here.
2018-08-18 15:35:33 -04:00
gboolean (* name_lost) (GApplication *application);
application: Add dbus register/unregister hooks When the application is using its D-Bus backend, it is useful to be able to export extra D-Bus objects at the right time, i.e. *before* the application tries to own the bus name. This is accomplished here by adding a hook in GApplicationClass for this; and a corresponding hook that will be called on unregistration to undo whatever the register hook did. Bug #675509.
2012-05-05 16:52:28 +02:00
Merge the wip/gapplication branch This adds a GApplication object to GIO, which is the core of an application support class, supporting - uniqueness - exporting actions (simple scripting) - standard actions (quit, activate) The implementation for Linux uses D-Bus, takes a name on the session bus, and exports a org.gtk.Application interface. Implementations for Win32 and OS X are still missing.
2010-06-07 13:25:39 -04:00
/*< private >*/
GApplication: Add a way to replace a unique instance While uniqueness is great, sometimes you want to restart a newer version of the same app. These two flags make that possible. We also add a ::name-lost signal, that is emitted when it happens. The default handler for this signal just calls g_application_quit(), but applications may want to connect and do cleanup or state-saving here.
2018-08-18 15:35:33 -04:00
gpointer padding[7];
Merge the wip/gapplication branch This adds a GApplication object to GIO, which is the core of an application support class, supporting - uniqueness - exporting actions (simple scripting) - standard actions (quit, activate) The implementation for Linux uses D-Bus, takes a name on the session bus, and exports a org.gtk.Application interface. Implementations for Win32 and OS X are still missing.
2010-06-07 13:25:39 -04:00
};
new GApplication implementation
2010-10-06 13:08:26 -04:00
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_ALL
new GApplication implementation
2010-10-06 13:08:26 -04:00
GType g_application_get_type (void) G_GNUC_CONST;
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_ALL
new GApplication implementation
2010-10-06 13:08:26 -04:00
gboolean g_application_id_is_valid (const gchar *application_id);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_ALL
new GApplication implementation
2010-10-06 13:08:26 -04:00
GApplication * g_application_new (const gchar *application_id,
GApplicationFlags flags);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_ALL
new GApplication implementation
2010-10-06 13:08:26 -04:00
const gchar * g_application_get_application_id (GApplication *application);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_ALL
new GApplication implementation
2010-10-06 13:08:26 -04:00
void g_application_set_application_id (GApplication *application,
const gchar *application_id);
gapplication: add GApplication:version property This property is supposed to be used by authors of applications that use GAppliaction to output the version by --version flag or otherwise if a version is needed. Closes #3198 Signed-off-by: Maxim Moskalets <Maxim.Moskalets@kaspersky.com>
2024-02-09 10:04:14 +00:00
GIO_AVAILABLE_IN_2_80
const gchar * g_application_get_version (GApplication *application);
GIO_AVAILABLE_IN_2_80
void g_application_set_version (GApplication *application,
const gchar *version);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_34
GApplication: add accessor for DBus information Provide public access to the GDBusConnect and object path that GApplication is using. Prevents others from having to guess these things for themselves based on the application ID. https://bugzilla.gnome.org/show_bug.cgi?id=671249
2012-04-30 12:20:54 -04:00
GDBusConnection * g_application_get_dbus_connection (GApplication *application);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_34
GApplication: add accessor for DBus information Provide public access to the GDBusConnect and object path that GApplication is using. Prevents others from having to guess these things for themselves based on the application ID. https://bugzilla.gnome.org/show_bug.cgi?id=671249
2012-04-30 12:20:54 -04:00
const gchar * g_application_get_dbus_object_path (GApplication *application);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_ALL
new GApplication implementation
2010-10-06 13:08:26 -04:00
guint g_application_get_inactivity_timeout (GApplication *application);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_ALL
new GApplication implementation
2010-10-06 13:08:26 -04:00
void g_application_set_inactivity_timeout (GApplication *application,
guint inactivity_timeout);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_ALL
new GApplication implementation
2010-10-06 13:08:26 -04:00
GApplicationFlags g_application_get_flags (GApplication *application);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_ALL
new GApplication implementation
2010-10-06 13:08:26 -04:00
void g_application_set_flags (GApplication *application,
GApplicationFlags flags);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_42
GApplication: add a "resource base path" We don't use this for anything inside of GApplication yet, but Gtk is about to start using it to find various bits of the application (such as its menus, icons, etc.). By default, we form the base path from the application ID to end up with the familiar /org/example/app style. https://bugzilla.gnome.org/show_bug.cgi?id=722092
2014-07-04 09:53:51 -04:00
const gchar * g_application_get_resource_base_path (GApplication *application);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_42
GApplication: add a "resource base path" We don't use this for anything inside of GApplication yet, but Gtk is about to start using it to find various bits of the application (such as its menus, icons, etc.). By default, we form the base path from the application ID to end up with the familiar /org/example/app style. https://bugzilla.gnome.org/show_bug.cgi?id=722092
2014-07-04 09:53:51 -04:00
void g_application_set_resource_base_path (GApplication *application,
Fix some introspection warnings
2014-09-16 14:45:34 -06:00
const gchar *resource_path);
GApplication: add a "resource base path" We don't use this for anything inside of GApplication yet, but Gtk is about to start using it to find various bits of the application (such as its menus, icons, etc.). By default, we form the base path from the application ID to end up with the familiar /org/example/app style. https://bugzilla.gnome.org/show_bug.cgi?id=722092
2014-07-04 09:53:51 -04:00
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_DEPRECATED
GApplication: fill in action group implementation
2010-10-11 11:54:51 -04:00
void g_application_set_action_group (GApplication *application,
GActionGroup *action_group);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_40
GApplication: parse command line options Add support for parsing command line options with GApplication. You can add GOptionGroup and GOptionEntry using two new APIs: g_application_add_option_group() and g_application_add_main_option_entries(). Also add a "handle-local-options" signal that allows handling of commandline arguments in the local process without having to override local_command_line. As a special feature, you can have a %NULL @arg_data in a GOptionEntry which will cause the argument to be stored in a GVariantDict. This dictionary is available for inspection and modification by the "handle-local-options" signal and can be forwarded to the primary instance in cases of command line invocation (where it can be fetched using g_application_command_line_get_options()). https://bugzilla.gnome.org/show_bug.cgi?id=721977
2014-01-12 18:14:30 -05:00
void g_application_add_main_option_entries (GApplication *application,
const GOptionEntry *entries);
GApplication: Add g_application_add_main_option This function adds a single main option entry to be handeled by GApplication. The option entry has it arg_data field set to NULL and will be added to the applications packed_options. The rationale for this is that bindings will be able to add command line options even when they can't use the un-boxed struct GOptionEntry. https://bugzilla.gnome.org/show_bug.cgi?id=727455
2014-08-13 07:06:36 -04:00
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_42
GApplication: Add g_application_add_main_option This function adds a single main option entry to be handeled by GApplication. The option entry has it arg_data field set to NULL and will be added to the applications packed_options. The rationale for this is that bindings will be able to add command line options even when they can't use the un-boxed struct GOptionEntry. https://bugzilla.gnome.org/show_bug.cgi?id=727455
2014-08-13 07:06:36 -04:00
void g_application_add_main_option (GApplication *application,
const char *long_name,
char short_name,
g_application_add_main_option: fix type signature The flags argument is a GOptionFlags so use that type instead of 'int'.
2014-09-16 15:39:41 -06:00
GOptionFlags flags,
GApplication: Add g_application_add_main_option This function adds a single main option entry to be handeled by GApplication. The option entry has it arg_data field set to NULL and will be added to the applications packed_options. The rationale for this is that bindings will be able to add command line options even when they can't use the un-boxed struct GOptionEntry. https://bugzilla.gnome.org/show_bug.cgi?id=727455
2014-08-13 07:06:36 -04:00
GOptionArg arg,
const char *description,
const char *arg_description);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_40
GApplication: parse command line options Add support for parsing command line options with GApplication. You can add GOptionGroup and GOptionEntry using two new APIs: g_application_add_option_group() and g_application_add_main_option_entries(). Also add a "handle-local-options" signal that allows handling of commandline arguments in the local process without having to override local_command_line. As a special feature, you can have a %NULL @arg_data in a GOptionEntry which will cause the argument to be stored in a GVariantDict. This dictionary is available for inspection and modification by the "handle-local-options" signal and can be forwarded to the primary instance in cases of command line invocation (where it can be fetched using g_application_command_line_get_options()). https://bugzilla.gnome.org/show_bug.cgi?id=721977
2014-01-12 18:14:30 -05:00
void g_application_add_option_group (GApplication *application,
GOptionGroup *group);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_56
Bug-790839 GApplication command line --help enhancements In order to enrich information displayed by GApplication command line handling when --help is invoked, 3 new methods are proposed: . g_application_set_option_context_parameter_string . g_application_set_option_context_summary . g_application_set_option_context_description Those methods interact with the GApplication's internal GOptionContext which is created for command line parsing in g_application_parse_command_line. (please refer to the GOptionContext class for more information about option context, parameter string, summary and description.) To illustrate the 3 methods, an example is provided: . gapplication-example-cmdline4.c
2017-12-28 08:39:21 +01:00
void g_application_set_option_context_parameter_string (GApplication *application,
const gchar *parameter_string);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_56
Bug-790839 GApplication command line --help enhancements In order to enrich information displayed by GApplication command line handling when --help is invoked, 3 new methods are proposed: . g_application_set_option_context_parameter_string . g_application_set_option_context_summary . g_application_set_option_context_description Those methods interact with the GApplication's internal GOptionContext which is created for command line parsing in g_application_parse_command_line. (please refer to the GOptionContext class for more information about option context, parameter string, summary and description.) To illustrate the 3 methods, an example is provided: . gapplication-example-cmdline4.c
2017-12-28 08:39:21 +01:00
void g_application_set_option_context_summary (GApplication *application,
const gchar *summary);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_56
Bug-790839 GApplication command line --help enhancements In order to enrich information displayed by GApplication command line handling when --help is invoked, 3 new methods are proposed: . g_application_set_option_context_parameter_string . g_application_set_option_context_summary . g_application_set_option_context_description Those methods interact with the GApplication's internal GOptionContext which is created for command line parsing in g_application_parse_command_line. (please refer to the GOptionContext class for more information about option context, parameter string, summary and description.) To illustrate the 3 methods, an example is provided: . gapplication-example-cmdline4.c
2017-12-28 08:39:21 +01:00
void g_application_set_option_context_description (GApplication *application,
const gchar *description);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_ALL
new GApplication implementation
2010-10-06 13:08:26 -04:00
gboolean g_application_get_is_registered (GApplication *application);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_ALL
new GApplication implementation
2010-10-06 13:08:26 -04:00
gboolean g_application_get_is_remote (GApplication *application);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_ALL
new GApplication implementation
2010-10-06 13:08:26 -04:00
gboolean g_application_register (GApplication *application,
GCancellable *cancellable,
GError **error);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_ALL
new GApplication implementation
2010-10-06 13:08:26 -04:00
void g_application_hold (GApplication *application);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_ALL
new GApplication implementation
2010-10-06 13:08:26 -04:00
void g_application_release (GApplication *application);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_ALL
new GApplication implementation
2010-10-06 13:08:26 -04:00
void g_application_activate (GApplication *application);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_ALL
new GApplication implementation
2010-10-06 13:08:26 -04:00
void g_application_open (GApplication *application,
More documentation fixups
2010-10-25 08:42:36 -04:00
GFile **files,
new GApplication implementation
2010-10-06 13:08:26 -04:00
gint n_files,
const gchar *hint);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_ALL
new GApplication implementation
2010-10-06 13:08:26 -04:00
int g_application_run (GApplication *application,
int argc,
char **argv);
Merge the wip/gapplication branch This adds a GApplication object to GIO, which is the core of an application support class, supporting - uniqueness - exporting actions (simple scripting) - standard actions (quit, activate) The implementation for Linux uses D-Bus, takes a name on the session bus, and exports a org.gtk.Application interface. Implementations for Win32 and OS X are still missing.
2010-06-07 13:25:39 -04:00
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_32
GApplication: add g_application_quit() A long requested feature; this quits the application immediately, ignoring the hold count. https://bugzilla.gnome.org/show_bug.cgi?id=670485
2012-02-20 21:41:35 +01:00
void g_application_quit (GApplication *application);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_32
GApplication: add default application
2011-09-29 23:52:16 -04:00
GApplication * g_application_get_default (void);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_32
GApplication: add default application
2011-09-29 23:52:16 -04:00
void g_application_set_default (GApplication *application);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_38
application: introduce methods to mark the application as busy This feature is intended for clients that want to signal a desktop shell their busy state, for instance because a long-running operation is pending. The API works in a similar way to g_application_hold and g_application_release: applications can call g_application_mark_busy() to increase a counter that will keep the application marked as busy until the counter reaches zero again. The busy state is exported read-only on the org.gtk.Application interface for clients to use. https://bugzilla.gnome.org/show_bug.cgi?id=672018
2013-04-03 14:12:03 -04:00
void g_application_mark_busy (GApplication *application);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_38
application: introduce methods to mark the application as busy This feature is intended for clients that want to signal a desktop shell their busy state, for instance because a long-running operation is pending. The API works in a similar way to g_application_hold and g_application_release: applications can call g_application_mark_busy() to increase a counter that will keep the application marked as busy until the counter reaches zero again. The busy state is exported read-only on the org.gtk.Application interface for clients to use. https://bugzilla.gnome.org/show_bug.cgi?id=672018
2013-04-03 14:12:03 -04:00
void g_application_unmark_busy (GApplication *application);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_44
gapplication: add "is-busy" A property to query the current busy state of an application. https://bugzilla.gnome.org/show_bug.cgi?id=744756
2015-02-19 00:33:01 +01:00
gboolean g_application_get_is_busy (GApplication *application);
application: introduce methods to mark the application as busy This feature is intended for clients that want to signal a desktop shell their busy state, for instance because a long-running operation is pending. The API works in a similar way to g_application_hold and g_application_release: applications can call g_application_mark_busy() to increase a counter that will keep the application marked as busy until the counter reaches zero again. The busy state is exported read-only on the org.gtk.Application interface for clients to use. https://bugzilla.gnome.org/show_bug.cgi?id=672018
2013-04-03 14:12:03 -04:00
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_40
Add GNotification https://bugzilla.gnome.org/show_bug.cgi?id=688492
2013-10-15 11:21:10 -04:00
void g_application_send_notification (GApplication *application,
const gchar *id,
GNotification *notification);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_40
Add GNotification https://bugzilla.gnome.org/show_bug.cgi?id=688492
2013-10-15 11:21:10 -04:00
void g_application_withdraw_notification (GApplication *application,
const gchar *id);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_44
gapplication: add bind_busy_property() Balancing g_application_{un,}mark_busy() is non-trivial in some cases. Make it a bit more convenient by allowing to bind multiple boolean properties (from different objects) to the busy state. As long as these properties are true, the application is marked as busy. https://bugzilla.gnome.org/show_bug.cgi?id=744565
2015-02-15 18:54:13 +01:00
void g_application_bind_busy_property (GApplication *application,
gpointer object,
const gchar *property);
Rename all visibility macros
2022-10-05 13:39:21 -04:00
GIO_AVAILABLE_IN_2_44
gapplication: tune busy-binding g_application_bind_busy_property() had the restriction that only one property can be bound per object, so that NULL could be used to unbind. Even though this is enough for most uses, it is a weird API. Lift that restriction and add an explicit unbind function. https://bugzilla.gnome.org/show_bug.cgi?id=744565
2015-02-17 08:39:05 +01:00
void g_application_unbind_busy_property (GApplication *application,
gpointer object,
const gchar *property);
Merge the wip/gapplication branch This adds a GApplication object to GIO, which is the core of an application support class, supporting - uniqueness - exporting actions (simple scripting) - standard actions (quit, activate) The implementation for Linux uses D-Bus, takes a name on the session bus, and exports a org.gtk.Application interface. Implementations for Win32 and OS X are still missing.
2010-06-07 13:25:39 -04:00
G_END_DECLS
#endif /* __G_APPLICATION_H__ */
Reference in New Issue Copy Permalink