GAppInfo

GAppInfo

Synopsis




enum                GAppInfoCreateFlags;
                    GAppInfo;
                    GAppInfoIface;
                    GAppLaunchContext;
GAppInfo*           g_app_info_create_from_commandline  (const char *commandline,
                                                         const char *application_name,
                                                         GAppInfoCreateFlags flags,
                                                         GError **error);
GAppInfo*           g_app_info_dup                      (GAppInfo *appinfo);
gboolean            g_app_info_equal                    (GAppInfo *appinfo1,
                                                         GAppInfo *appinfo2);
const char*         g_app_info_get_id                   (GAppInfo *appinfo);
const char*         g_app_info_get_name                 (GAppInfo *appinfo);
const char*         g_app_info_get_description          (GAppInfo *appinfo);
const char*         g_app_info_get_executable           (GAppInfo *appinfo);
GIcon*              g_app_info_get_icon                 (GAppInfo *appinfo);
gboolean            g_app_info_launch                   (GAppInfo *appinfo,
                                                         GList *files,
                                                         GAppLaunchContext *launch_context,
                                                         GError **error);
gboolean            g_app_info_supports_uris            (GAppInfo *appinfo);
gboolean            g_app_info_launch_uris              (GAppInfo *appinfo,
                                                         GList *uris,
                                                         GAppLaunchContext *launch_context,
                                                         GError **error);
gboolean            g_app_info_should_show              (GAppInfo *appinfo,
                                                         const char *desktop_env);
gboolean            g_app_info_set_as_default_for_type  (GAppInfo *appinfo,
                                                         const char *content_type,
                                                         GError **error);
gboolean            g_app_info_set_as_default_for_extension
                                                        (GAppInfo *appinfo,
                                                         const char *extension,
                                                         GError **error);
gboolean            g_app_info_add_supports_type        (GAppInfo *appinfo,
                                                         const char *content_type,
                                                         GError **error);
gboolean            g_app_info_can_remove_supports_type (GAppInfo *appinfo);
gboolean            g_app_info_remove_supports_type     (GAppInfo *appinfo,
                                                         const char *content_type,
                                                         GError **error);
GList*              g_app_info_get_all                  (void);
GList*              g_app_info_get_all_for_type         (const char *content_type);
GAppInfo*           g_app_info_get_default_for_type     (const char *content_type,
                                                         gboolean must_support_uris);
GAppInfo*           g_app_info_get_default_for_uri_scheme
                                                        (const char *uri_scheme);
char*               g_app_launch_context_get_display    (GAppLaunchContext *context,
                                                         GAppInfo *info,
                                                         GList *files);
char*               g_app_launch_context_get_startup_notify_id
                                                        (GAppLaunchContext *context,
                                                         GAppInfo *info,
                                                         GList *files);
GType               g_app_launch_context_get_type       (void);
void                g_app_launch_context_launch_failed  (GAppLaunchContext *context,
                                                         const char *startup_notify_id);
GAppLaunchContext*  g_app_launch_context_new            (void);

Object Hierarchy


  GInterface
   +----GAppInfo

Prerequisites

GAppInfo requires GObject.

Description

Details

enum GAppInfoCreateFlags

typedef enum {
  G_APP_INFO_CREATE_FLAGS_NONE = 0,
  G_APP_INFO_CREATE_NEEDS_TERMINAL = (1<<0)
} GAppInfoCreateFlags;

GAppInfo

typedef struct _GAppInfo GAppInfo;

GAppInfoIface

