| /* 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 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, write to the |
| * Free Software Foundation, Inc., 59 Temple Place, Suite 330, |
| * Boston, MA 02111-1307, USA. |
| * |
| * Author: Alexander Larsson <alexl@redhat.com> |
| */ |
| |
| #include <config.h> |
| #include "gappinfo.h" |
| #include "glibintl.h" |
| #include <gioerror.h> |
| |
| #include "gioalias.h" |
| |
| /** |
| * SECTION:gappinfo |
| * @short_description: Application information and launch contexts |
| * @include: gio.h |
| * |
| * #GAppInfo and #GAppLaunchContext are used for describing and launching |
| * applications installed on the system. |
| * |
| **/ |
| |
| static void g_app_info_base_init (gpointer g_class); |
| static void g_app_info_class_init (gpointer g_class, |
| gpointer class_data); |
| |
| |
| GType |
| g_app_info_get_type (void) |
| { |
| static GType app_info_type = 0; |
| |
| if (! app_info_type) |
| { |
| static const GTypeInfo app_info_info = |
| { |
| sizeof (GAppInfoIface), /* class_size */ |
| g_app_info_base_init, /* base_init */ |
| NULL, /* base_finalize */ |
| g_app_info_class_init, |
| NULL, /* class_finalize */ |
| NULL, /* class_data */ |
| 0, |
| 0, /* n_preallocs */ |
| NULL |
| }; |
| |
| app_info_type = |
| g_type_register_static (G_TYPE_INTERFACE, I_("GAppInfo"), |
| &app_info_info, 0); |
| |
| g_type_interface_add_prerequisite (app_info_type, G_TYPE_OBJECT); |
| } |
| |
| return app_info_type; |
| } |
| |
| static void |
| g_app_info_class_init (gpointer g_class, |
| gpointer class_data) |
| { |
| } |
| |
| static void |
| g_app_info_base_init (gpointer g_class) |
| { |
| } |
| |
| |
| /** |
| * g_app_info_dup: |
| * @appinfo: a #GAppInfo. |
| * |
| * Creates a duplicate of a #GAppInfo. |
| * |
| * Returns: a duplicate of @appinfo. |
| **/ |
| GAppInfo * |
| g_app_info_dup (GAppInfo *appinfo) |
| { |
| GAppInfoIface *iface; |
| |
| g_return_val_if_fail (G_IS_APP_INFO (appinfo), NULL); |
| |
| iface = G_APP_INFO_GET_IFACE (appinfo); |
| |
| return (* iface->dup) (appinfo); |
| } |
| |
| /** |
| * g_app_info_equal: |
| * @appinfo1: the first #GAppInfo. |
| * @appinfo2: the second #GAppInfo. |
| * |
| * Checks if two #GAppInfos are equal. |
| * |
| * Returns: %TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise. |
| **/ |
| gboolean |
| g_app_info_equal (GAppInfo *appinfo1, |
| GAppInfo *appinfo2) |
| { |
| GAppInfoIface *iface; |
| |
| g_return_val_if_fail (G_IS_APP_INFO (appinfo1), FALSE); |
| g_return_val_if_fail (G_IS_APP_INFO (appinfo2), FALSE); |
| |
| if (G_TYPE_FROM_INSTANCE (appinfo1) != G_TYPE_FROM_INSTANCE (appinfo2)) |
| return FALSE; |
| |
| iface = G_APP_INFO_GET_IFACE (appinfo1); |
| |
| return (* iface->equal) (appinfo1, appinfo2); |
| } |
| |
| /** |
| * g_app_info_get_id: |
| * @appinfo: a #GAppInfo. |
| * |
| * Gets the ID of an application. An id is a string that |
| * identifies the application. The exact format of the id is |
| * platform dependent. For instance, on Unix this is the |
| * desktop file id from the xdg menu specification. |
| * |
| * Note that the returned ID may be %NULL, depending on how |
| * the @appinfo has been constructed. |
| * |
| * Returns: a string containing the application's ID. |
| **/ |
| const char * |
| g_app_info_get_id (GAppInfo *appinfo) |
| { |
| GAppInfoIface *iface; |
| |
| g_return_val_if_fail (G_IS_APP_INFO (appinfo), NULL); |
| |
| iface = G_APP_INFO_GET_IFACE (appinfo); |
| |
| return (* iface->get_id) (appinfo); |
| } |
| |
| /** |
| * g_app_info_get_name: |
| * @appinfo: a #GAppInfo. |
| * |
| * Gets the installed name of the application. |
| * |
| * Returns: the name of the application for @appinfo. |
| **/ |
| const char * |
| g_app_info_get_name (GAppInfo *appinfo) |
| { |
| GAppInfoIface *iface; |
| |
| g_return_val_if_fail (G_IS_APP_INFO (appinfo), NULL); |
| |
| iface = G_APP_INFO_GET_IFACE (appinfo); |
| |
| return (* iface->get_name) (appinfo); |
| } |
| |
| /** |
| * g_app_info_get_description: |
| * @appinfo: a #GAppInfo. |
| * |
| * Gets a human-readable description of an installed application. |
| * |
| * Returns: a string containing a description of the |
| * application @appinfo, or %NULL if none. |
| **/ |
| const char * |
| g_app_info_get_description (GAppInfo *appinfo) |
| { |
| GAppInfoIface *iface; |
| |
| g_return_val_if_fail (G_IS_APP_INFO (appinfo), NULL); |
| |
| iface = G_APP_INFO_GET_IFACE (appinfo); |
| |
| return (* iface->get_description) (appinfo); |
| } |
| |
| /** |
| * g_app_info_get_executable: |
| * @appinfo: a #GAppInfo. |
| * |
| * Gets the executable's name for the installed application. |
| * |
| * Returns: a string containing the @appinfo's application |
| * binary's name. |
| **/ |
| const char * |
| g_app_info_get_executable (GAppInfo *appinfo) |
| { |
| GAppInfoIface *iface; |
| |
| g_return_val_if_fail (G_IS_APP_INFO (appinfo), NULL); |
| |
| iface = G_APP_INFO_GET_IFACE (appinfo); |
| |
| return (* iface->get_executable) (appinfo); |
| } |
| |
| |
| /** |
| * g_app_info_set_as_default_for_type: |
| * @appinfo: a #GAppInfo. |
| * @content_type: the content type. |
| * @error: a #GError. |
| * |
| * Sets the application as the default handler for a given type. |
| * |
| * Returns: %TRUE on success, %FALSE on error. |
| **/ |
| gboolean |
| g_app_info_set_as_default_for_type (GAppInfo *appinfo, |
| const char *content_type, |
| GError **error) |
| { |
| GAppInfoIface *iface; |
| |
| g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE); |
| g_return_val_if_fail (content_type != NULL, FALSE); |
| |
| iface = G_APP_INFO_GET_IFACE (appinfo); |
| |
| return (* iface->set_as_default_for_type) (appinfo, content_type, error); |
| } |
| |
| |
| /** |
| * g_app_info_set_as_default_for_extension: |
| * @appinfo: a #GAppInfo. |
| * @extension: a string containing the file extension (without the dot). |
| * @error: a #GError. |
| * |
| * Sets the application as the default handler for the given file extention. |
| * |
| * Returns: %TRUE on success, %FALSE on error. |
| **/ |
| gboolean |
| g_app_info_set_as_default_for_extension (GAppInfo *appinfo, |
| const char *extension, |
| GError **error) |
| { |
| GAppInfoIface *iface; |
| |
| g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE); |
| g_return_val_if_fail (extension != NULL, FALSE); |
| |
| iface = G_APP_INFO_GET_IFACE (appinfo); |
| |
| if (iface->set_as_default_for_extension) |
| return (* iface->set_as_default_for_extension) (appinfo, extension, error); |
| |
| g_set_error (error, G_IO_ERROR, G_IO_ERROR_NOT_SUPPORTED, "g_app_info_set_as_default_for_extension not supported yet"); |
| return FALSE; |
| } |
| |
| |
| /** |
| * g_app_info_add_supports_type: |
| * @appinfo: a #GAppInfo. |
| * @content_type: a string. |
| * @error: a #GError. |
| * |
| * Adds a content type to the application information to indicate the |
| * application is capable of opening files with the given content type. |
| * |
| * Returns: %TRUE on success, %FALSE on error. |
| **/ |
| gboolean |
| g_app_info_add_supports_type (GAppInfo *appinfo, |
| const char *content_type, |
| GError **error) |
| { |
| GAppInfoIface *iface; |
| |
| g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE); |
| g_return_val_if_fail (content_type != NULL, FALSE); |
| |
| iface = G_APP_INFO_GET_IFACE (appinfo); |
| |
| if (iface->add_supports_type) |
| return (* iface->add_supports_type) (appinfo, content_type, error); |
| |
| g_set_error (error, G_IO_ERROR, |
| G_IO_ERROR_NOT_SUPPORTED, |
| "g_app_info_add_supports_type not supported yet"); |
| |
| return FALSE; |
| } |
| |
| |
| /** |
| * g_app_info_can_remove_supports_type: |
| * @appinfo: a #GAppInfo. |
| * |
| * Checks if a supported content type can be removed from an application. |
| * |
| * Returns: %TRUE if it is possible to remove supported |
| * content types from a given @appinfo, %FALSE if not. |
| **/ |
| gboolean |
| g_app_info_can_remove_supports_type (GAppInfo *appinfo) |
| { |
| GAppInfoIface *iface; |
| |
| g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE); |
| |
| iface = G_APP_INFO_GET_IFACE (appinfo); |
| |
| if (iface->can_remove_supports_type) |
| return (* iface->can_remove_supports_type) (appinfo); |
| |
| return FALSE; |
| } |
| |
| |
| /** |
| * g_app_info_remove_supports_type: |
| * @appinfo: a #GAppInfo. |
| * @content_type: a string. |
| * @error: a #GError. |
| * |
| * Removes a supported type from an application, if possible. |
| * |
| * Returns: %TRUE on success, %FALSE on error. |
| **/ |
| gboolean |
| g_app_info_remove_supports_type (GAppInfo *appinfo, |
| const char *content_type, |
| GError **error) |
| { |
| GAppInfoIface *iface; |
| |
| g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE); |
| g_return_val_if_fail (content_type != NULL, FALSE); |
| |
| iface = G_APP_INFO_GET_IFACE (appinfo); |
| |
| if (iface->remove_supports_type) |
| return (* iface->remove_supports_type) (appinfo, content_type, error); |
| |
| g_set_error (error, G_IO_ERROR, |
| G_IO_ERROR_NOT_SUPPORTED, |
| "g_app_info_remove_supports_type not supported yet"); |
| |
| return FALSE; |
| } |
| |
| |
| /** |
| * g_app_info_get_icon: |
| * @appinfo: a #GAppInfo. |
| * |
| * Gets the icon for the application. |
| * |
| * Returns: the default #GIcon for @appinfo. |
| **/ |
| GIcon * |
| g_app_info_get_icon (GAppInfo *appinfo) |
| { |
| GAppInfoIface *iface; |
| |
| g_return_val_if_fail (G_IS_APP_INFO (appinfo), NULL); |
| |
| iface = G_APP_INFO_GET_IFACE (appinfo); |
| |
| return (* iface->get_icon) (appinfo); |
| } |
| |
| |
| /** |
| * g_app_info_launch: |
| * @appinfo: a #GAppInfo. |
| * @files: a #GList of #GFile objects. |
| * @launch_context: a #GAppLaunchContext. |
| * @error: a #GError. |
| * |
| * Launches the application. Passes @files to the launched application |
| * as arguments, using the optional @launch_context to get information |
| * about the details of the launcher (like what screen it is on). |
| * On error, @error will be set accordingly. |
| * |
| * To lauch the application without arguments pass a %NULL @files list. |
| * |
| * Note that even if the launch is successful the application launched |
| * can fail to start if it runs into problems during startup. There is |
| * no way to detect this. |
| * |
| * Returns: %TRUE on successful launch, %FALSE otherwise. |
| **/ |
| gboolean |
| g_app_info_launch (GAppInfo *appinfo, |
| GList *files, |
| GAppLaunchContext *launch_context, |
| GError **error) |
| { |
| GAppInfoIface *iface; |
| |
| g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE); |
| |
| iface = G_APP_INFO_GET_IFACE (appinfo); |
| |
| return (* iface->launch) (appinfo, files, launch_context, error); |
| } |
| |
| |
| /** |
| * g_app_info_supports_uris: |
| * @appinfo: a #GAppInfo. |
| * |
| * Checks if the application supports reading files and directories from URIs. |
| * |
| * Returns: %TRUE if the @appinfo supports URIs. |
| **/ |
| gboolean |
| g_app_info_supports_uris (GAppInfo *appinfo) |
| { |
| GAppInfoIface *iface; |
| |
| g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE); |
| |
| iface = G_APP_INFO_GET_IFACE (appinfo); |
| |
| return (* iface->supports_uris) (appinfo); |
| } |
| |
| |
| /** |
| * g_app_info_supports_files: |
| * @appinfo: a #GAppInfo. |
| * |
| * Checks if the application accepts files as arguments. |
| * |
| * Returns: %TRUE if the @appinfo supports files. |
| **/ |
| gboolean |
| g_app_info_supports_files (GAppInfo *appinfo) |
| { |
| GAppInfoIface *iface; |
| |
| g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE); |
| |
| iface = G_APP_INFO_GET_IFACE (appinfo); |
| |
| return (* iface->supports_files) (appinfo); |
| } |
| |
| |
| /** |
| * g_app_info_launch_uris: |
| * @appinfo: a #GAppInfo. |
| * @uris: a #GList containing URIs to launch. |
| * @launch_context: a #GAppLaunchContext. |
| * @error: a #GError. |
| * |
| * Launches the application. Passes @uris to the launched application |
| * as arguments, using the optional @launch_context to get information |
| * about the details of the launcher (like what screen it is on). |
| * On error, @error will be set accordingly. |
| * |
| * To lauch the application without arguments pass a %NULL @uris list. |
| * |
| * Note that even if the launch is successful the application launched |
| * can fail to start if it runs into problems during startup. There is |
| * no way to detect this. |
| * |
| * Returns: %TRUE on successful launch, %FALSE otherwise. |
| **/ |
| gboolean |
| g_app_info_launch_uris (GAppInfo *appinfo, |
| GList *uris, |
| GAppLaunchContext *launch_context, |
| GError **error) |
| { |
| GAppInfoIface *iface; |
| |
| g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE); |
| |
| iface = G_APP_INFO_GET_IFACE (appinfo); |
| |
| return (* iface->launch) (appinfo, uris, launch_context, error); |
| } |
| |
| |
| /** |
| * g_app_info_should_show: |
| * @appinfo: a #GAppInfo. |
| * |
| * Checks if the application info should be shown in menus that |
| * list available applications. |
| * |
| * Returns: %TRUE if the @appinfo should be shown, %FALSE otherwise. |
| **/ |
| gboolean |
| g_app_info_should_show (GAppInfo *appinfo) |
| { |
| GAppInfoIface *iface; |
| |
| g_return_val_if_fail (G_IS_APP_INFO (appinfo), FALSE); |
| |
| iface = G_APP_INFO_GET_IFACE (appinfo); |
| |
| return (* iface->should_show) (appinfo); |
| } |
| |
| G_DEFINE_TYPE (GAppLaunchContext, g_app_launch_context, G_TYPE_OBJECT); |
| |
| /** |
| * g_app_launch_context_new: |
| * |
| * Creates a new application launch context. This is not normally used, |
| * instead you instantiate a subclass of this, such as #GdkAppLaunchContext. |
| * |
| * Returns: a #GAppLaunchContext. |
| **/ |
| GAppLaunchContext * |
| g_app_launch_context_new (void) |
| { |
| return g_object_new (G_TYPE_APP_LAUNCH_CONTEXT, NULL); |
| } |
| |
| static void |
| g_app_launch_context_class_init (GAppLaunchContextClass *klass) |
| { |
| } |
| |
| static void |
| g_app_launch_context_init (GAppLaunchContext *launch_context) |
| { |
| } |
| |
| /** |
| * g_app_launch_context_get_display: |
| * @context: a #GAppLaunchContext. |
| * @info: a #GAppInfo. |
| * @files: a #GList of files. |
| * |
| * Gets the display string for the display. This is used to ensure new |
| * applications are started on the same display as the launching |
| * application. |
| * |
| * Returns: a display string for the display. |
| **/ |
| char * |
| g_app_launch_context_get_display (GAppLaunchContext *context, |
| GAppInfo *info, |
| GList *files) |
| { |
| GAppLaunchContextClass *class; |
| |
| g_return_val_if_fail (G_IS_APP_LAUNCH_CONTEXT (context), NULL); |
| g_return_val_if_fail (G_IS_APP_INFO (info), NULL); |
| |
| class = G_APP_LAUNCH_CONTEXT_GET_CLASS (context); |
| |
| if (class->get_display == NULL) |
| return NULL; |
| |
| return class->get_display (context, info, files); |
| } |
| |
| /** |
| * g_app_launch_context_get_startup_notify_id: |
| * @context: a #GAppLaunchContext. |
| * @info: a #GAppInfo. |
| * @files: a #GList of files. |
| * |
| * Initiates startup notification for the applicaiont and returns the |
| * DESKTOP_STARTUP_ID for the launched operation, if supported. |
| * |
| * Startup notification IDs are defined in the FreeDesktop.Org Startup |
| * Notifications standard, at |
| * <ulink url="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt"/>. |
| * |
| * Returns: a startup notification ID for the application, or %NULL if |
| * not supported. |
| **/ |
| char * |
| g_app_launch_context_get_startup_notify_id (GAppLaunchContext *context, |
| GAppInfo *info, |
| GList *files) |
| { |
| GAppLaunchContextClass *class; |
| |
| g_return_val_if_fail (G_IS_APP_LAUNCH_CONTEXT (context), NULL); |
| g_return_val_if_fail (G_IS_APP_INFO (info), NULL); |
| |
| class = G_APP_LAUNCH_CONTEXT_GET_CLASS (context); |
| |
| if (class->get_startup_notify_id == NULL) |
| return NULL; |
| |
| return class->get_startup_notify_id (context, info, files); |
| } |
| |
| |
| /** |
| * g_app_launch_context_launch_failed: |
| * @context: a #GAppLaunchContext. |
| * @startup_notify_id: the startup notification id that was returned by g_app_launch_context_get_startup_notify_id(). |
| * |
| * Called when an application has failed to launch, so that it can cancel |
| * the application startup notification started in g_app_launch_context_get_startup_notify_id(). |
| * |
| **/ |
| void |
| g_app_launch_context_launch_failed (GAppLaunchContext *context, |
| const char *startup_notify_id) |
| { |
| GAppLaunchContextClass *class; |
| |
| g_return_if_fail (G_IS_APP_LAUNCH_CONTEXT (context)); |
| g_return_if_fail (startup_notify_id != NULL); |
| |
| class = G_APP_LAUNCH_CONTEXT_GET_CLASS (context); |
| |
| if (class->launch_failed != NULL) |
| class->launch_failed (context, startup_notify_id); |
| } |
| |
| #define __G_APP_INFO_C__ |
| #include "gioaliasdef.c" |