doc/html/gnome-vfs-20-gnome-vfs-application-registry.html

   1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Application Registry</title><meta name="generator" content="DocBook XSL Stylesheets V1.61.0"><meta name="generator" content="GTK-Doc V1.1 (XML mode)"><style type="text/css">
   2         .synopsis, .classsynopsis {
   3             background: #eeeeee;
   4             border: solid 1px #aaaaaa;
   5             padding: 0.5em;
   6         }
   7         .programlisting {
   8             background: #eeeeff;
   9             border: solid 1px #aaaaff;
  10             padding: 0.5em;
  11         }
  12         .variablelist {
  13             padding: 4px;
  14             margin-left: 3em;
  15         }
  16         .navigation {
  17             background: #ffeeee;
  18             border: solid 1px #ffaaaa;
  19             margin-top: 0.5em;
  20             margin-bottom: 0.5em;
  21         }
  22         .navigation a {
  23             color: #770000;
  24         }
  25         .navigation a:visited {
  26             color: #550000;
  27         }
  28         .navigation .title {
  29             font-size: 200%;
  30         }
  31       </style><link rel="home" href="index.html" title="GnomeVFS - Filesystem Abstraction library"><link rel="up" href="mime-registry.html" title="MIME Registry"><link rel="previous" href="mime-registry.html" title="MIME Registry"><link rel="next" href="gnome-vfs-20-gnome-vfs-mime-database.html" title="File Types"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="mime-registry.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="mime-registry.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">GnomeVFS - Filesystem Abstraction library</th><td><a accesskey="n" href="gnome-vfs-20-gnome-vfs-mime-database.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry" lang="en"><a name="gnome-vfs-20-gnome-vfs-application-registry"></a><div class="titlepage"><div></div><div></div></div><div class="refnamediv"><h2><span class="refentrytitle">Application Registry</span></h2><p>Application Registry &#8212;
  32 stores supported MIME types and URIs of various applications</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
  33
  34
  35
  36 #define     <a href="gnome-vfs-20-gnome-vfs-application-registry.html#GNOME-VFS-APPLICATION-REGISTRY-COMMAND-CAPS">GNOME_VFS_APPLICATION_REGISTRY_COMMAND</a>
  37 #define     <a href="gnome-vfs-20-gnome-vfs-application-registry.html#GNOME-VFS-APPLICATION-REGISTRY-NAME-CAPS">GNOME_VFS_APPLICATION_REGISTRY_NAME</a>
  38 #define     <a href="gnome-vfs-20-gnome-vfs-application-registry.html#GNOME-VFS-APPLICATION-REGISTRY-CAN-OPEN-MULTIPLE-FILES-CAPS">GNOME_VFS_APPLICATION_REGISTRY_CAN_OPEN_MULTIPLE_FILES</a>
  39 #define     <a href="gnome-vfs-20-gnome-vfs-application-registry.html#GNOME-VFS-APPLICATION-REGISTRY-REQUIRES-TERMINAL-CAPS">GNOME_VFS_APPLICATION_REGISTRY_REQUIRES_TERMINAL</a>
  40 <a
  41 href="../glib/glib-Basic-Types.html#gboolean"
  42 >gboolean</a>    <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-exists">gnome_vfs_application_registry_exists</a>
  43                                             (const char *app_id);
  44 <a
  45 href="../glib/glib-Doubly-Linked-Lists.html#GList"
  46 >GList</a>*      <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-get-keys">gnome_vfs_application_registry_get_keys</a>
  47                                             (const char *app_id);
  48 const char* <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-peek-value">gnome_vfs_application_registry_peek_value</a>
  49                                             (const char *app_id,
  50                                              const char *key);
  51 <a
  52 href="../glib/glib-Basic-Types.html#gboolean"
  53 >gboolean</a>    <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-get-bool-value">gnome_vfs_application_registry_get_bool_value</a>
  54                                             (const char *app_id,
  55                                              const char *key,
  56                                              <a
  57 href="../glib/glib-Basic-Types.html#gboolean"
  58 >gboolean</a> *got_key);
  59 void        <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-remove-application">gnome_vfs_application_registry_remove_application</a>
  60                                             (const char *app_id);
  61 void        <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-set-value">gnome_vfs_application_registry_set_value</a>
  62                                             (const char *app_id,
  63                                              const char *key,
  64                                              const char *value);
  65 void        <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-set-bool-value">gnome_vfs_application_registry_set_bool_value</a>
  66                                             (const char *app_id,
  67                                              const char *key,
  68                                              <a
  69 href="../glib/glib-Basic-Types.html#gboolean"
  70 >gboolean</a> value);
  71 void        <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-unset-key">gnome_vfs_application_registry_unset_key</a>
  72                                             (const char *app_id,
  73                                              const char *key);
  74 <a
  75 href="../glib/glib-Doubly-Linked-Lists.html#GList"
  76 >GList</a>*      <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-get-applications">gnome_vfs_application_registry_get_applications</a>
  77                                             (const char *mime_type);
  78 <a
  79 href="../glib/glib-Doubly-Linked-Lists.html#GList"
  80 >GList</a>*      <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-get-mime-types">gnome_vfs_application_registry_get_mime_types</a>
  81                                             (const char *app_id);
  82 <a
  83 href="../glib/glib-Basic-Types.html#gboolean"
  84 >gboolean</a>    <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-supports-mime-type">gnome_vfs_application_registry_supports_mime_type</a>
  85                                             (const char *app_id,
  86                                              const char *mime_type);
  87 <a
  88 href="../glib/glib-Basic-Types.html#gboolean"
  89 >gboolean</a>    <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-supports-uri-scheme">gnome_vfs_application_registry_supports_uri_scheme</a>
  90                                             (const char *app_id,
  91                                              const char *uri_scheme);
  92 <a
  93 href="../glib/glib-Basic-Types.html#gboolean"
  94 >gboolean</a>    <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-is-user-owned-application">gnome_vfs_application_is_user_owned_application</a>
  95                                             (const <a href="gnome-vfs-20-gnome-vfs-mime-database.html#GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> *application);
  96 void        <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-clear-mime-types">gnome_vfs_application_registry_clear_mime_types</a>
  97                                             (const char *app_id);
  98 void        <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-add-mime-type">gnome_vfs_application_registry_add_mime_type</a>
  99                                             (const char *app_id,
 100                                              const char *mime_type);
 101 void        <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-remove-mime-type">gnome_vfs_application_registry_remove_mime_type</a>
 102                                             (const char *app_id,
 103                                              const char *mime_type);
 104 <a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-sync">gnome_vfs_application_registry_sync</a>
 105                                             (void);
 106 void        <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-shutdown">gnome_vfs_application_registry_shutdown</a>
 107                                             (void);
 108 void        <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-reload">gnome_vfs_application_registry_reload</a>
 109                                             (void);
 110 <a href="gnome-vfs-20-gnome-vfs-mime-database.html#GnomeVFSMimeApplication">GnomeVFSMimeApplication</a>* <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-get-mime-application">gnome_vfs_application_registry_get_mime_application</a>
 111                                             (const char *app_id);
 112 void        <a href="gnome-vfs-20-gnome-vfs-application-registry.html#gnome-vfs-application-registry-save-mime-application">gnome_vfs_application_registry_save_mime_application</a>
 113                                             (const <a href="gnome-vfs-20-gnome-vfs-mime-database.html#GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> *application);
 114 </pre></div><div class="refsect1" lang="en"><h2>Description</h2><p>
 115
 116 </p></div><div class="refsect1" lang="en"><h2>Details</h2><div class="refsect2" lang="en"><h3><a name="GNOME-VFS-APPLICATION-REGISTRY-COMMAND-CAPS"></a>GNOME_VFS_APPLICATION_REGISTRY_COMMAND</h3><a class="indexterm" name="id2948910"></a><pre class="programlisting">#define GNOME_VFS_APPLICATION_REGISTRY_COMMAND "command"
 117 </pre><p>
 118 Application registry key for fetching the command to execute
 119 an application.</p><p>
 120
 121 </p></div><hr><div class="refsect2" lang="en"><h3><a name="GNOME-VFS-APPLICATION-REGISTRY-NAME-CAPS"></a>GNOME_VFS_APPLICATION_REGISTRY_NAME</h3><a class="indexterm" name="id2948951"></a><pre class="programlisting">#define GNOME_VFS_APPLICATION_REGISTRY_NAME "name"
 122 </pre><p>
 123 Application registry key for fetching the name of an application.</p><p>
 124
 125 </p></div><hr><div class="refsect2" lang="en"><h3><a name="GNOME-VFS-APPLICATION-REGISTRY-CAN-OPEN-MULTIPLE-FILES-CAPS"></a>GNOME_VFS_APPLICATION_REGISTRY_CAN_OPEN_MULTIPLE_FILES</h3><a class="indexterm" name="id2948990"></a><pre class="programlisting">#define GNOME_VFS_APPLICATION_REGISTRY_CAN_OPEN_MULTIPLE_FILES "can_open_multiple_files"
 126 </pre><p>
 127 Application registry key for determining if an application
 128 can open multiple files in the same invocation.</p><p>
 129
 130 </p></div><hr><div class="refsect2" lang="en"><h3><a name="GNOME-VFS-APPLICATION-REGISTRY-REQUIRES-TERMINAL-CAPS"></a>GNOME_VFS_APPLICATION_REGISTRY_REQUIRES_TERMINAL</h3><a class="indexterm" name="id2949035"></a><pre class="programlisting">#define GNOME_VFS_APPLICATION_REGISTRY_REQUIRES_TERMINAL "requires_terminal"
 131 </pre><p>
 132 Application registry key for determining if an application
 133 needs to run from within a terminal (for example, mpg123)</p><p>
 134
 135 </p></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-exists"></a>gnome_vfs_application_registry_exists ()</h3><a class="indexterm" name="id2949074"></a><pre class="programlisting"><a
 136 href="../glib/glib-Basic-Types.html#gboolean"
 137 >gboolean</a>    gnome_vfs_application_registry_exists
 138                                             (const char *app_id);</pre><p>
 139 This function will return TRUE if there is an entry for <i class="parameter"><tt>app_id</tt></i> in
 140 the registry, otherwise FALSE.</p><p>
 141
 142 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>app_id</tt></i> :</span></td><td> an application ID
 143 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE if the application is in the registry, FALSE if not
 144
 145 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-get-keys"></a>gnome_vfs_application_registry_get_keys ()</h3><a class="indexterm" name="id2949172"></a><pre class="programlisting"><a
 146 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 147 >GList</a>*      gnome_vfs_application_registry_get_keys
 148                                             (const char *app_id);</pre><p>
 149 This function wil return a list of strings which is the list of
 150 keys set for <i class="parameter"><tt>app_id</tt></i> in the application registry.</p><p>
 151
 152 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>app_id</tt></i> :</span></td><td> the application ID for which to get keys
 153 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A list of the keys set for <i class="parameter"><tt>app_id</tt></i>
 154
 155 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-peek-value"></a>gnome_vfs_application_registry_peek_value ()</h3><a class="indexterm" name="id2949277"></a><pre class="programlisting">const char* gnome_vfs_application_registry_peek_value
 156                                             (const char *app_id,
 157                                              const char *key);</pre><p>
 158 This will return the value associated with <i class="parameter"><tt>key</tt></i> for <i class="parameter"><tt>app_id</tt></i> in the
 159 application registry. There is no need to free the return value.</p><p>
 160
 161 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>app_id</tt></i> :</span></td><td> the application ID for which to look up a value
 162 </td></tr><tr><td><span class="term"><i class="parameter"><tt>key</tt></i> :</span></td><td> the key to look up
 163 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> the value associated with the key, or NULL if there is no
 164 associated value
 165
 166 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-get-bool-value"></a>gnome_vfs_application_registry_get_bool_value ()</h3><a class="indexterm" name="id2949411"></a><pre class="programlisting"><a
 167 href="../glib/glib-Basic-Types.html#gboolean"
 168 >gboolean</a>    gnome_vfs_application_registry_get_bool_value
 169                                             (const char *app_id,
 170                                              const char *key,
 171                                              <a
 172 href="../glib/glib-Basic-Types.html#gboolean"
 173 >gboolean</a> *got_key);</pre><p>
 174 This will look up a key in the structure pointed to by app_id and return the
 175 boolean value of that key.  It will return false if there are no
 176 applications associated with the app_id.</p><p>
 177
 178 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>app_id</tt></i> :</span></td><td>  registry id of the application
 179 </td></tr><tr><td><span class="term"><i class="parameter"><tt>key</tt></i> :</span></td><td> key to look up
 180 </td></tr><tr><td><span class="term"><i class="parameter"><tt>got_key</tt></i> :</span></td><td> TRUE if a setting was dound, otherwise FALSE
 181 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE if <i class="parameter"><tt>key</tt></i> is set to "true" or "yes" for <i class="parameter"><tt>app_id</tt></i>, otherwise FALSE
 182
 183 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-remove-application"></a>gnome_vfs_application_registry_remove_application ()</h3><a class="indexterm" name="id2949570"></a><pre class="programlisting">void        gnome_vfs_application_registry_remove_application
 184                                             (const char *app_id);</pre><p>
 185 Given the registry id this function will remove all applications that has
 186 been set by the user.  You will need to call
 187 gnome_vfs_application_registry_sync to save the changes.</p><p>
 188
 189 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>app_id</tt></i> :</span></td><td>  registry id of the application
 190 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-set-value"></a>gnome_vfs_application_registry_set_value ()</h3><a class="indexterm" name="id2949651"></a><pre class="programlisting">void        gnome_vfs_application_registry_set_value
 191                                             (const char *app_id,
 192                                              const char *key,
 193                                              const char *value);</pre><p>
 194 This function will set values pertaining to registry entry pointed to by
 195 app_id.  You will need to call gnome_vfs_application_registry_sync to
 196 realize the changes.</p><p>
 197
 198 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>app_id</tt></i> :</span></td><td>  registry id of the application
 199 </td></tr><tr><td><span class="term"><i class="parameter"><tt>key</tt></i> :</span></td><td> target key
 200 </td></tr><tr><td><span class="term"><i class="parameter"><tt>value</tt></i> :</span></td><td> value to set the target key to
 201 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-set-bool-value"></a>gnome_vfs_application_registry_set_bool_value ()</h3><a class="indexterm" name="id2949782"></a><pre class="programlisting">void        gnome_vfs_application_registry_set_bool_value
 202                                             (const char *app_id,
 203                                              const char *key,
 204                                              <a
 205 href="../glib/glib-Basic-Types.html#gboolean"
 206 >gboolean</a> value);</pre><p>
 207 This function will modify those registry values that are of type boolean to
 208 a value specified by the user.  You will need to call
 209 gnome_vfs_application_registry_sync to save your changes.</p><p>
 210
 211 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>app_id</tt></i> :</span></td><td>  registry id of the application
 212 </td></tr><tr><td><span class="term"><i class="parameter"><tt>key</tt></i> :</span></td><td> target key
 213 </td></tr><tr><td><span class="term"><i class="parameter"><tt>value</tt></i> :</span></td><td> value you want to set the target key to
 214 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-unset-key"></a>gnome_vfs_application_registry_unset_key ()</h3><a class="indexterm" name="id2949915"></a><pre class="programlisting">void        gnome_vfs_application_registry_unset_key
 215                                             (const char *app_id,
 216                                              const char *key);</pre><p>
 217 This function given the application and the target will wipe the current
 218 value that the key contains.</p><p>
 219
 220 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>app_id</tt></i> :</span></td><td> registry id of the application
 221 </td></tr><tr><td><span class="term"><i class="parameter"><tt>key</tt></i> :</span></td><td> search key
 222 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-get-applications"></a>gnome_vfs_application_registry_get_applications ()</h3><a class="indexterm" name="id2950018"></a><pre class="programlisting"><a
 223 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 224 >GList</a>*      gnome_vfs_application_registry_get_applications
 225                                             (const char *mime_type);</pre><p>
 226 This will return all applications from the registry that are associated with
 227 the given mime type string, if NULL it returns all applications.</p><p>
 228
 229 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>mime_type</tt></i> :</span></td><td>  mime type string
 230 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> a list of the application IDs for all applications which
 231 support the given mime type.
 232
 233 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-get-mime-types"></a>gnome_vfs_application_registry_get_mime_types ()</h3><a class="indexterm" name="id2950112"></a><pre class="programlisting"><a
 234 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 235 >GList</a>*      gnome_vfs_application_registry_get_mime_types
 236                                             (const char *app_id);</pre><p>
 237 This function returns a list of strings that represent the mime
 238 types that can be handled by an application.</p><p>
 239
 240 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>app_id</tt></i> :</span></td><td> registry id of application
 241 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> a list of the mime types supported
 242
 243 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-supports-mime-type"></a>gnome_vfs_application_registry_supports_mime_type ()</h3><a class="indexterm" name="id2950205"></a><pre class="programlisting"><a
 244 href="../glib/glib-Basic-Types.html#gboolean"
 245 >gboolean</a>    gnome_vfs_application_registry_supports_mime_type
 246                                             (const char *app_id,
 247                                              const char *mime_type);</pre><p>
 248 Use this function to see if there is an application associated with a given
 249 mime type.  The function will return true or false.</p><p>
 250
 251 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>app_id</tt></i> :</span></td><td> registry id of application
 252 </td></tr><tr><td><span class="term"><i class="parameter"><tt>mime_type</tt></i> :</span></td><td> mime type string
 253 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE if <i class="parameter"><tt>app_id</tt></i> supports <i class="parameter"><tt>mime_type</tt></i>, otherwise FALSE.
 254
 255 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-supports-uri-scheme"></a>gnome_vfs_application_registry_supports_uri_scheme ()</h3><a class="indexterm" name="id2950337"></a><pre class="programlisting"><a
 256 href="../glib/glib-Basic-Types.html#gboolean"
 257 >gboolean</a>    gnome_vfs_application_registry_supports_uri_scheme
 258                                             (const char *app_id,
 259                                              const char *uri_scheme);</pre><p>
 260 Given the id of the application this function will determine if the
 261 uri scheme will given is supported.</p><p>
 262
 263 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>app_id</tt></i> :</span></td><td> registry id of application
 264 </td></tr><tr><td><span class="term"><i class="parameter"><tt>uri_scheme</tt></i> :</span></td><td> uri schme string
 265 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE if <i class="parameter"><tt>app_id</tt></i> supports <i class="parameter"><tt>uri_scheme</tt></i>, otherwise FALSE
 266
 267 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-is-user-owned-application"></a>gnome_vfs_application_is_user_owned_application ()</h3><a class="indexterm" name="id2950468"></a><pre class="programlisting"><a
 268 href="../glib/glib-Basic-Types.html#gboolean"
 269 >gboolean</a>    gnome_vfs_application_is_user_owned_application
 270                                             (const <a href="gnome-vfs-20-gnome-vfs-mime-database.html#GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> *application);</pre><p>
 271 This function will determine if a mime application is user owned or not.  By
 272 user ownered this means that the application is not a system application
 273 located in the prerequisite /usr area but rather in the user's area.</p><p>
 274
 275 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>application</tt></i> :</span></td><td>  data structure of the mime application
 276 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> gboolean
 277 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-clear-mime-types"></a>gnome_vfs_application_registry_clear_mime_types ()</h3><a class="indexterm" name="id2950563"></a><pre class="programlisting">void        gnome_vfs_application_registry_clear_mime_types
 278                                             (const char *app_id);</pre><p>
 279 This function will remove the mime types associated with the application.
 280 Changes are not realized until the  gnome_vfs_application_registry_sync
 281 function is called to save the changes to the file.</p><p>
 282
 283 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>app_id</tt></i> :</span></td><td> Application id
 284 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-add-mime-type"></a>gnome_vfs_application_registry_add_mime_type ()</h3><a class="indexterm" name="id2950644"></a><pre class="programlisting">void        gnome_vfs_application_registry_add_mime_type
 285                                             (const char *app_id,
 286                                              const char *mime_type);</pre><p>
 287 This function will associate a mime type with an application given the
 288 application registry id and the mime type.  Changes are not realized until
 289 the gnome_vfs_application_registry_sync function is called to save the
 290 changes to the file.</p><p>
 291
 292 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>app_id</tt></i> :</span></td><td> registry id of application
 293 </td></tr><tr><td><span class="term"><i class="parameter"><tt>mime_type</tt></i> :</span></td><td> mime type string
 294 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-remove-mime-type"></a>gnome_vfs_application_registry_remove_mime_type ()</h3><a class="indexterm" name="id2950752"></a><pre class="programlisting">void        gnome_vfs_application_registry_remove_mime_type
 295                                             (const char *app_id,
 296                                              const char *mime_type);</pre><p>
 297 This function will de-associate a mime type from an application registry.
 298 Given the application registry id and the mime type.  Changes are not
 299 realized until the gnome_vfs_application_registry_sync function is called to
 300 save the changes to the file.</p><p>
 301
 302 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>app_id</tt></i> :</span></td><td> registry id of the application
 303 </td></tr><tr><td><span class="term"><i class="parameter"><tt>mime_type</tt></i> :</span></td><td> mime type string
 304 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-sync"></a>gnome_vfs_application_registry_sync ()</h3><a class="indexterm" name="id2950859"></a><pre class="programlisting"><a href="gnome-vfs-20-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_application_registry_sync
 305                                             (void);</pre><p>
 306 This function will sync the registry.  Typically you would use this function
 307 after a modification of the registry.  When you modify the registry a dirty
 308 flag is set.  Calling this function will save your modifications to disk and
 309 reset the flag.
 310 </p><p>
 311 If successful, will return GNOME_VFS_OK</p><p>
 312
 313 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> GnomeVFSResult
 314
 315 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-shutdown"></a>gnome_vfs_application_registry_shutdown ()</h3><a class="indexterm" name="id2950934"></a><pre class="programlisting">void        gnome_vfs_application_registry_shutdown
 316                                             (void);</pre><p>
 317 Synchronize gnome-vfs application registry data to disk, and free
 318 resources.</p><p>
 319
 320 </p></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-reload"></a>gnome_vfs_application_registry_reload ()</h3><a class="indexterm" name="id2950981"></a><pre class="programlisting">void        gnome_vfs_application_registry_reload
 321                                             (void);</pre><p>
 322 If this function is called for the first time it will initialize the
 323 registry.  Subsequent calls to the function will clear out the current
 324 registry contents and load registry contents from the save file.  Make
 325 certain that you've saved your registry before calling this function.  It
 326 will destroy unsaved changes.</p><p>
 327
 328 </p></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-get-mime-application"></a>gnome_vfs_application_registry_get_mime_application ()</h3><a class="indexterm" name="id2951032"></a><pre class="programlisting"><a href="gnome-vfs-20-gnome-vfs-mime-database.html#GnomeVFSMimeApplication">GnomeVFSMimeApplication</a>* gnome_vfs_application_registry_get_mime_application
 329                                             (const char *app_id);</pre><p>
 330 Returns a structure that contains the application that handles
 331 the mime type associated by the application referred by app_id.</p><p>
 332
 333 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>app_id</tt></i> :</span></td><td>  registry id of the application
 334 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> GnomeVFSMimeApplication
 335
 336 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-application-registry-save-mime-application"></a>gnome_vfs_application_registry_save_mime_application ()</h3><a class="indexterm" name="id2951128"></a><pre class="programlisting">void        gnome_vfs_application_registry_save_mime_application
 337                                             (const <a href="gnome-vfs-20-gnome-vfs-mime-database.html#GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> *application);</pre><p>
 338 This will save to the registry the application that will be associated with
 339 a defined mime type.  The defined mime type is located within the
 340 GnomeVFSMimeApplication structure.  Changes are not realized until the
 341 gnome_vfs_application_registry_sync function is called.</p><p>
 342
 343 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>application</tt></i> :</span></td><td> application associated with the mime type
 344 </td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="mime-registry.html"><b>&lt;&lt; MIME Registry</b></a></td><td align="right"><a accesskey="n" href="gnome-vfs-20-gnome-vfs-mime-database.html"><b>File Types &gt;&gt;</b></a></td></tr></table></body></html>