mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-12-26 07:26:15 +01:00
5ca9eca632
The X-Flatpak-RenamedFrom key is used in .desktop files to identify past
names for the desktop file. It is defined to be a list of strings.
However, there was previously no correct way to retrieve a list of
strings from the GKeyFile wrapped by GDesktopAppInfo, short of
re-parsing the file with GKeyFile.
Note that doing something like:
g_strsplit (g_desktop_app_info_get_string (...), ";", -1)
is not correct: the raw value "a\;b;" represents the one-element list
["a;b"], but g_key_file_get_string() rejects the sequence "\;", and so
g_desktop_app_info_get_string() returns NULL in this case. (Of course, a
.desktop file with a semicolon in its name is a pathological case.)
Add g_desktop_app_info_get_string_list(), a trivial wrapper around
g_key_file_get_string_list(), similar to g_desktop_app_info_get_string()
and co.
The change from g_key_file_free() to g_key_file_unref() in the test is
needed because g_key_file_free() clears the contents of the keyfile.
This is fine for all the fields which are eagerly loaded and copied into
GDesktopAppInfo, but not when we want to access arbitrary stuff from the
keyfile.
200 lines
8.3 KiB
C
200 lines
8.3 KiB
C
/* GIO - GLib Input, Output and Streaming Library
|
|
*
|
|
* Copyright (C) 2006-2007 Red Hat, Inc.
|
|
*
|
|
* 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.
|
|
*
|
|
* 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/>.
|
|
*
|
|
* Author: Alexander Larsson <alexl@redhat.com>
|
|
*/
|
|
|
|
#ifndef __G_DESKTOP_APP_INFO_H__
|
|
#define __G_DESKTOP_APP_INFO_H__
|
|
|
|
#include <gio/gio.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define G_TYPE_DESKTOP_APP_INFO (g_desktop_app_info_get_type ())
|
|
#define G_DESKTOP_APP_INFO(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), G_TYPE_DESKTOP_APP_INFO, GDesktopAppInfo))
|
|
#define G_DESKTOP_APP_INFO_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), G_TYPE_DESKTOP_APP_INFO, GDesktopAppInfoClass))
|
|
#define G_IS_DESKTOP_APP_INFO(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), G_TYPE_DESKTOP_APP_INFO))
|
|
#define G_IS_DESKTOP_APP_INFO_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), G_TYPE_DESKTOP_APP_INFO))
|
|
#define G_DESKTOP_APP_INFO_GET_CLASS(o) (G_TYPE_INSTANCE_GET_CLASS ((o), G_TYPE_DESKTOP_APP_INFO, GDesktopAppInfoClass))
|
|
|
|
typedef struct _GDesktopAppInfo GDesktopAppInfo;
|
|
typedef struct _GDesktopAppInfoClass GDesktopAppInfoClass;
|
|
|
|
G_DEFINE_AUTOPTR_CLEANUP_FUNC(GDesktopAppInfo, g_object_unref)
|
|
|
|
struct _GDesktopAppInfoClass
|
|
{
|
|
GObjectClass parent_class;
|
|
};
|
|
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GType g_desktop_app_info_get_type (void) G_GNUC_CONST;
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GDesktopAppInfo *g_desktop_app_info_new_from_filename (const char *filename);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GDesktopAppInfo *g_desktop_app_info_new_from_keyfile (GKeyFile *key_file);
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
const char * g_desktop_app_info_get_filename (GDesktopAppInfo *info);
|
|
|
|
GLIB_AVAILABLE_IN_2_30
|
|
const char * g_desktop_app_info_get_generic_name (GDesktopAppInfo *info);
|
|
GLIB_AVAILABLE_IN_2_30
|
|
const char * g_desktop_app_info_get_categories (GDesktopAppInfo *info);
|
|
GLIB_AVAILABLE_IN_2_30
|
|
const char * const *g_desktop_app_info_get_keywords (GDesktopAppInfo *info);
|
|
GLIB_AVAILABLE_IN_2_30
|
|
gboolean g_desktop_app_info_get_nodisplay (GDesktopAppInfo *info);
|
|
GLIB_AVAILABLE_IN_2_30
|
|
gboolean g_desktop_app_info_get_show_in (GDesktopAppInfo *info,
|
|
const gchar *desktop_env);
|
|
GLIB_AVAILABLE_IN_2_34
|
|
const char * g_desktop_app_info_get_startup_wm_class (GDesktopAppInfo *info);
|
|
|
|
GLIB_AVAILABLE_IN_ALL
|
|
GDesktopAppInfo *g_desktop_app_info_new (const char *desktop_id);
|
|
GLIB_AVAILABLE_IN_ALL
|
|
gboolean g_desktop_app_info_get_is_hidden (GDesktopAppInfo *info);
|
|
|
|
GLIB_DEPRECATED_IN_2_42
|
|
void g_desktop_app_info_set_desktop_env (const char *desktop_env);
|
|
|
|
GLIB_AVAILABLE_IN_2_36
|
|
gboolean g_desktop_app_info_has_key (GDesktopAppInfo *info,
|
|
const char *key);
|
|
GLIB_AVAILABLE_IN_2_36
|
|
char * g_desktop_app_info_get_string (GDesktopAppInfo *info,
|
|
const char *key);
|
|
GLIB_AVAILABLE_IN_2_56
|
|
char * g_desktop_app_info_get_locale_string (GDesktopAppInfo *info,
|
|
const char *key);
|
|
GLIB_AVAILABLE_IN_2_36
|
|
gboolean g_desktop_app_info_get_boolean (GDesktopAppInfo *info,
|
|
const char *key);
|
|
|
|
GLIB_AVAILABLE_IN_2_60
|
|
gchar ** g_desktop_app_info_get_string_list (GDesktopAppInfo *info,
|
|
const char *key,
|
|
gsize *length);
|
|
|
|
GLIB_AVAILABLE_IN_2_38
|
|
const gchar * const * g_desktop_app_info_list_actions (GDesktopAppInfo *info);
|
|
|
|
GLIB_AVAILABLE_IN_2_38
|
|
void g_desktop_app_info_launch_action (GDesktopAppInfo *info,
|
|
const gchar *action_name,
|
|
GAppLaunchContext *launch_context);
|
|
|
|
GLIB_AVAILABLE_IN_2_38
|
|
gchar * g_desktop_app_info_get_action_name (GDesktopAppInfo *info,
|
|
const gchar *action_name);
|
|
|
|
#ifndef G_DISABLE_DEPRECATED
|
|
|
|
#define G_TYPE_DESKTOP_APP_INFO_LOOKUP (g_desktop_app_info_lookup_get_type ())
|
|
#define G_DESKTOP_APP_INFO_LOOKUP(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), G_TYPE_DESKTOP_APP_INFO_LOOKUP, GDesktopAppInfoLookup))
|
|
#define G_IS_DESKTOP_APP_INFO_LOOKUP(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), G_TYPE_DESKTOP_APP_INFO_LOOKUP))
|
|
#define G_DESKTOP_APP_INFO_LOOKUP_GET_IFACE(obj) (G_TYPE_INSTANCE_GET_INTERFACE ((obj), G_TYPE_DESKTOP_APP_INFO_LOOKUP, GDesktopAppInfoLookupIface))
|
|
|
|
/**
|
|
* G_DESKTOP_APP_INFO_LOOKUP_EXTENSION_POINT_NAME:
|
|
*
|
|
* Extension point for default handler to URI association. See
|
|
* [Extending GIO][extending-gio].
|
|
*/
|
|
#define G_DESKTOP_APP_INFO_LOOKUP_EXTENSION_POINT_NAME "gio-desktop-app-info-lookup"
|
|
|
|
#endif /* G_DISABLE_DEPRECATED */
|
|
|
|
/**
|
|
* GDesktopAppInfoLookupIface:
|
|
* @get_default_for_uri_scheme: Virtual method for
|
|
* g_desktop_app_info_lookup_get_default_for_uri_scheme().
|
|
*
|
|
* Interface that is used by backends to associate default
|
|
* handlers with URI schemes.
|
|
*/
|
|
typedef struct _GDesktopAppInfoLookup GDesktopAppInfoLookup;
|
|
typedef struct _GDesktopAppInfoLookupIface GDesktopAppInfoLookupIface;
|
|
|
|
struct _GDesktopAppInfoLookupIface
|
|
{
|
|
GTypeInterface g_iface;
|
|
|
|
GAppInfo * (* get_default_for_uri_scheme) (GDesktopAppInfoLookup *lookup,
|
|
const char *uri_scheme);
|
|
};
|
|
|
|
GLIB_DEPRECATED
|
|
GType g_desktop_app_info_lookup_get_type (void) G_GNUC_CONST;
|
|
|
|
GLIB_DEPRECATED
|
|
GAppInfo *g_desktop_app_info_lookup_get_default_for_uri_scheme (GDesktopAppInfoLookup *lookup,
|
|
const char *uri_scheme);
|
|
|
|
/**
|
|
* GDesktopAppLaunchCallback:
|
|
* @appinfo: a #GDesktopAppInfo
|
|
* @pid: Process identifier
|
|
* @user_data: 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.
|
|
*/
|
|
typedef void (*GDesktopAppLaunchCallback) (GDesktopAppInfo *appinfo,
|
|
GPid pid,
|
|
gpointer user_data);
|
|
|
|
GLIB_AVAILABLE_IN_2_28
|
|
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);
|
|
|
|
GLIB_AVAILABLE_IN_2_58
|
|
gboolean g_desktop_app_info_launch_uris_as_manager_with_fds (GDesktopAppInfo *appinfo,
|
|
GList *uris,
|
|
GAppLaunchContext *launch_context,
|
|
GSpawnFlags spawn_flags,
|
|
GSpawnChildSetupFunc user_setup,
|
|
gpointer user_setup_data,
|
|
GDesktopAppLaunchCallback pid_callback,
|
|
gpointer pid_callback_data,
|
|
gint stdin_fd,
|
|
gint stdout_fd,
|
|
gint stderr_fd,
|
|
GError **error);
|
|
|
|
GLIB_AVAILABLE_IN_2_40
|
|
gchar *** g_desktop_app_info_search (const gchar *search_string);
|
|
|
|
GLIB_AVAILABLE_IN_2_42
|
|
GList *g_desktop_app_info_get_implementations (const gchar *interface);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __G_DESKTOP_APP_INFO_H__ */
|