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

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