typedef struct {
  GTypeInterface g_iface;

  /* Virtual Table */

  GAppInfo *          (*dup)                (GAppInfo                *appinfo);
  gboolean            (*equal)              (GAppInfo                *appinfo1,
					     GAppInfo                *appinfo2);
  const char *        (*get_id)             (GAppInfo                *appinfo);
  const char *        (*get_name)           (GAppInfo                *appinfo);
  const char *        (*get_description)    (GAppInfo                *appinfo);
  const char *        (*get_executable)     (GAppInfo                *appinfo);
  GIcon *             (*get_icon)           (GAppInfo                *appinfo);
  gboolean            (*launch)             (GAppInfo                *appinfo,
					     GList                   *filenames,
					     GAppLaunchContext       *launch_context,
					     GError                 **error);
  gboolean            (*supports_uris)      (GAppInfo                *appinfo);
  gboolean            (*launch_uris)        (GAppInfo                *appinfo,
					     GList                   *uris,
					     GAppLaunchContext       *launch_context,
					     GError                 **error);
  gboolean            (*should_show)        (GAppInfo                *appinfo,
					     const char              *desktop_env);
  gboolean            (*supports_xdg_startup_notify) (GAppInfo       *appinfo);


  /* For changing associations */
  gboolean  (*set_as_default_for_type)      (GAppInfo           *appinfo,
					     const char         *content_type,
					     GError            **error);
  gboolean  (*set_as_default_for_extension) (GAppInfo           *appinfo,
					     const char         *extension,
					     GError            **error);
  gboolean  (*add_supports_type)            (GAppInfo           *appinfo,
					     const char         *content_type,
					     GError            **error);
  gboolean  (*can_remove_supports_type)     (GAppInfo           *appinfo);
  gboolean  (*remove_supports_type)         (GAppInfo           *appinfo,
					     const char         *content_type,
					     GError            **error);

  /* Padding for future expansion */
  void (*_g_reserved1) (void);
  void (*_g_reserved2) (void);
  void (*_g_reserved3) (void);
  void (*_g_reserved4) (void);
  void (*_g_reserved5) (void);
  void (*_g_reserved6) (void);
  void (*_g_reserved7) (void);
  void (*_g_reserved8) (void);
  void (*_g_reserved9) (void);
  void (*_g_reserved10) (void);
} GAppInfoIface;

GAppLaunchContext

typedef struct {
  GObject parent_instance;

  GAppLaunchContextPrivate *priv;
} GAppLaunchContext;

g_app_info_create_from_commandline ()

GAppInfo*           g_app_info_create_from_commandline  (const char *commandline,
                                                         const char *application_name,
                                                         GAppInfoCreateFlags flags,
                                                         GError **error);

commandline :

application_name :

flags :

error :

 a GError location to store the error occuring, or NULL to ignore. Returns: new GAppInfo for given command.

Returns :

g_app_info_dup ()

GAppInfo*           g_app_info_dup                      (GAppInfo *appinfo);

appinfo :

 a GAppInfo.

Returns :

 a duplicate of appinfo.

g_app_info_equal ()

gboolean            g_app_info_equal                    (GAppInfo *appinfo1,
                                                         GAppInfo *appinfo2);

appinfo1 :

 the first GAppInfo.

appinfo2 :

 the second GAppInfo.

Returns :

 TRUE if appinfo1 is equal to appinfo2. FALSE otherwise.

g_app_info_get_id ()

const char*         g_app_info_get_id                   (GAppInfo *appinfo);

appinfo :

 a GAppInfo.

Returns :

g_app_info_get_name ()

const char*         g_app_info_get_name                 (GAppInfo *appinfo);

appinfo :

 a GAppInfo.

Returns :

 the name of the application for appinfo.

g_app_info_get_description ()

const char*         g_app_info_get_description          (GAppInfo *appinfo);

appinfo :

 a GAppInfo.

Returns :

 a string containing a description of the application appinfo. The returned string should be not freed when no longer needed.

g_app_info_get_executable ()

const char*         g_app_info_get_executable           (GAppInfo *appinfo);

appinfo :

 a GAppInfo.

Returns :

 a string containing the appinfo's application binary's name.

g_app_info_get_icon ()

GIcon*              g_app_info_get_icon                 (GAppInfo *appinfo);

appinfo :

 a GAppInfo.

Returns :

 the default GIcon for appinfo.

g_app_info_launch ()

gboolean            g_app_info_launch                   (GAppInfo *appinfo,
                                                         GList *files,
                                                         GAppLaunchContext *launch_context,
                                                         GError **error);

appinfo :

 a GAppInfo.

files :

 a GList of GFile objects.

launch_context :

 a GAppLaunchContext.

error :

 a GError.

Returns :

 TRUE on successful launch.

g_app_info_supports_uris ()

gboolean            g_app_info_supports_uris            (GAppInfo *appinfo);

appinfo :

 a GAppInfo.

Returns :

 TRUE if the appinfo supports URIs.

