docs/reference/gio/html/gio-Desktop-file-based-GAppInfo.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>Desktop file based GAppInfo</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
   7 <link rel="home" href="index.html" title="GIO Reference Manual">
   8 <link rel="up" href="types.html" title="File types and applications">
   9 <link rel="prev" href="GAppInfo.html" title="GAppInfo">
  10 <link rel="next" href="volume_mon.html" title="Volumes and Drives">
  11 <meta name="generator" content="GTK-Doc V1.13 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 <link rel="part" href="pt01.html" title="Part I. GIO Overview">
  14 <link rel="chapter" href="ch01.html" title="Introduction">
  15 <link rel="chapter" href="ch02.html" title="Compiling GIO applications">
  16 <link rel="chapter" href="ch03.html" title="Running GIO applications">
  17 <link rel="chapter" href="extending-gio.html" title="Extending GIO">
  18 <link rel="part" href="pt02.html" title="Part II. API Reference">
  19 <link rel="chapter" href="file_ops.html" title="File Operations">
  20 <link rel="chapter" href="file_mon.html" title="File System Monitoring">
  21 <link rel="chapter" href="async.html" title="Asynchronous I/O">
  22 <link rel="chapter" href="conversion.html" title="Data conversion">
  23 <link rel="chapter" href="streaming.html" title="Streaming I/O">
  24 <link rel="chapter" href="types.html" title="File types and applications">
  25 <link rel="chapter" href="volume_mon.html" title="Volumes and Drives">
  26 <link rel="chapter" href="icons.html" title="Icons">
  27 <link rel="chapter" href="failable_initialization.html" title="Failable Initialization">
  28 <link rel="chapter" href="networking.html" title="Lowlevel platform-independent network support">
  29 <link rel="chapter" href="resolver.html" title="DNS resolution">
  30 <link rel="chapter" href="highlevel-socket.html" title="Highlevel network functionallity">
  31 <link rel="chapter" href="utils.html" title="Utilities">
  32 <link rel="chapter" href="extending.html" title="Extending GIO">
  33 <link rel="part" href="migrating.html" title="Part III. Migrating to GIO">
  34 <link rel="chapter" href="ch19.html" title="Migrating from POSIX to GIO">
  35 <link rel="chapter" href="ch20.html" title="Migrating from GnomeVFS to GIO">
  36 <link rel="chapter" href="gio-hierarchy.html" title="Object Hierarchy">
  37 <link rel="index" href="api-index-full.html" title="Index">
  38 <link rel="index" href="api-index-deprecated.html" title="Index of deprecated symbols">
  39 <link rel="index" href="api-index-2-18.html" title="Index of new symbols in 2.18">
  40 <link rel="index" href="api-index-2-20.html" title="Index of new symbols in 2.20">
  41 <link rel="index" href="api-index-2-22.html" title="Index of new symbols in 2.22">
  42 <link rel="index" href="api-index-2-24.html" title="Index of new symbols in 2.24">
  43 </head>
  44 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  45 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  46 <tr valign="middle">
  47 <td><a accesskey="p" href="GAppInfo.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  48 <td><a accesskey="u" href="types.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  49 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  50 <th width="100%" align="center">GIO Reference Manual</th>
  51 <td><a accesskey="n" href="volume_mon.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  52 </tr>
  53 <tr><td colspan="5" class="shortcuts">
  54 <a href="#gio-Desktop-file-based-GAppInfo.synopsis" class="shortcut">Top</a>
  55                    |
  56                   <a href="#gio-Desktop-file-based-GAppInfo.description" class="shortcut">Description</a>
  57                    |
  58                   <a href="#gio-Desktop-file-based-GAppInfo.object-hierarchy" class="shortcut">Object Hierarchy</a>
  59                    |
  60                   <a href="#gio-Desktop-file-based-GAppInfo.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
  61                    |
  62                   <a href="#gio-Desktop-file-based-GAppInfo.prerequisites" class="shortcut">Prerequisites</a>
  63 </td></tr>
  64 </table>
  65 <div class="refentry" title="Desktop file based GAppInfo">
  66 <a name="gio-Desktop-file-based-GAppInfo"></a><div class="titlepage"></div>
  67 <div class="refnamediv"><table width="100%"><tr>
  68 <td valign="top">
  69 <h2><span class="refentrytitle"><a name="gio-Desktop-file-based-GAppInfo.top_of_page"></a>Desktop file based GAppInfo</span></h2>
  70 <p>Desktop file based GAppInfo — Application information from desktop files</p>
  71 </td>
  72 <td valign="top" align="right"></td>
  73 </tr></table></div>
  74 <div class="refsynopsisdiv" title="Synopsis">
  75 <a name="gio-Desktop-file-based-GAppInfo.synopsis"></a><h2>Synopsis</h2>
  76 <a name="GDesktopAppInfo"></a><a name="GDesktopAppInfoLookup"></a><pre class="synopsis">
  77 #include &lt;gio/gdesktopappinfo.h&gt;
  78
  79                     <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo-struct" title="GDesktopAppInfo">GDesktopAppInfo</a>;
  80 <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="returnvalue">GDesktopAppInfo</span></a> *   <a class="link" href="gio-Desktop-file-based-GAppInfo.html#g-desktop-app-info-new-from-filename" title="g_desktop_app_info_new_from_filename ()">g_desktop_app_info_new_from_filename</a>
  81                                                         (const <span class="returnvalue">char</span> *filename);
  82 <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="returnvalue">GDesktopAppInfo</span></a> *   <a class="link" href="gio-Desktop-file-based-GAppInfo.html#g-desktop-app-info-new-from-keyfile" title="g_desktop_app_info_new_from_keyfile ()">g_desktop_app_info_new_from_keyfile</a> (<a href="http://library.gnome.org/devel/glib/unstable/glib-Key-value-file-parser.html#GKeyFile"><span class="returnvalue">GKeyFile</span></a> *key_file);
  83 <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="returnvalue">GDesktopAppInfo</span></a> *   <a class="link" href="gio-Desktop-file-based-GAppInfo.html#g-desktop-app-info-new" title="g_desktop_app_info_new ()">g_desktop_app_info_new</a>              (const <span class="returnvalue">char</span> *desktop_id);
  84 const <span class="returnvalue">char</span> *        <a class="link" href="gio-Desktop-file-based-GAppInfo.html#g-desktop-app-info-get-filename" title="g_desktop_app_info_get_filename ()">g_desktop_app_info_get_filename</a>     (<a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="returnvalue">GDesktopAppInfo</span></a> *info);
  85 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gio-Desktop-file-based-GAppInfo.html#g-desktop-app-info-get-is-hidden" title="g_desktop_app_info_get_is_hidden ()">g_desktop_app_info_get_is_hidden</a>    (<a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="returnvalue">GDesktopAppInfo</span></a> *info);
  86 <span class="returnvalue">void</span>                <a class="link" href="gio-Desktop-file-based-GAppInfo.html#g-desktop-app-info-set-desktop-env" title="g_desktop_app_info_set_desktop_env ()">g_desktop_app_info_set_desktop_env</a>  (const <span class="returnvalue">char</span> *desktop_env);
  87                     <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfoLookup-struct" title="GDesktopAppInfoLookup">GDesktopAppInfoLookup</a>;
  88 #define             <a class="link" href="gio-Desktop-file-based-GAppInfo.html#G-DESKTOP-APP-INFO-LOOKUP-EXTENSION-POINT-NAME:CAPS" title="G_DESKTOP_APP_INFO_LOOKUP_EXTENSION_POINT_NAME">G_DESKTOP_APP_INFO_LOOKUP_EXTENSION_POINT_NAME</a>
  89 <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="returnvalue">GAppInfo</span></a> *          <a class="link" href="gio-Desktop-file-based-GAppInfo.html#g-desktop-app-info-lookup-get-default-for-uri-scheme" title="g_desktop_app_info_lookup_get_default_for_uri_scheme ()">g_desktop_app_info_lookup_get_default_for_uri_scheme</a>
  90                                                         (<a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfoLookup"><span class="returnvalue">GDesktopAppInfoLookup</span></a> *lookup,
  91                                                          const <span class="returnvalue">char</span> *uri_scheme);
  92 </pre>
  93 </div>
  94 <div class="refsect1" title="Object Hierarchy">
  95 <a name="gio-Desktop-file-based-GAppInfo.object-hierarchy"></a><h2>Object Hierarchy</h2>
  96 <pre class="synopsis">
  97   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
  98    +----GDesktopAppInfo
  99 </pre>
 100 <pre class="synopsis">
 101   GInterface
 102    +----GDesktopAppInfoLookup
 103 </pre>
 104 </div>
 105 <div class="refsect1" title="Prerequisites">
 106 <a name="gio-Desktop-file-based-GAppInfo.prerequisites"></a><h2>Prerequisites</h2>
 107 <p>
 108 GDesktopAppInfoLookup requires
 109  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>.</p>
 110 </div>
 111 <div class="refsect1" title="Implemented Interfaces">
 112 <a name="gio-Desktop-file-based-GAppInfo.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
 113 <p>
 114 GDesktopAppInfo implements
 115  <a class="link" href="GAppInfo.html" title="GAppInfo">GAppInfo</a>.</p>
 116 </div>
 117 <div class="refsect1" title="Description">
 118 <a name="gio-Desktop-file-based-GAppInfo.description"></a><h2>Description</h2>
 119 <p>
 120 <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a> is an implementation of <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a> based on
 121 desktop files.
 122 </p>
 123 <p>
 124 Note that <code class="filename">&lt;gio/gdesktopappinfo.h&gt;</code> belongs to
 125 the UNIX-specific GIO interfaces, thus you have to use the
 126 <code class="filename">gio-unix-2.0.pc</code> pkg-config file when using it.</p>
 127 </div>
 128 <div class="refsect1" title="Details">
 129 <a name="gio-Desktop-file-based-GAppInfo.details"></a><h2>Details</h2>
 130 <div class="refsect2" title="GDesktopAppInfo">
 131 <a name="GDesktopAppInfo-struct"></a><h3>GDesktopAppInfo</h3>
 132 <pre class="programlisting">typedef struct _GDesktopAppInfo GDesktopAppInfo;</pre>
 133 <p>
 134 Information about an installed application from a desktop file.</p>
 135 </div>
 136 <hr>
 137 <div class="refsect2" title="g_desktop_app_info_new_from_filename ()">
 138 <a name="g-desktop-app-info-new-from-filename"></a><h3>g_desktop_app_info_new_from_filename ()</h3>
 139 <pre class="programlisting"><a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="returnvalue">GDesktopAppInfo</span></a> *   g_desktop_app_info_new_from_filename
 140                                                         (const <span class="returnvalue">char</span> *filename);</pre>
 141 <p>
 142 Creates a new <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a>.</p>
 143 <div class="variablelist"><table border="0">
 144 <col align="left" valign="top">
 145 <tbody>
 146 <tr>
 147 <td><p><span class="term"><em class="parameter"><code>filename</code></em> :</span></p></td>
 148 <td> the path of a desktop file, in the GLib filename encoding
 149 </td>
 150 </tr>
 151 <tr>
 152 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 153 <td> a new <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
 154 </td>
 155 </tr>
 156 </tbody>
 157 </table></div>
 158 </div>
 159 <hr>
 160 <div class="refsect2" title="g_desktop_app_info_new_from_keyfile ()">
 161 <a name="g-desktop-app-info-new-from-keyfile"></a><h3>g_desktop_app_info_new_from_keyfile ()</h3>
 162 <pre class="programlisting"><a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="returnvalue">GDesktopAppInfo</span></a> *   g_desktop_app_info_new_from_keyfile (<a href="http://library.gnome.org/devel/glib/unstable/glib-Key-value-file-parser.html#GKeyFile"><span class="returnvalue">GKeyFile</span></a> *key_file);</pre>
 163 <p>
 164 Creates a new <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a>.</p>
 165 <div class="variablelist"><table border="0">
 166 <col align="left" valign="top">
 167 <tbody>
 168 <tr>
 169 <td><p><span class="term"><em class="parameter"><code>key_file</code></em> :</span></p></td>
 170 <td> an opened <a href="http://library.gnome.org/devel/glib/unstable/glib-Key-value-file-parser.html#GKeyFile"><span class="type">GKeyFile</span></a>
 171 </td>
 172 </tr>
 173 <tr>
 174 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 175 <td> a new <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
 176
 177 </td>
 178 </tr>
 179 </tbody>
 180 </table></div>
 181 <p class="since">Since 2.18</p>
 182 </div>
 183 <hr>
 184 <div class="refsect2" title="g_desktop_app_info_new ()">
 185 <a name="g-desktop-app-info-new"></a><h3>g_desktop_app_info_new ()</h3>
 186 <pre class="programlisting"><a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="returnvalue">GDesktopAppInfo</span></a> *   g_desktop_app_info_new              (const <span class="returnvalue">char</span> *desktop_id);</pre>
 187 <p>
 188 Creates a new <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a> based on a desktop file id.
 189 </p>
 190 <p>
 191 A desktop file id is the basename of the desktop file, including the
 192 .desktop extension. GIO is looking for a desktop file with this name
 193 in the <code class="filename">applications</code> subdirectories of the XDG data
 194 directories (i.e. the directories specified in the
 195 <code class="envar">XDG_DATA_HOME</code> and <code class="envar">XDG_DATA_DIRS</code> environment
 196 variables). GIO also supports the prefix-to-subdirectory mapping that is
 197 described in the <a class="ulink" href="http://standards.freedesktop.org/menu-spec/latest/" target="_top">Menu Spec</a>
 198 (i.e. a desktop id of kde-foo.desktop will match
 199 <code class="filename">/usr/share/applications/kde/foo.desktop</code>).</p>
 200 <div class="variablelist"><table border="0">
 201 <col align="left" valign="top">
 202 <tbody>
 203 <tr>
 204 <td><p><span class="term"><em class="parameter"><code>desktop_id</code></em> :</span></p></td>
 205 <td> the desktop file id
 206 </td>
 207 </tr>
 208 <tr>
 209 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 210 <td> a new <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no desktop file with that id
 211 </td>
 212 </tr>
 213 </tbody>
 214 </table></div>
 215 </div>
 216 <hr>
 217 <div class="refsect2" title="g_desktop_app_info_get_filename ()">
 218 <a name="g-desktop-app-info-get-filename"></a><h3>g_desktop_app_info_get_filename ()</h3>
 219 <pre class="programlisting">const <span class="returnvalue">char</span> *        g_desktop_app_info_get_filename     (<a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="returnvalue">GDesktopAppInfo</span></a> *info);</pre>
 220 <p>
 221 When <em class="parameter"><code>info</code></em> was created from a known filename, return it.  In some
 222 situations such as the <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a> returned from
 223 <a class="link" href="gio-Desktop-file-based-GAppInfo.html#g-desktop-app-info-new-from-keyfile" title="g_desktop_app_info_new_from_keyfile ()"><code class="function">g_desktop_app_info_new_from_keyfile()</code></a>, this function will return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
 224 <div class="variablelist"><table border="0">
 225 <col align="left" valign="top">
 226 <tbody>
 227 <tr>
 228 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 229 <td> a <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a>
 230 </td>
 231 </tr>
 232 <tr>
 233 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 234 <td> The full path to the file for <em class="parameter"><code>info</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if not known.
 235 </td>
 236 </tr>
 237 </tbody>
 238 </table></div>
 239 <p class="since">Since 2.24</p>
 240 </div>
 241 <hr>
 242 <div class="refsect2" title="g_desktop_app_info_get_is_hidden ()">
 243 <a name="g-desktop-app-info-get-is-hidden"></a><h3>g_desktop_app_info_get_is_hidden ()</h3>
 244 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_desktop_app_info_get_is_hidden    (<a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="returnvalue">GDesktopAppInfo</span></a> *info);</pre>
 245 <p>
 246 A desktop file is hidden if the Hidden key in it is
 247 set to True.</p>
 248 <div class="variablelist"><table border="0">
 249 <col align="left" valign="top">
 250 <tbody>
 251 <tr>
 252 <td><p><span class="term"><em class="parameter"><code>info</code></em> :</span></p></td>
 253 <td> a <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfo"><span class="type">GDesktopAppInfo</span></a>.
 254 </td>
 255 </tr>
 256 <tr>
 257 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 258 <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if hidden, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
 259 </td>
 260 </tr>
 261 </tbody>
 262 </table></div>
 263 </div>
 264 <hr>
 265 <div class="refsect2" title="g_desktop_app_info_set_desktop_env ()">
 266 <a name="g-desktop-app-info-set-desktop-env"></a><h3>g_desktop_app_info_set_desktop_env ()</h3>
 267 <pre class="programlisting"><span class="returnvalue">void</span>                g_desktop_app_info_set_desktop_env  (const <span class="returnvalue">char</span> *desktop_env);</pre>
 268 <p>
 269 Sets the name of the desktop that the application is running in.
 270 This is used by <a class="link" href="GAppInfo.html#g-app-info-should-show" title="g_app_info_should_show ()"><code class="function">g_app_info_should_show()</code></a> to evaluate the
 271 <code class="literal">OnlyShowIn</code> and <code class="literal">NotShowIn</code>
 272 desktop entry fields.
 273 </p>
 274 <p>
 275 The <a class="ulink" href="http://standards.freedesktop.org/menu-spec/latest/" target="_top">Desktop
 276 Menu specification</a> recognizes the following:
 277 </p>
 278 <table border="0" summary="Simple list" class="simplelist">
 279 <tr><td>GNOME</td></tr>
 280 <tr><td>KDE</td></tr>
 281 <tr><td>ROX</td></tr>
 282 <tr><td>XFCE</td></tr>
 283 <tr><td>Old</td></tr>
 284 </table>
 285 <p>
 286 </p>
 287 <p>
 288 Should be called only once; subsequent calls are ignored.</p>
 289 <div class="variablelist"><table border="0">
 290 <col align="left" valign="top">
 291 <tbody><tr>
 292 <td><p><span class="term"><em class="parameter"><code>desktop_env</code></em> :</span></p></td>
 293 <td> a string specifying what desktop this is
 294 </td>
 295 </tr></tbody>
 296 </table></div>
 297 </div>
 298 <hr>
 299 <div class="refsect2" title="GDesktopAppInfoLookup">
 300 <a name="GDesktopAppInfoLookup-struct"></a><h3>GDesktopAppInfoLookup</h3>
 301 <pre class="programlisting">typedef struct _GDesktopAppInfoLookup GDesktopAppInfoLookup;</pre>
 302 <p>
 303 Interface that is used by backends to associate default
 304 handlers with URI schemes.</p>
 305 </div>
 306 <hr>
 307 <div class="refsect2" title="G_DESKTOP_APP_INFO_LOOKUP_EXTENSION_POINT_NAME">
 308 <a name="G-DESKTOP-APP-INFO-LOOKUP-EXTENSION-POINT-NAME:CAPS"></a><h3>G_DESKTOP_APP_INFO_LOOKUP_EXTENSION_POINT_NAME</h3>
 309 <pre class="programlisting">#define G_DESKTOP_APP_INFO_LOOKUP_EXTENSION_POINT_NAME "gio-desktop-app-info-lookup"
 310 </pre>
 311 <p>
 312 Extension point for default handler to URI association. See
 313 Extending GIO.</p>
 314 </div>
 315 <hr>
 316 <div class="refsect2" title="g_desktop_app_info_lookup_get_default_for_uri_scheme ()">
 317 <a name="g-desktop-app-info-lookup-get-default-for-uri-scheme"></a><h3>g_desktop_app_info_lookup_get_default_for_uri_scheme ()</h3>
 318 <pre class="programlisting"><a class="link" href="GAppInfo.html" title="GAppInfo"><span class="returnvalue">GAppInfo</span></a> *          g_desktop_app_info_lookup_get_default_for_uri_scheme
 319                                                         (<a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfoLookup"><span class="returnvalue">GDesktopAppInfoLookup</span></a> *lookup,
 320                                                          const <span class="returnvalue">char</span> *uri_scheme);</pre>
 321 <p>
 322 Gets the default application for launching applications
 323 using this URI scheme for a particular GDesktopAppInfoLookup
 324 implementation.
 325 </p>
 326 <p>
 327 The GDesktopAppInfoLookup interface and this function is used
 328 to implement <a class="link" href="GAppInfo.html#g-app-info-get-default-for-uri-scheme" title="g_app_info_get_default_for_uri_scheme ()"><code class="function">g_app_info_get_default_for_uri_scheme()</code></a> backends
 329 in a GIO module. There is no reason for applications to use it
 330 directly. Applications should use <a class="link" href="GAppInfo.html#g-app-info-get-default-for-uri-scheme" title="g_app_info_get_default_for_uri_scheme ()"><code class="function">g_app_info_get_default_for_uri_scheme()</code></a>.</p>
 331 <div class="variablelist"><table border="0">
 332 <col align="left" valign="top">
 333 <tbody>
 334 <tr>
 335 <td><p><span class="term"><em class="parameter"><code>lookup</code></em> :</span></p></td>
 336 <td> a <a class="link" href="gio-Desktop-file-based-GAppInfo.html#GDesktopAppInfoLookup"><span class="type">GDesktopAppInfoLookup</span></a>
 337 </td>
 338 </tr>
 339 <tr>
 340 <td><p><span class="term"><em class="parameter"><code>uri_scheme</code></em> :</span></p></td>
 341 <td> a string containing a URI scheme.
 342 </td>
 343 </tr>
 344 <tr>
 345 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 346 <td> <a class="link" href="GAppInfo.html" title="GAppInfo"><span class="type">GAppInfo</span></a> for given <em class="parameter"><code>uri_scheme</code></em> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
 347 </td>
 348 </tr>
 349 </tbody>
 350 </table></div>
 351 </div>
 352 </div>
 353 </div>
 354 <div class="footer">
 355 <hr>
 356           Generated by GTK-Doc V1.13</div>
 357 </body>
 358 </html>