|
Packit |
ae235b |
|
|
Packit |
ae235b |
<html>
|
|
Packit |
ae235b |
<head>
|
|
Packit |
ae235b |
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
Packit |
ae235b |
<title>GAppInfo: GIO Reference Manual</title>
|
|
Packit |
ae235b |
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
|
|
Packit |
ae235b |
<link rel="home" href="index.html" title="GIO Reference Manual">
|
|
Packit |
ae235b |
<link rel="up" href="types.html" title="File types and applications">
|
|
Packit |
ae235b |
<link rel="prev" href="gio-GContentType.html" title="GContentType">
|
|
Packit |
ae235b |
<link rel="next" href="GAppInfoMonitor.html" title="GAppInfoMonitor">
|
|
Packit |
ae235b |
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
|
|
Packit |
ae235b |
<link rel="stylesheet" href="style.css" type="text/css">
|
|
Packit |
ae235b |
</head>
|
|
Packit |
ae235b |
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Top |
|
|
Packit |
ae235b |
Description |
|
|
Packit |
ae235b |
Object Hierarchy |
|
|
Packit |
ae235b |
Prerequisites |
|
|
Packit |
ae235b |
Known Implementations |
|
|
Packit |
ae235b |
Signals
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GAppInfo
|
|
Packit |
ae235b |
GAppInfo — Application information and launch contexts
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Functions
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GAppInfo *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_create_from_commandline ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GAppInfo *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_dup ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_equal ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
const char *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_id ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
const char *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_name ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
const char *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_display_name ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
const char *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_description ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
const char *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_executable ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
const char *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_commandline ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GIcon *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_icon ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_launch ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_supports_files ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_supports_uris ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_launch_uris ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_should_show ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_can_delete ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_delete ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_reset_type_associations ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_set_as_default_for_type ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_set_as_default_for_extension ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_set_as_last_used_for_type ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_add_supports_type ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_can_remove_supports_type ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_remove_supports_type ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
const char **
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_supported_types ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GList *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_all ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GList *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_all_for_type ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GAppInfo *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_default_for_type ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GAppInfo *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_default_for_uri_scheme ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GList *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_fallback_for_type ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GList *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_recommended_for_type ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_launch_default_for_uri ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_launch_default_for_uri_async ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_launch_default_for_uri_finish ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_launch_context_setenv ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_launch_context_unsetenv ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
char **
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_launch_context_get_environment ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
char *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_launch_context_get_display ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
char *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_launch_context_get_startup_notify_id ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_launch_context_launch_failed ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GAppLaunchContext *
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_launch_context_new ()
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Signals
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
launch-failed
|
|
Packit |
ae235b |
Run Last
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
launched
|
|
Packit |
ae235b |
Run Last
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Types and Values
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
enum
|
|
Packit |
ae235b |
GAppInfoCreateFlags
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GAppInfo
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
struct
|
|
Packit |
ae235b |
GAppInfoIface
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GAppLaunchContext
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Object Hierarchy
|
|
Packit |
ae235b |
GInterface
|
|
Packit |
ae235b |
╰── GAppInfo
|
|
Packit |
ae235b |
GObject
|
|
Packit |
ae235b |
╰── GAppLaunchContext
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Prerequisites
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GAppInfo requires
|
|
Packit |
ae235b |
GObject.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Known Implementations
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GAppInfo is implemented by
|
|
Packit |
ae235b |
GDesktopAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Includes
|
|
Packit |
ae235b |
#include <gio/gio.h>
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Description
|
|
Packit |
ae235b |
GAppInfo and GAppLaunchContext are used for describing and launching
|
|
Packit |
ae235b |
applications installed on the system.
|
|
Packit |
ae235b |
As of GLib 2.20, URIs will always be converted to POSIX paths
|
|
Packit |
ae235b |
(using g_file_get_path()) when using g_app_info_launch() even if
|
|
Packit |
ae235b |
the application requested an URI and not a POSIX path. For example
|
|
Packit |
ae235b |
for an desktop-file based application with Exec key totem
|
|
Packit |
ae235b |
%U and a single URI, sftp://foo/file.avi, then
|
|
Packit |
ae235b |
/home/user/.gvfs/sftp on foo/file.avi will be passed. This will
|
|
Packit |
ae235b |
only work if a set of suitable GIO extensions (such as gvfs 2.26
|
|
Packit |
ae235b |
compiled with FUSE support), is available and operational; if this
|
|
Packit |
ae235b |
is not the case, the URI will be passed unmodified to the application.
|
|
Packit |
ae235b |
Some URIs, such as mailto:, of course cannot be mapped to a POSIX
|
|
Packit |
ae235b |
path (in gvfs there's no FUSE mount for it); such URIs will be
|
|
Packit |
ae235b |
passed unmodified to the application.
|
|
Packit |
ae235b |
Specifically for gvfs 2.26 and later, the POSIX URI will be mapped
|
|
Packit |
ae235b |
back to the GIO URI in the GFile constructors (since gvfs
|
|
Packit |
ae235b |
implements the GVfs extension point). As such, if the application
|
|
Packit |
ae235b |
needs to examine the URI, it needs to use g_file_get_uri() or
|
|
Packit |
ae235b |
similar on GFile. In other words, an application cannot assume
|
|
Packit |
ae235b |
that the URI passed to e.g. g_file_new_for_commandline_arg() is
|
|
Packit |
ae235b |
equal to the result of g_file_get_uri(). The following snippet
|
|
Packit |
ae235b |
illustrates this:
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
1
|
|
Packit |
ae235b |
2
|
|
Packit |
ae235b |
3
|
|
Packit |
ae235b |
4
|
|
Packit |
ae235b |
5
|
|
Packit |
ae235b |
6
|
|
Packit |
ae235b |
7
|
|
Packit |
ae235b |
8
|
|
Packit |
ae235b |
9
|
|
Packit |
ae235b |
10
|
|
Packit |
ae235b |
11
|
|
Packit |
ae235b |
12
|
|
Packit |
ae235b |
13
|
|
Packit |
ae235b |
14
|
|
Packit |
ae235b |
GFile *f;
|
|
Packit |
ae235b |
char *uri;
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
file = g_file_new_for_commandline_arg (uri_from_commandline);
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri = g_file_get_uri (file);
|
|
Packit |
ae235b |
strcmp (uri, uri_from_commandline) == 0;
|
|
Packit |
ae235b |
g_free (uri);
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
if (g_file_has_uri_scheme (file, "cdda"))
|
|
Packit |
ae235b |
{
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
}
|
|
Packit |
ae235b |
g_object_unref (file);
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
This code will work when both cdda://sr0/Track 1.wav and
|
|
Packit |
ae235b |
/home/user/.gvfs/cdda on sr0/Track 1.wav is passed to the
|
|
Packit |
ae235b |
application. It should be noted that it's generally not safe
|
|
Packit |
ae235b |
for applications to rely on the format of a particular URIs.
|
|
Packit |
ae235b |
Different launcher applications (e.g. file managers) may have
|
|
Packit |
ae235b |
different ideas of what a given URI means.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Functions
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_create_from_commandline ()
|
|
Packit |
ae235b |
GAppInfo *
|
|
Packit |
ae235b |
g_app_info_create_from_commandline (const char *commandline,
|
|
Packit |
ae235b |
const char *application_name,
|
|
Packit |
ae235b |
GAppInfoCreateFlags flags,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Creates a new GAppInfo from the given information.
|
|
Packit |
ae235b |
Note that for commandline
|
|
Packit |
ae235b |
, the quoting rules of the Exec key of the
|
|
Packit |
ae235b |
freedesktop.org Desktop Entry Specification
|
|
Packit |
ae235b |
are applied. For example, if the commandline
|
|
Packit |
ae235b |
contains
|
|
Packit |
ae235b |
percent-encoded URIs, the percent-character must be doubled in order to prevent it from
|
|
Packit |
ae235b |
being swallowed by Exec key unquoting. See the specification for exact quoting rules.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
commandline
|
|
Packit |
ae235b |
the commandline to use.
|
|
Packit |
ae235b |
[type filename]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
application_name
|
|
Packit |
ae235b |
the application name, or NULL to use commandline
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
flags
|
|
Packit |
ae235b |
flags that can specify details of the created GAppInfo
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
a GError location to store the error occurring, NULL to ignore.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
new GAppInfo for given command.
|
|
Packit |
ae235b |
[transfer full]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_dup ()
|
|
Packit |
ae235b |
GAppInfo *
|
|
Packit |
ae235b |
g_app_info_dup (GAppInfo *appinfo);
|
|
Packit |
ae235b |
Creates a duplicate of a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a duplicate of appinfo
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
[transfer full]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_equal ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_app_info_equal (GAppInfo *appinfo1,
|
|
Packit |
ae235b |
GAppInfo *appinfo2);
|
|
Packit |
ae235b |
Checks if two GAppInfos are equal.
|
|
Packit |
ae235b |
Note that the check <emphasis>may not</emphasis> compare each individual
|
|
Packit |
ae235b |
field, and only does an identity check. In case detecting changes in the
|
|
Packit |
ae235b |
contents is needed, program code must additionally compare relevant fields.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo1
|
|
Packit |
ae235b |
the first GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo2
|
|
Packit |
ae235b |
the second GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if appinfo1
|
|
Packit |
ae235b |
is equal to appinfo2
|
|
Packit |
ae235b |
. FALSE otherwise.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_id ()
|
|
Packit |
ae235b |
const char *
|
|
Packit |
ae235b |
g_app_info_get_id (GAppInfo *appinfo);
|
|
Packit |
ae235b |
Gets the ID of an application. An id is a string that
|
|
Packit |
ae235b |
identifies the application. The exact format of the id is
|
|
Packit |
ae235b |
platform dependent. For instance, on Unix this is the
|
|
Packit |
ae235b |
desktop file id from the xdg menu specification.
|
|
Packit |
ae235b |
Note that the returned ID may be NULL, depending on how
|
|
Packit |
ae235b |
the appinfo
|
|
Packit |
ae235b |
has been constructed.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a string containing the application's ID.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_name ()
|
|
Packit |
ae235b |
const char *
|
|
Packit |
ae235b |
g_app_info_get_name (GAppInfo *appinfo);
|
|
Packit |
ae235b |
Gets the installed name of the application.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
the name of the application for appinfo
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_display_name ()
|
|
Packit |
ae235b |
const char *
|
|
Packit |
ae235b |
g_app_info_get_display_name (GAppInfo *appinfo);
|
|
Packit |
ae235b |
Gets the display name of the application. The display name is often more
|
|
Packit |
ae235b |
descriptive to the user than the name itself.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
the display name of the application for appinfo
|
|
Packit |
ae235b |
, or the name if
|
|
Packit |
ae235b |
no display name is available.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.24
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_description ()
|
|
Packit |
ae235b |
const char *
|
|
Packit |
ae235b |
g_app_info_get_description (GAppInfo *appinfo);
|
|
Packit |
ae235b |
Gets a human-readable description of an installed application.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a string containing a description of the
|
|
Packit |
ae235b |
application appinfo
|
|
Packit |
ae235b |
, or NULL if none.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_executable ()
|
|
Packit |
ae235b |
const char *
|
|
Packit |
ae235b |
g_app_info_get_executable (GAppInfo *appinfo);
|
|
Packit |
ae235b |
Gets the executable's name for the installed application.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a string containing the appinfo
|
|
Packit |
ae235b |
's application
|
|
Packit |
ae235b |
binaries name.
|
|
Packit |
ae235b |
[type filename]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_commandline ()
|
|
Packit |
ae235b |
const char *
|
|
Packit |
ae235b |
g_app_info_get_commandline (GAppInfo *appinfo);
|
|
Packit |
ae235b |
Gets the commandline with which the application will be
|
|
Packit |
ae235b |
started.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a string containing the appinfo
|
|
Packit |
ae235b |
's commandline,
|
|
Packit |
ae235b |
or NULL if this information is not available.
|
|
Packit |
ae235b |
[type filename]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.20
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_icon ()
|
|
Packit |
ae235b |
GIcon *
|
|
Packit |
ae235b |
g_app_info_get_icon (GAppInfo *appinfo);
|
|
Packit |
ae235b |
Gets the icon for the application.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
the default GIcon for appinfo
|
|
Packit |
ae235b |
or NULL
|
|
Packit |
ae235b |
if there is no default icon.
|
|
Packit |
ae235b |
[transfer none]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_launch ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_app_info_launch (GAppInfo *appinfo,
|
|
Packit |
ae235b |
GList *files,
|
|
Packit |
ae235b |
GAppLaunchContext *context,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Launches the application. Passes files
|
|
Packit |
ae235b |
to the launched application
|
|
Packit |
ae235b |
as arguments, using the optional context
|
|
Packit |
ae235b |
to get information
|
|
Packit |
ae235b |
about the details of the launcher (like what screen it is on).
|
|
Packit |
ae235b |
On error, error
|
|
Packit |
ae235b |
will be set accordingly.
|
|
Packit |
ae235b |
To launch the application without arguments pass a NULL files
|
|
Packit |
ae235b |
list.
|
|
Packit |
ae235b |
Note that even if the launch is successful the application launched
|
|
Packit |
ae235b |
can fail to start if it runs into problems during startup. There is
|
|
Packit |
ae235b |
no way to detect this.
|
|
Packit |
ae235b |
Some URIs can be changed when passed through a GFile (for instance
|
|
Packit |
ae235b |
unsupported URIs with strange formats like mailto:), so if you have
|
|
Packit |
ae235b |
a textual URI you want to pass in as argument, consider using
|
|
Packit |
ae235b |
g_app_info_launch_uris() instead.
|
|
Packit |
ae235b |
The launched application inherits the environment of the launching
|
|
Packit |
ae235b |
process, but it can be modified with g_app_launch_context_setenv()
|
|
Packit |
ae235b |
and g_app_launch_context_unsetenv().
|
|
Packit |
ae235b |
On UNIX, this function sets the GIO_LAUNCHED_DESKTOP_FILE
|
|
Packit |
ae235b |
environment variable with the path of the launched desktop file and
|
|
Packit |
ae235b |
GIO_LAUNCHED_DESKTOP_FILE_PID to the process id of the launched
|
|
Packit |
ae235b |
process. This can be used to ignore GIO_LAUNCHED_DESKTOP_FILE,
|
|
Packit |
ae235b |
should it be inherited by further processes. The DISPLAY and
|
|
Packit |
ae235b |
DESKTOP_STARTUP_ID environment variables are also set, based
|
|
Packit |
ae235b |
on information provided in context
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
files
|
|
Packit |
ae235b |
a GList of GFile objects.
|
|
Packit |
ae235b |
[nullable][element-type GFile]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
context
|
|
Packit |
ae235b |
a GAppLaunchContext or NULL.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
a GError
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE on successful launch, FALSE otherwise.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_supports_files ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_app_info_supports_files (GAppInfo *appinfo);
|
|
Packit |
ae235b |
Checks if the application accepts files as arguments.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if the appinfo
|
|
Packit |
ae235b |
supports files.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_supports_uris ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_app_info_supports_uris (GAppInfo *appinfo);
|
|
Packit |
ae235b |
Checks if the application supports reading files and directories from URIs.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if the appinfo
|
|
Packit |
ae235b |
supports URIs.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_launch_uris ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_app_info_launch_uris (GAppInfo *appinfo,
|
|
Packit |
ae235b |
GList *uris,
|
|
Packit |
ae235b |
GAppLaunchContext *context,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Launches the application. This passes the uris
|
|
Packit |
ae235b |
to the launched application
|
|
Packit |
ae235b |
as arguments, using the optional context
|
|
Packit |
ae235b |
to get information
|
|
Packit |
ae235b |
about the details of the launcher (like what screen it is on).
|
|
Packit |
ae235b |
On error, error
|
|
Packit |
ae235b |
will be set accordingly.
|
|
Packit |
ae235b |
To launch the application without arguments pass a NULL uris
|
|
Packit |
ae235b |
list.
|
|
Packit |
ae235b |
Note that even if the launch is successful the application launched
|
|
Packit |
ae235b |
can fail to start if it runs into problems during startup. There is
|
|
Packit |
ae235b |
no way to detect this.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uris
|
|
Packit |
ae235b |
a GList containing URIs to launch.
|
|
Packit |
ae235b |
[nullable][element-type utf8]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
context
|
|
Packit |
ae235b |
a GAppLaunchContext or NULL.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
a GError
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE on successful launch, FALSE otherwise.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_should_show ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_app_info_should_show (GAppInfo *appinfo);
|
|
Packit |
ae235b |
Checks if the application info should be shown in menus that
|
|
Packit |
ae235b |
list available applications.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if the appinfo
|
|
Packit |
ae235b |
should be shown, FALSE otherwise.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_can_delete ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_app_info_can_delete (GAppInfo *appinfo);
|
|
Packit |
ae235b |
Obtains the information whether the GAppInfo can be deleted.
|
|
Packit |
ae235b |
See g_app_info_delete().
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if appinfo
|
|
Packit |
ae235b |
can be deleted
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.20
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_delete ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_app_info_delete (GAppInfo *appinfo);
|
|
Packit |
ae235b |
Tries to delete a GAppInfo.
|
|
Packit |
ae235b |
On some platforms, there may be a difference between user-defined
|
|
Packit |
ae235b |
GAppInfos which can be deleted, and system-wide ones which cannot.
|
|
Packit |
ae235b |
See g_app_info_can_delete().
|
|
Packit |
ae235b |
Virtual: do_delete
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if appinfo
|
|
Packit |
ae235b |
has been deleted
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.20
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_reset_type_associations ()
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_app_info_reset_type_associations (const char *content_type);
|
|
Packit |
ae235b |
Removes all changes to the type associations done by
|
|
Packit |
ae235b |
g_app_info_set_as_default_for_type(),
|
|
Packit |
ae235b |
g_app_info_set_as_default_for_extension(),
|
|
Packit |
ae235b |
g_app_info_add_supports_type() or
|
|
Packit |
ae235b |
g_app_info_remove_supports_type().
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
content_type
|
|
Packit |
ae235b |
a content type
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.20
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_set_as_default_for_type ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_app_info_set_as_default_for_type (GAppInfo *appinfo,
|
|
Packit |
ae235b |
const char *content_type,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Sets the application as the default handler for a given type.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
content_type
|
|
Packit |
ae235b |
the content type.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
a GError.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE on success, FALSE on error.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_set_as_default_for_extension ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_app_info_set_as_default_for_extension
|
|
Packit |
ae235b |
(GAppInfo *appinfo,
|
|
Packit |
ae235b |
const char *extension,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Sets the application as the default handler for the given file extension.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
extension
|
|
Packit |
ae235b |
a string containing the file extension
|
|
Packit |
ae235b |
(without the dot).
|
|
Packit |
ae235b |
[type filename]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
a GError.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE on success, FALSE on error.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_set_as_last_used_for_type ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_app_info_set_as_last_used_for_type (GAppInfo *appinfo,
|
|
Packit |
ae235b |
const char *content_type,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Sets the application as the last used application for a given type.
|
|
Packit |
ae235b |
This will make the application appear as first in the list returned
|
|
Packit |
ae235b |
by g_app_info_get_recommended_for_type(), regardless of the default
|
|
Packit |
ae235b |
application for that content type.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
content_type
|
|
Packit |
ae235b |
the content type.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
a GError.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE on success, FALSE on error.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_add_supports_type ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_app_info_add_supports_type (GAppInfo *appinfo,
|
|
Packit |
ae235b |
const char *content_type,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Adds a content type to the application information to indicate the
|
|
Packit |
ae235b |
application is capable of opening files with the given content type.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
content_type
|
|
Packit |
ae235b |
a string.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
a GError.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE on success, FALSE on error.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_can_remove_supports_type ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_app_info_can_remove_supports_type (GAppInfo *appinfo);
|
|
Packit |
ae235b |
Checks if a supported content type can be removed from an application.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if it is possible to remove supported
|
|
Packit |
ae235b |
content types from a given appinfo
|
|
Packit |
ae235b |
, FALSE if not.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_remove_supports_type ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_app_info_remove_supports_type (GAppInfo *appinfo,
|
|
Packit |
ae235b |
const char *content_type,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Removes a supported type from an application, if possible.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
content_type
|
|
Packit |
ae235b |
a string.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
a GError.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE on success, FALSE on error.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_supported_types ()
|
|
Packit |
ae235b |
const char **
|
|
Packit |
ae235b |
g_app_info_get_supported_types (GAppInfo *appinfo);
|
|
Packit |
ae235b |
Retrieves the list of content types that app_info
|
|
Packit |
ae235b |
claims to support.
|
|
Packit |
ae235b |
If this information is not provided by the environment, this function
|
|
Packit |
ae235b |
will return NULL.
|
|
Packit |
ae235b |
This function does not take in consideration associations added with
|
|
Packit |
ae235b |
g_app_info_add_supports_type(), but only those exported directly by
|
|
Packit |
ae235b |
the application.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
appinfo
|
|
Packit |
ae235b |
a GAppInfo that can handle files
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a list of content types.
|
|
Packit |
ae235b |
[transfer none][array zero-terminated=1][element-type utf8]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.34
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_all ()
|
|
Packit |
ae235b |
GList *
|
|
Packit |
ae235b |
g_app_info_get_all (void);
|
|
Packit |
ae235b |
Gets a list of all of the applications currently registered
|
|
Packit |
ae235b |
on this system.
|
|
Packit |
ae235b |
For desktop files, this includes applications that have
|
|
Packit |
ae235b |
NoDisplay=true set or are excluded from display by means
|
|
Packit |
ae235b |
of OnlyShowIn or NotShowIn. See g_app_info_should_show().
|
|
Packit |
ae235b |
The returned list does not include applications which have
|
|
Packit |
ae235b |
the Hidden key set.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a newly allocated GList of references to GAppInfos.
|
|
Packit |
ae235b |
[element-type GAppInfo][transfer full]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_all_for_type ()
|
|
Packit |
ae235b |
GList *
|
|
Packit |
ae235b |
g_app_info_get_all_for_type (const char *content_type);
|
|
Packit |
ae235b |
Gets a list of all GAppInfos for a given content type,
|
|
Packit |
ae235b |
including the recommended and fallback GAppInfos. See
|
|
Packit |
ae235b |
g_app_info_get_recommended_for_type() and
|
|
Packit |
ae235b |
g_app_info_get_fallback_for_type().
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
content_type
|
|
Packit |
ae235b |
the content type to find a GAppInfo for
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
GList of GAppInfos
|
|
Packit |
ae235b |
for given content_type
|
|
Packit |
ae235b |
or NULL on error.
|
|
Packit |
ae235b |
[element-type GAppInfo][transfer full]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_default_for_type ()
|
|
Packit |
ae235b |
GAppInfo *
|
|
Packit |
ae235b |
g_app_info_get_default_for_type (const char *content_type,
|
|
Packit |
ae235b |
gboolean must_support_uris);
|
|
Packit |
ae235b |
Gets the default GAppInfo for a given content type.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
content_type
|
|
Packit |
ae235b |
the content type to find a GAppInfo for
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
must_support_uris
|
|
Packit |
ae235b |
if TRUE, the GAppInfo is expected to
|
|
Packit |
ae235b |
support URIs
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
GAppInfo for given content_type
|
|
Packit |
ae235b |
or
|
|
Packit |
ae235b |
NULL on error.
|
|
Packit |
ae235b |
[transfer full]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_default_for_uri_scheme ()
|
|
Packit |
ae235b |
GAppInfo *
|
|
Packit |
ae235b |
g_app_info_get_default_for_uri_scheme (const char *uri_scheme);
|
|
Packit |
ae235b |
Gets the default application for handling URIs with
|
|
Packit |
ae235b |
the given URI scheme. A URI scheme is the initial part
|
|
Packit |
ae235b |
of the URI, up to but not including the ':', e.g. "http",
|
|
Packit |
ae235b |
"ftp" or "sip".
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri_scheme
|
|
Packit |
ae235b |
a string containing a URI scheme.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
GAppInfo for given uri_scheme
|
|
Packit |
ae235b |
or NULL on error.
|
|
Packit |
ae235b |
[transfer full]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_fallback_for_type ()
|
|
Packit |
ae235b |
GList *
|
|
Packit |
ae235b |
g_app_info_get_fallback_for_type (const gchar *content_type);
|
|
Packit |
ae235b |
Gets a list of fallback GAppInfos for a given content type, i.e.
|
|
Packit |
ae235b |
those applications which claim to support the given content type
|
|
Packit |
ae235b |
by MIME type subclassing and not directly.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
content_type
|
|
Packit |
ae235b |
the content type to find a GAppInfo for
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
GList of GAppInfos
|
|
Packit |
ae235b |
for given content_type
|
|
Packit |
ae235b |
or NULL on error.
|
|
Packit |
ae235b |
[element-type GAppInfo][transfer full]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.28
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_get_recommended_for_type ()
|
|
Packit |
ae235b |
GList *
|
|
Packit |
ae235b |
g_app_info_get_recommended_for_type (const gchar *content_type);
|
|
Packit |
ae235b |
Gets a list of recommended GAppInfos for a given content type, i.e.
|
|
Packit |
ae235b |
those applications which claim to support the given content type exactly,
|
|
Packit |
ae235b |
and not by MIME type subclassing.
|
|
Packit |
ae235b |
Note that the first application of the list is the last used one, i.e.
|
|
Packit |
ae235b |
the last one for which g_app_info_set_as_last_used_for_type() has been
|
|
Packit |
ae235b |
called.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
content_type
|
|
Packit |
ae235b |
the content type to find a GAppInfo for
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
GList of GAppInfos
|
|
Packit |
ae235b |
for given content_type
|
|
Packit |
ae235b |
or NULL on error.
|
|
Packit |
ae235b |
[element-type GAppInfo][transfer full]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.28
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_launch_default_for_uri ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_app_info_launch_default_for_uri (const char *uri,
|
|
Packit |
ae235b |
GAppLaunchContext *context,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Utility function that launches the default application
|
|
Packit |
ae235b |
registered to handle the specified uri. Synchronous I/O
|
|
Packit |
ae235b |
is done on the uri to detect the type of the file if
|
|
Packit |
ae235b |
required.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
the uri to show
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
context
|
|
Packit |
ae235b |
an optional GAppLaunchContext.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for an error, or NULL.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE on success, FALSE on error.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_launch_default_for_uri_async ()
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_app_info_launch_default_for_uri_async
|
|
Packit |
ae235b |
(const char *uri,
|
|
Packit |
ae235b |
GAppLaunchContext *context,
|
|
Packit |
ae235b |
GCancellable *cancellable,
|
|
Packit |
ae235b |
GAsyncReadyCallback callback,
|
|
Packit |
ae235b |
gpointer user_data);
|
|
Packit |
ae235b |
Async version of g_app_info_launch_default_for_uri().
|
|
Packit |
ae235b |
This version is useful if you are interested in receiving
|
|
Packit |
ae235b |
error information in the case where the application is
|
|
Packit |
ae235b |
sandboxed and the portal may present an application chooser
|
|
Packit |
ae235b |
dialog to the user.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
uri
|
|
Packit |
ae235b |
the uri to show
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
context
|
|
Packit |
ae235b |
an optional GAppLaunchContext.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
cancellable
|
|
Packit |
ae235b |
a GCancellable.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
callback
|
|
Packit |
ae235b |
a GASyncReadyCallback to call when the request is done.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
user_data
|
|
Packit |
ae235b |
data to pass to callback
|
|
Packit |
ae235b |
.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.50
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_info_launch_default_for_uri_finish ()
|
|
Packit |
ae235b |
gboolean
|
|
Packit |
ae235b |
g_app_info_launch_default_for_uri_finish
|
|
Packit |
ae235b |
(GAsyncResult *result,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
Finishes an asynchronous launch-default-for-uri operation.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
result
|
|
Packit |
ae235b |
a GAsyncResult
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
error
|
|
Packit |
ae235b |
return location for an error, or NULL.
|
|
Packit |
ae235b |
[nullable]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
TRUE if the launch was successful, FALSE if error
|
|
Packit |
ae235b |
is set
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.50
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_launch_context_setenv ()
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_app_launch_context_setenv (GAppLaunchContext *context,
|
|
Packit |
ae235b |
const char *variable,
|
|
Packit |
ae235b |
const char *value);
|
|
Packit |
ae235b |
Arranges for variable
|
|
Packit |
ae235b |
to be set to value
|
|
Packit |
ae235b |
in the child's
|
|
Packit |
ae235b |
environment when context
|
|
Packit |
ae235b |
is used to launch an application.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
context
|
|
Packit |
ae235b |
a GAppLaunchContext
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
variable
|
|
Packit |
ae235b |
the environment variable to set.
|
|
Packit |
ae235b |
[type filename]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
value
|
|
Packit |
ae235b |
the value for to set the variable to.
|
|
Packit |
ae235b |
[type filename]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.32
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_launch_context_unsetenv ()
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_app_launch_context_unsetenv (GAppLaunchContext *context,
|
|
Packit |
ae235b |
const char *variable);
|
|
Packit |
ae235b |
Arranges for variable
|
|
Packit |
ae235b |
to be unset in the child's environment
|
|
Packit |
ae235b |
when context
|
|
Packit |
ae235b |
is used to launch an application.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
context
|
|
Packit |
ae235b |
a GAppLaunchContext
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
variable
|
|
Packit |
ae235b |
the environment variable to remove.
|
|
Packit |
ae235b |
[type filename]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.32
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_launch_context_get_environment ()
|
|
Packit |
ae235b |
char **
|
|
Packit |
ae235b |
g_app_launch_context_get_environment (GAppLaunchContext *context);
|
|
Packit |
ae235b |
Gets the complete environment variable list to be passed to
|
|
Packit |
ae235b |
the child process when context
|
|
Packit |
ae235b |
is used to launch an application.
|
|
Packit |
ae235b |
This is a NULL-terminated array of strings, where each string has
|
|
Packit |
ae235b |
the form KEY=VALUE.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
context
|
|
Packit |
ae235b |
a GAppLaunchContext
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
the child's environment.
|
|
Packit |
ae235b |
[array zero-terminated=1][element-type filename][transfer full]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Since: 2.32
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_launch_context_get_display ()
|
|
Packit |
ae235b |
char *
|
|
Packit |
ae235b |
g_app_launch_context_get_display (GAppLaunchContext *context,
|
|
Packit |
ae235b |
GAppInfo *info,
|
|
Packit |
ae235b |
GList *files);
|
|
Packit |
ae235b |
Gets the display string for the context
|
|
Packit |
ae235b |
. This is used to ensure new
|
|
Packit |
ae235b |
applications are started on the same display as the launching
|
|
Packit |
ae235b |
application, by setting the DISPLAY environment variable.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
context
|
|
Packit |
ae235b |
a GAppLaunchContext
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
info
|
|
Packit |
ae235b |
a GAppInfo
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
files
|
|
Packit |
ae235b |
a GList of GFile objects.
|
|
Packit |
ae235b |
[element-type GFile]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a display string for the display.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_launch_context_get_startup_notify_id ()
|
|
Packit |
ae235b |
char *
|
|
Packit |
ae235b |
g_app_launch_context_get_startup_notify_id
|
|
Packit |
ae235b |
(GAppLaunchContext *context,
|
|
Packit |
ae235b |
GAppInfo *info,
|
|
Packit |
ae235b |
GList *files);
|
|
Packit |
ae235b |
Initiates startup notification for the application and returns the
|
|
Packit |
ae235b |
DESKTOP_STARTUP_ID for the launched operation, if supported.
|
|
Packit |
ae235b |
Startup notification IDs are defined in the
|
|
Packit |
ae235b |
[FreeDesktop.Org Startup Notifications standard](http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt").
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
context
|
|
Packit |
ae235b |
a GAppLaunchContext
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
info
|
|
Packit |
ae235b |
a GAppInfo
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
files
|
|
Packit |
ae235b |
a GList of of GFile objects.
|
|
Packit |
ae235b |
[element-type GFile]
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a startup notification ID for the application, or NULL if
|
|
Packit |
ae235b |
not supported.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_launch_context_launch_failed ()
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
g_app_launch_context_launch_failed (GAppLaunchContext *context,
|
|
Packit |
ae235b |
const char *startup_notify_id);
|
|
Packit |
ae235b |
Called when an application has failed to launch, so that it can cancel
|
|
Packit |
ae235b |
the application startup notification started in g_app_launch_context_get_startup_notify_id().
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
context
|
|
Packit |
ae235b |
a GAppLaunchContext.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
startup_notify_id
|
|
Packit |
ae235b |
the startup notification id that was returned by g_app_launch_context_get_startup_notify_id().
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
g_app_launch_context_new ()
|
|
Packit |
ae235b |
GAppLaunchContext *
|
|
Packit |
ae235b |
g_app_launch_context_new (void);
|
|
Packit |
ae235b |
Creates a new application launch context. This is not normally used,
|
|
Packit |
ae235b |
instead you instantiate a subclass of this, such as GdkAppLaunchContext.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Returns
|
|
Packit |
ae235b |
a GAppLaunchContext.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Types and Values
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
enum GAppInfoCreateFlags
|
|
Packit |
ae235b |
Flags used when creating a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Members
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
G_APP_INFO_CREATE_NONE
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
No flags.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
G_APP_INFO_CREATE_NEEDS_TERMINAL
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Application opens in a terminal window.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
G_APP_INFO_CREATE_SUPPORTS_URIS
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Application supports URI arguments.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
G_APP_INFO_CREATE_SUPPORTS_STARTUP_NOTIFICATION
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Application supports startup notification. Since 2.26
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GAppInfo
|
|
Packit |
ae235b |
typedef struct _GAppInfo GAppInfo;
|
|
Packit |
ae235b |
Information about an installed application and methods to launch
|
|
Packit |
ae235b |
it (with file arguments).
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
struct GAppInfoIface
|
|
Packit |
ae235b |
struct GAppInfoIface {
|
|
Packit |
ae235b |
GTypeInterface g_iface;
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
/* Virtual Table */
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GAppInfo * (* dup) (GAppInfo *appinfo);
|
|
Packit |
ae235b |
gboolean (* equal) (GAppInfo *appinfo1,
|
|
Packit |
ae235b |
GAppInfo *appinfo2);
|
|
Packit |
ae235b |
const char * (* get_id) (GAppInfo *appinfo);
|
|
Packit |
ae235b |
const char * (* get_name) (GAppInfo *appinfo);
|
|
Packit |
ae235b |
const char * (* get_description) (GAppInfo *appinfo);
|
|
Packit |
ae235b |
const char * (* get_executable) (GAppInfo *appinfo);
|
|
Packit |
ae235b |
GIcon * (* get_icon) (GAppInfo *appinfo);
|
|
Packit |
ae235b |
gboolean (* launch) (GAppInfo *appinfo,
|
|
Packit |
ae235b |
GList *files,
|
|
Packit |
ae235b |
GAppLaunchContext *context,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
gboolean (* supports_uris) (GAppInfo *appinfo);
|
|
Packit |
ae235b |
gboolean (* supports_files) (GAppInfo *appinfo);
|
|
Packit |
ae235b |
gboolean (* launch_uris) (GAppInfo *appinfo,
|
|
Packit |
ae235b |
GList *uris,
|
|
Packit |
ae235b |
GAppLaunchContext *context,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
gboolean (* should_show) (GAppInfo *appinfo);
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
/* For changing associations */
|
|
Packit |
ae235b |
gboolean (* set_as_default_for_type) (GAppInfo *appinfo,
|
|
Packit |
ae235b |
const char *content_type,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
gboolean (* set_as_default_for_extension) (GAppInfo *appinfo,
|
|
Packit |
ae235b |
const char *extension,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
gboolean (* add_supports_type) (GAppInfo *appinfo,
|
|
Packit |
ae235b |
const char *content_type,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
gboolean (* can_remove_supports_type) (GAppInfo *appinfo);
|
|
Packit |
ae235b |
gboolean (* remove_supports_type) (GAppInfo *appinfo,
|
|
Packit |
ae235b |
const char *content_type,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
gboolean (* can_delete) (GAppInfo *appinfo);
|
|
Packit |
ae235b |
gboolean (* do_delete) (GAppInfo *appinfo);
|
|
Packit |
ae235b |
const char * (* get_commandline) (GAppInfo *appinfo);
|
|
Packit |
ae235b |
const char * (* get_display_name) (GAppInfo *appinfo);
|
|
Packit |
ae235b |
gboolean (* set_as_last_used_for_type) (GAppInfo *appinfo,
|
|
Packit |
ae235b |
const char *content_type,
|
|
Packit |
ae235b |
GError **error);
|
|
Packit |
ae235b |
const char ** (* get_supported_types) (GAppInfo *appinfo);
|
|
Packit |
ae235b |
};
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Application Information interface, for operating system portability.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Members
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
dup ()
|
|
Packit |
ae235b |
Copies a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
equal ()
|
|
Packit |
ae235b |
Checks two GAppInfos for equality.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
get_id ()
|
|
Packit |
ae235b |
Gets a string identifier for a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
get_name ()
|
|
Packit |
ae235b |
Gets the name of the application for a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
get_description ()
|
|
Packit |
ae235b |
Gets a short description for the application described by the GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
get_executable ()
|
|
Packit |
ae235b |
Gets the executable name for the GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
get_icon ()
|
|
Packit |
ae235b |
Gets the GIcon for the GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
launch ()
|
|
Packit |
ae235b |
Launches an application specified by the GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
supports_uris ()
|
|
Packit |
ae235b |
Indicates whether the application specified supports launching URIs.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
supports_files ()
|
|
Packit |
ae235b |
Indicates whether the application specified accepts filename arguments.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
launch_uris ()
|
|
Packit |
ae235b |
Launches an application with a list of URIs.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
should_show ()
|
|
Packit |
ae235b |
Returns whether an application should be shown (e.g. when getting a list of installed applications).
|
|
Packit |
ae235b |
FreeDesktop.Org Startup Notification Specification.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
set_as_default_for_type ()
|
|
Packit |
ae235b |
Sets an application as default for a given content type.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
set_as_default_for_extension ()
|
|
Packit |
ae235b |
Sets an application as default for a given file extension.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
add_supports_type ()
|
|
Packit |
ae235b |
Adds to the GAppInfo information about supported file types.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
can_remove_supports_type ()
|
|
Packit |
ae235b |
Checks for support for removing supported file types from a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
remove_supports_type ()
|
|
Packit |
ae235b |
Removes a supported application type from a GAppInfo.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
can_delete ()
|
|
Packit |
ae235b |
Checks if a GAppInfo can be deleted. Since 2.20
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
do_delete ()
|
|
Packit |
ae235b |
Deletes a GAppInfo. Since 2.20
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
get_commandline ()
|
|
Packit |
ae235b |
Gets the commandline for the GAppInfo. Since 2.20
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
get_display_name ()
|
|
Packit |
ae235b |
Gets the display name for the GAppInfo. Since 2.24
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
set_as_last_used_for_type ()
|
|
Packit |
ae235b |
Sets the application as the last used. See g_app_info_set_as_last_used_for_type().
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
get_supported_types ()
|
|
Packit |
ae235b |
Retrieves the list of content types that app_info
|
|
Packit |
ae235b |
claims to support.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
GAppLaunchContext
|
|
Packit |
ae235b |
typedef struct _GAppLaunchContext GAppLaunchContext;
|
|
Packit |
ae235b |
Integrating the launch with the launching application. This is used to
|
|
Packit |
ae235b |
handle for instance startup notification and launching the new application
|
|
Packit |
ae235b |
on the same screen as the launching window.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Signal Details
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
The “launch-failed” signal
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
user_function (GAppLaunchContext *context,
|
|
Packit |
ae235b |
gchar *startup_notify_id,
|
|
Packit |
ae235b |
gpointer user_data)
|
|
Packit |
ae235b |
The ::launch-failed signal is emitted when a GAppInfo launch
|
|
Packit |
ae235b |
fails. The startup notification id is provided, so that the launcher
|
|
Packit |
ae235b |
can cancel the startup notification.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
context
|
|
Packit |
ae235b |
the object emitting the signal
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
startup_notify_id
|
|
Packit |
ae235b |
the startup notification id for the failed launch
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
user_data
|
|
Packit |
ae235b |
user data set when the signal handler was connected.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Flags: Run Last
|
|
Packit |
ae235b |
Since: 2.36
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
The “launched” signal
|
|
Packit |
ae235b |
void
|
|
Packit |
ae235b |
user_function (GAppLaunchContext *context,
|
|
Packit |
ae235b |
GAppInfo *info,
|
|
Packit |
ae235b |
GVariant *platform_data,
|
|
Packit |
ae235b |
gpointer user_data)
|
|
Packit |
ae235b |
The ::launched signal is emitted when a GAppInfo is successfully
|
|
Packit |
ae235b |
launched. The platform_data
|
|
Packit |
ae235b |
is an GVariant dictionary mapping
|
|
Packit |
ae235b |
strings to variants (ie a{sv}), which contains additional,
|
|
Packit |
ae235b |
platform-specific data about this launch. On UNIX, at least the
|
|
Packit |
ae235b |
"pid" and "startup-notification-id" keys will be present.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Parameters
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
context
|
|
Packit |
ae235b |
the object emitting the signal
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
info
|
|
Packit |
ae235b |
the GAppInfo that was just launched
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
platform_data
|
|
Packit |
ae235b |
additional platform-specific data for this launch
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
user_data
|
|
Packit |
ae235b |
user data set when the signal handler was connected.
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Flags: Run Last
|
|
Packit |
ae235b |
Since: 2.36
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
See Also
|
|
Packit |
ae235b |
GAppInfoMonitor
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
|
|
Packit |
ae235b |
Generated by GTK-Doc V1.27
|
|
Packit |
ae235b |
</body>
|
|
Packit |
ae235b |
</html>
|