GDesktopAppInfo

typedef struct _GDesktopAppInfo GDesktopAppInfo;

Information about an installed application from a desktop file.

g_desktop_app_info_new_from_filename ()

GDesktopAppInfo *   g_desktop_app_info_new_from_filename
                                                        (const char *filename);

Creates a new GDesktopAppInfo.

g_desktop_app_info_new_from_keyfile ()

GDesktopAppInfo *   g_desktop_app_info_new_from_keyfile (GKeyFile *key_file);

Creates a new GDesktopAppInfo.

Since 2.18

g_desktop_app_info_new ()

GDesktopAppInfo *   g_desktop_app_info_new              (const char *desktop_id);

Creates a new GDesktopAppInfo based on a desktop file id.

A desktop file id is the basename of the desktop file, including the .desktop extension. GIO is looking for a desktop file with this name in the applications subdirectories of the XDG data directories (i.e. the directories specified in the XDG_DATA_HOME and XDG_DATA_DIRS environment variables). GIO also supports the prefix-to-subdirectory mapping that is described in the Menu Spec (i.e. a desktop id of kde-foo.desktop will match /usr/share/applications/kde/foo.desktop).

g_desktop_app_info_get_filename ()

const char *        g_desktop_app_info_get_filename     (GDesktopAppInfo *info);

When info was created from a known filename, return it. In some situations such as the GDesktopAppInfo returned from g_desktop_app_info_new_from_keyfile(), this function will return NULL.

Since 2.24

g_desktop_app_info_get_is_hidden ()

gboolean            g_desktop_app_info_get_is_hidden    (GDesktopAppInfo *info);

A desktop file is hidden if the Hidden key in it is set to True.

g_desktop_app_info_get_nodisplay ()

gboolean            g_desktop_app_info_get_nodisplay    (GDesktopAppInfo *info);

Gets the value of the NoDisplay key, which helps determine if the application info should be shown in menus. See G_KEY_FILE_DESKTOP_KEY_NO_DISPLAY and g_app_info_should_show().

Since 2.30

g_desktop_app_info_get_show_in ()

gboolean            g_desktop_app_info_get_show_in      (GDesktopAppInfo *info,
                                                         const gchar *desktop_env);

Checks if the application info should be shown in menus that list available applications for a specific name of the desktop, based on the OnlyShowIn and NotShowIn keys.

If desktop_env is NULL, then the name of the desktop set with g_desktop_app_info_set_desktop_env() is used.

Note that g_app_info_should_show() for info will include this check (with NULL for desktop_env) as well as additional checks.

Since 2.30

g_desktop_app_info_get_generic_name ()

const char *        g_desktop_app_info_get_generic_name (GDesktopAppInfo *info);

Gets the generic name from the destkop file.

g_desktop_app_info_get_categories ()

const char *        g_desktop_app_info_get_categories   (GDesktopAppInfo *info);

Gets the categories from the desktop file.

g_desktop_app_info_get_keywords ()

const char * const * g_desktop_app_info_get_keywords    (GDesktopAppInfo *info);

Gets the keywords from the desktop file.

Since 2.32

g_desktop_app_info_get_startup_wm_class ()

const char *        g_desktop_app_info_get_startup_wm_class
                                                        (GDesktopAppInfo *info);

Retrieves the StartupWMClass field from info. This represents the WM_CLASS property of the main window of the application, if launched through info.

Since 2.34

g_desktop_app_info_set_desktop_env ()

void                g_desktop_app_info_set_desktop_env  (const char *desktop_env);

Sets the name of the desktop that the application is running in. This is used by g_app_info_should_show() and g_desktop_app_info_get_show_in() to evaluate the OnlyShowIn and NotShowIn desktop entry fields.

The Desktop Menu specification recognizes the following:

Should be called only once; subsequent calls are ignored.

GDesktopAppLaunchCallback ()

void                (*GDesktopAppLaunchCallback)        (GDesktopAppInfo *appinfo,
                                                         GPid pid,
                                                         gpointer user_data);

During invocation, g_desktop_app_info_launch_uris_as_manager() may create one or more child processes. This callback is invoked once for each, providing the process ID.

g_desktop_app_info_launch_uris_as_manager ()

gboolean            g_desktop_app_info_launch_uris_as_manager
                                                        (GDesktopAppInfo *appinfo,
                                                         GList *uris,
                                                         GAppLaunchContext *launch_context,
                                                         GSpawnFlags spawn_flags,
                                                         GSpawnChildSetupFunc user_setup,
                                                         gpointer user_setup_data,
                                                         GDesktopAppLaunchCallback pid_callback,
                                                         gpointer pid_callback_data,
                                                         GError **error);

This function performs the equivalent of g_app_info_launch_uris(), but is intended primarily for operating system components that launch applications. Ordinary applications should use g_app_info_launch_uris().

In contrast to g_app_info_launch_uris(), all processes created will always be run directly as children as if by the UNIX fork()/exec() calls.

This guarantee allows additional control over the exact environment of the child processes, which is provided via a setup function user_setup, as well as the process identifier of each child process via pid_callback. See g_spawn_async() for more information about the semantics of the user_setup function.

The "filename" property

  "filename"                 gchar*                : Read / Write / Construct Only

The origin filename of this GDesktopAppInfo

Default value: NULL