mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-12-26 23:46:15 +01:00
cea9de93c8
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
228 lines
12 KiB
C
228 lines
12 KiB
C
/*
|
|
* Copyright © 2010 Codethink Limited
|
|
*
|
|
* This program 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 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
|
|
* 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
|
|
* Public License along with this library; if not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
* Authors: Ryan Lortie <desrt@desrt.ca>
|
|
*/
|
|
|
|
#ifndef __G_APPLICATION_H__
|
|
#define __G_APPLICATION_H__
|
|
|
|
#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
|
|
|
|
#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))
|
|
|
|
typedef struct _GApplicationPrivate GApplicationPrivate;
|
|
typedef struct _GApplicationClass GApplicationClass;
|
|
|
|
/**
|
|
* GApplication:
|
|
*
|
|
* Since: 2.28
|
|
*/
|
|
struct _GApplication
|
|
{
|
|
/*< private >*/
|
|
GObject parent_instance;
|
|
|
|
GApplicationPrivate *priv;
|
|
};
|
|
|
|
struct _GApplicationClass
|
|
{
|
|
/*< private >*/
|
|
GObjectClass parent_class;
|
|
|
|
/*< public >*/
|
|
/* signals */
|
|
void (* startup) (GApplication *application);
|
|
|
|
void (* activate) (GApplication *application);
|
|
|
|
void (* open) (GApplication *application,
|
|
GFile **files,
|
|
gint n_files,
|
|
const gchar *hint);
|
|
|
|
int (* command_line) (GApplication *application,
|
|
GApplicationCommandLine *command_line);
|
|
|
|
/* vfuncs */
|
|
|
|
/**
|
|
* 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
|
|
*/
|
|
gboolean (* local_command_line) (GApplication *application,
|
|
gchar ***arguments,
|
|
int *exit_status);
|
|
|
|
void (* before_emit) (GApplication *application,
|
|
GVariant *platform_data);
|
|
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);
|
|
void (* shutdown) (GApplication *application);
|
|
|
|
gboolean (* dbus_register) (GApplication *application,
|
|
GDBusConnection *connection,
|
|
const gchar *object_path,
|
|
GError **error);
|
|
void (* dbus_unregister) (GApplication *application,
|
|
GDBusConnection *connection,
|
|
const gchar *object_path);
|
|
gint (* handle_local_options)(GApplication *application,
|
|
GVariantDict *options);
|
|
|
|
/*< private >*/
|
|
gpointer padding[8];
|
|
};
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GType g_application_get_type (void) G_GNUC_CONST;
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gboolean g_application_id_is_valid (const gchar *application_id);
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GApplication * g_application_new (const gchar *application_id,
|
|
GApplicationFlags flags);
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
const gchar * g_application_get_application_id (GApplication *application);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_application_set_application_id (GApplication *application,
|
|
const gchar *application_id);
|
|
|
|
GLIB_AVAILABLE_IN_2_34
|
|
GDBusConnection * g_application_get_dbus_connection (GApplication *application);
|
|
GLIB_AVAILABLE_IN_2_34
|
|
const gchar * g_application_get_dbus_object_path (GApplication *application);
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
guint g_application_get_inactivity_timeout (GApplication *application);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_application_set_inactivity_timeout (GApplication *application,
|
|
guint inactivity_timeout);
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GApplicationFlags g_application_get_flags (GApplication *application);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_application_set_flags (GApplication *application,
|
|
GApplicationFlags flags);
|
|
|
|
GLIB_AVAILABLE_IN_2_42
|
|
const gchar * g_application_get_resource_base_path (GApplication *application);
|
|
GLIB_AVAILABLE_IN_2_42
|
|
void g_application_set_resource_base_path (GApplication *application,
|
|
const gchar *resource_base_path);
|
|
|
|
GLIB_DEPRECATED
|
|
void g_application_set_action_group (GApplication *application,
|
|
GActionGroup *action_group);
|
|
|
|
GLIB_AVAILABLE_IN_2_40
|
|
void g_application_add_main_option_entries (GApplication *application,
|
|
const GOptionEntry *entries);
|
|
GLIB_AVAILABLE_IN_2_40
|
|
void g_application_add_option_group (GApplication *application,
|
|
GOptionGroup *group);
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gboolean g_application_get_is_registered (GApplication *application);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gboolean g_application_get_is_remote (GApplication *application);
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gboolean g_application_register (GApplication *application,
|
|
GCancellable *cancellable,
|
|
GError **error);
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_application_hold (GApplication *application);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_application_release (GApplication *application);
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_application_activate (GApplication *application);
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
void g_application_open (GApplication *application,
|
|
GFile **files,
|
|
gint n_files,
|
|
const gchar *hint);
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
int g_application_run (GApplication *application,
|
|
int argc,
|
|
char **argv);
|
|
|
|
GLIB_AVAILABLE_IN_2_32
|
|
void g_application_quit (GApplication *application);
|
|
|
|
GLIB_AVAILABLE_IN_2_32
|
|
GApplication * g_application_get_default (void);
|
|
GLIB_AVAILABLE_IN_2_32
|
|
void g_application_set_default (GApplication *application);
|
|
|
|
GLIB_AVAILABLE_IN_2_38
|
|
void g_application_mark_busy (GApplication *application);
|
|
GLIB_AVAILABLE_IN_2_38
|
|
void g_application_unmark_busy (GApplication *application);
|
|
|
|
GLIB_AVAILABLE_IN_2_40
|
|
void g_application_send_notification (GApplication *application,
|
|
const gchar *id,
|
|
GNotification *notification);
|
|
GLIB_AVAILABLE_IN_2_40
|
|
void g_application_withdraw_notification (GApplication *application,
|
|
const gchar *id);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __G_APPLICATION_H__ */
|