g_app_info_launch_uris ()

gboolean            g_app_info_launch_uris              (GAppInfo *appinfo,
                                                         GList *uris,
                                                         GAppLaunchContext *launch_context,
                                                         GError **error);

appinfo :

 a GAppInfo.

uris :

 a GList containing URIs to launch.

launch_context :

 a GAppLaunchContext.

error :

 a GError.

Returns :

 TRUE if the appinfo was launched with the given uris.

g_app_info_should_show ()

gboolean            g_app_info_should_show              (GAppInfo *appinfo,
                                                         const char *desktop_env);

appinfo :

 a GAppInfo.

desktop_env :

 a string.

Returns :

 TRUE if the GAppInfo should be shown, FALSE otherwise.

g_app_info_set_as_default_for_type ()

gboolean            g_app_info_set_as_default_for_type  (GAppInfo *appinfo,
                                                         const char *content_type,
                                                         GError **error);

appinfo :

 a GAppInfo.

content_type :

 the content type.

error :

 a GError.

Returns :

 TRUE if the given appinfo is the default for the given content_type. FALSE if not, or in case of an error.

g_app_info_set_as_default_for_extension ()

gboolean            g_app_info_set_as_default_for_extension
                                                        (GAppInfo *appinfo,
                                                         const char *extension,
                                                         GError **error);

appinfo :

 a GAppInfo.

extension :

 a string containing the file extension.

error :

 a GError.

Returns :

 TRUE if the given appinfo is the default for the given extension. FALSE if not, or in case of an error.

g_app_info_add_supports_type ()

gboolean            g_app_info_add_supports_type        (GAppInfo *appinfo,
                                                         const char *content_type,
                                                         GError **error);

appinfo :

 a GAppInfo.

content_type :

 a string.

error :

 a GError.

Returns :

 TRUE if appinfo supports content_type. FALSE if not, or in case of an error.

g_app_info_can_remove_supports_type ()

gboolean            g_app_info_can_remove_supports_type (GAppInfo *appinfo);

appinfo :

Returns :

g_app_info_remove_supports_type ()

gboolean            g_app_info_remove_supports_type     (GAppInfo *appinfo,
                                                         const char *content_type,
                                                         GError **error);

appinfo :

 a GAppInfo.

content_type :

 a string.

error :

 a GError.

Returns :

 TRUE if content_type support was removed from appinfo. FALSE if not.

g_app_info_get_all ()

GList*              g_app_info_get_all                  (void);

Returns :

 GList of GAppInfo s.

g_app_info_get_all_for_type ()

GList*              g_app_info_get_all_for_type         (const char *content_type);

content_type :

Returns :

 GList of GAppInfo s for given content_type.

g_app_info_get_default_for_type ()

GAppInfo*           g_app_info_get_default_for_type     (const char *content_type,
                                                         gboolean must_support_uris);

content_type :

must_support_uris :

Returns :

 the default GAppInfo for the given content_type. If must_support_uris is true, the GAppInfo is expected to support URIs.

g_app_info_get_default_for_uri_scheme ()

GAppInfo*           g_app_info_get_default_for_uri_scheme
                                                        (const char *uri_scheme);

uri_scheme :

Returns :

 GAppInfo

g_app_launch_context_get_display ()

char*               g_app_launch_context_get_display    (GAppLaunchContext *context,
                                                         GAppInfo *info,
                                                         GList *files);

context :

 a GAppLaunchContext.

info :

 a GAppInfo.

files :

 a GList of files.

Returns :

g_app_launch_context_get_startup_notify_id ()

char*               g_app_launch_context_get_startup_notify_id
                                                        (GAppLaunchContext *context,
                                                         GAppInfo *info,
                                                         GList *files);

context :

 a GAppLaunchContext.

info :

files :

Returns :

g_app_launch_context_get_type ()

GType               g_app_launch_context_get_type       (void);

Returns :

g_app_launch_context_launch_failed ()

void                g_app_launch_context_launch_failed  (GAppLaunchContext *context,
                                                         const char *startup_notify_id);

context :

startup_notify_id :

g_app_launch_context_new ()

GAppLaunchContext*  g_app_launch_context_new            (void);

Returns :

 A new GAppLaunchContext.