doc/html/gnome-vfs-gnome-vfs-mime-database.html

   1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>
   2 File Types</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="gnome-vfs-gnome-vfs-application-registry.html" title="
  33 Application Registry"><link rel="next" href="gnome-vfs-gnome-vfs-mime-monitor.html" title="
  34 MIME Database Monitor"></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="gnome-vfs-gnome-vfs-application-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-monitor.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-mime-database"></a><div class="titlepage"><div></div><div></div></div><div class="refnamediv"><h2><span class="refentrytitle">
  35 File Types</span></h2><p>
  36 File Types &#8212;
  37 functions for getting information about files based on their MIME type</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
  38
  39
  40
  41 #define     <a href="gnome-vfs-gnome-vfs-mime-database.html#GNOME-VFS-MIME-TYPE-UNKNOWN-CAPS">GNOME_VFS_MIME_TYPE_UNKNOWN</a>
  42 const char* <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-get-mime-type-for-data">gnome_vfs_get_mime_type_for_data</a>
  43                                             (<a
  44 href="../glib/glib-Basic-Types.html#gconstpointer"
  45 >gconstpointer</a> data,
  46                                              int data_size);
  47 char*       <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-get-mime-type">gnome_vfs_get_mime_type</a>         (const char *text_uri);
  48 enum        <a href="gnome-vfs-gnome-vfs-mime-database.html#GnomeVFSMimeActionType">GnomeVFSMimeActionType</a>;
  49 enum        <a href="gnome-vfs-gnome-vfs-mime-database.html#GnomeVFSMimeApplicationArgumentType">GnomeVFSMimeApplicationArgumentType</a>;
  50 typedef     <a href="gnome-vfs-gnome-vfs-mime-database.html#GnomeVFSMimeApplication">GnomeVFSMimeApplication</a>;
  51 <a href="gnome-vfs-gnome-vfs-mime-database.html#GnomeVFSMimeApplication">GnomeVFSMimeApplication</a>* <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-application-copy">gnome_vfs_mime_application_copy</a>
  52                                             (<a href="gnome-vfs-gnome-vfs-mime-database.html#GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> *application);
  53 <a href="gnome-vfs-gnome-vfs-mime-database.html#GnomeVFSMimeActionType">GnomeVFSMimeActionType</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-default-action-type">gnome_vfs_mime_get_default_action_type</a>
  54                                             (const char *mime_type);
  55 GnomeVFSMimeAction* <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-default-action">gnome_vfs_mime_get_default_action</a>
  56                                             (const char *mime_type);
  57 <a href="gnome-vfs-gnome-vfs-mime-database.html#GnomeVFSMimeApplication">GnomeVFSMimeApplication</a>* <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-default-application">gnome_vfs_mime_get_default_application</a>
  58                                             (const char *mime_type);
  59 Bonobo_ServerInfo* <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-default-component">gnome_vfs_mime_get_default_component</a>
  60                                             (const char *mime_type);
  61 <a
  62 href="../glib/glib-Doubly-Linked-Lists.html#GList"
  63 >GList</a>*      <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-short-list-applications">gnome_vfs_mime_get_short_list_applications</a>
  64                                             (const char *mime_type);
  65 <a
  66 href="../glib/glib-Doubly-Linked-Lists.html#GList"
  67 >GList</a>*      <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-short-list-components">gnome_vfs_mime_get_short_list_components</a>
  68                                             (const char *mime_type);
  69 <a
  70 href="../glib/glib-Doubly-Linked-Lists.html#GList"
  71 >GList</a>*      <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-all-applications">gnome_vfs_mime_get_all_applications</a>
  72                                             (const char *mime_type);
  73 <a
  74 href="../glib/glib-Doubly-Linked-Lists.html#GList"
  75 >GList</a>*      <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-all-components">gnome_vfs_mime_get_all_components</a>
  76                                             (const char *mime_type);
  77 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-set-default-action-type">gnome_vfs_mime_set_default_action_type</a>
  78                                             (const char *mime_type,
  79                                              <a href="gnome-vfs-gnome-vfs-mime-database.html#GnomeVFSMimeActionType">GnomeVFSMimeActionType</a> action_type);
  80 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-set-default-application">gnome_vfs_mime_set_default_application</a>
  81                                             (const char *mime_type,
  82                                              const char *application_id);
  83 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-set-default-component">gnome_vfs_mime_set_default_component</a>
  84                                             (const char *mime_type,
  85                                              const char *component_iid);
  86 const char* <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-icon">gnome_vfs_mime_get_icon</a>         (const char *mime_type);
  87 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-set-icon">gnome_vfs_mime_set_icon</a>      (const char *mime_type,
  88                                              const char *filename);
  89 const char* <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-description">gnome_vfs_mime_get_description</a>  (const char *mime_type);
  90 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-set-description">gnome_vfs_mime_set_description</a>
  91                                             (const char *mime_type,
  92                                              const char *description);
  93 <a
  94 href="../glib/glib-Basic-Types.html#gboolean"
  95 >gboolean</a>    <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-can-be-executable">gnome_vfs_mime_can_be_executable</a>
  96                                             (const char *mime_type);
  97 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-set-can-be-executable">gnome_vfs_mime_set_can_be_executable</a>
  98                                             (const char *mime_type,
  99                                              <a
 100 href="../glib/glib-Basic-Types.html#gboolean"
 101 >gboolean</a> new_value);
 102 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-set-short-list-applications">gnome_vfs_mime_set_short_list_applications</a>
 103                                             (const char *mime_type,
 104                                              <a
 105 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 106 >GList</a> *application_ids);
 107 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-set-short-list-components">gnome_vfs_mime_set_short_list_components</a>
 108                                             (const char *mime_type,
 109                                              <a
 110 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 111 >GList</a> *component_iids);
 112 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-add-application-to-short-list">gnome_vfs_mime_add_application_to_short_list</a>
 113                                             (const char *mime_type,
 114                                              const char *application_id);
 115 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-remove-application-from-short-list">gnome_vfs_mime_remove_application_from_short_list</a>
 116                                             (const char *mime_type,
 117                                              const char *application_id);
 118 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-add-component-to-short-list">gnome_vfs_mime_add_component_to_short_list</a>
 119                                             (const char *mime_type,
 120                                              const char *iid);
 121 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-remove-component-from-short-list">gnome_vfs_mime_remove_component_from_short_list</a>
 122                                             (const char *mime_type,
 123                                              const char *iid);
 124 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-add-extension">gnome_vfs_mime_add_extension</a> (const char *mime_type,
 125                                              const char *extension);
 126 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-remove-extension">gnome_vfs_mime_remove_extension</a>
 127                                             (const char *mime_type,
 128                                              const char *extension);
 129 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-extend-all-applications">gnome_vfs_mime_extend_all_applications</a>
 130                                             (const char *mime_type,
 131                                              <a
 132 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 133 >GList</a> *application_ids);
 134 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-remove-from-all-applications">gnome_vfs_mime_remove_from_all_applications</a>
 135                                             (const char *mime_type,
 136                                              <a
 137 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 138 >GList</a> *application_ids);
 139 <a href="gnome-vfs-gnome-vfs-mime-database.html#GnomeVFSMimeApplication">GnomeVFSMimeApplication</a>* <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-application-new-from-id">gnome_vfs_mime_application_new_from_id</a>
 140                                             (const char *id);
 141 void        <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-application-free">gnome_vfs_mime_application_free</a> (<a href="gnome-vfs-gnome-vfs-mime-database.html#GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> *application);
 142 void        <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-action-free">gnome_vfs_mime_action_free</a>      (GnomeVFSMimeAction *action);
 143 void        <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-application-list-free">gnome_vfs_mime_application_list_free</a>
 144                                             (<a
 145 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 146 >GList</a> *list);
 147 void        <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-component-list-free">gnome_vfs_mime_component_list_free</a>
 148                                             (<a
 149 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 150 >GList</a> *list);
 151 <a
 152 href="../glib/glib-Basic-Types.html#gboolean"
 153 >gboolean</a>    <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-id-in-application-list">gnome_vfs_mime_id_in_application_list</a>
 154                                             (const char *id,
 155                                              <a
 156 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 157 >GList</a> *applications);
 158 <a
 159 href="../glib/glib-Basic-Types.html#gboolean"
 160 >gboolean</a>    <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-id-in-component-list">gnome_vfs_mime_id_in_component_list</a>
 161                                             (const char *iid,
 162                                              <a
 163 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 164 >GList</a> *components);
 165 <a
 166 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 167 >GList</a>*      <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-remove-application-from-list">gnome_vfs_mime_remove_application_from_list</a>
 168                                             (<a
 169 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 170 >GList</a> *applications,
 171                                              const char *application_id,
 172                                              <a
 173 href="../glib/glib-Basic-Types.html#gboolean"
 174 >gboolean</a> *did_remove);
 175 <a
 176 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 177 >GList</a>*      <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-remove-component-from-list">gnome_vfs_mime_remove_component_from_list</a>
 178                                             (<a
 179 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 180 >GList</a> *components,
 181                                              const char *iid,
 182                                              <a
 183 href="../glib/glib-Basic-Types.html#gboolean"
 184 >gboolean</a> *did_remove);
 185 <a
 186 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 187 >GList</a>*      <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-id-list-from-component-list">gnome_vfs_mime_id_list_from_component_list</a>
 188                                             (<a
 189 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 190 >GList</a> *components);
 191 <a
 192 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 193 >GList</a>*      <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-id-list-from-application-list">gnome_vfs_mime_id_list_from_application_list</a>
 194                                             (<a
 195 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 196 >GList</a> *applications);
 197 void        <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-freeze">gnome_vfs_mime_freeze</a>           (void);
 198 void        <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-thaw">gnome_vfs_mime_thaw</a>             (void);
 199 void        <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-info-reload">gnome_vfs_mime_info_reload</a>      (void);
 200 <a
 201 href="../glib/glib-Basic-Types.html#gboolean"
 202 >gboolean</a>    <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-type-is-known">gnome_vfs_mime_type_is_known</a>    (const char *mime_type);
 203 const char* <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-value">gnome_vfs_mime_get_value</a>        (const char *mime_type,
 204                                              const char *key);
 205 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-set-value">gnome_vfs_mime_set_value</a>     (const char *mime_type,
 206                                              const char *key,
 207                                              const char *value);
 208 <a
 209 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 210 >GList</a>*      <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-key-list">gnome_vfs_mime_get_key_list</a>     (const char *mime_type);
 211 void        <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-keys-list-free">gnome_vfs_mime_keys_list_free</a>   (<a
 212 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 213 >GList</a> *mime_type_list);
 214 <a
 215 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 216 >GList</a>*      <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-extensions-list">gnome_vfs_mime_get_extensions_list</a>
 217                                             (const char *mime_type);
 218 void        <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-extensions-list-free">gnome_vfs_mime_extensions_list_free</a>
 219                                             (<a
 220 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 221 >GList</a> *list);
 222 char*       <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-extensions-string">gnome_vfs_mime_get_extensions_string</a>
 223                                             (const char *mime_type);
 224 char*       <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-extensions-pretty-string">gnome_vfs_mime_get_extensions_pretty_string</a>
 225                                             (const char *mime_type);
 226 <a
 227 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 228 >GList</a>*      <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-get-registered-mime-types">gnome_vfs_get_registered_mime_types</a>
 229                                             (void);
 230 void        <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-registered-mime-type-list-free">gnome_vfs_mime_registered_mime_type_list_free</a>
 231                                             (<a
 232 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 233 >GList</a> *list);
 234 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-set-registered-type-key">gnome_vfs_mime_set_registered_type_key</a>
 235                                             (const char *mime_type,
 236                                              const char *key,
 237                                              const char *data);
 238 <a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-set-extensions-list">gnome_vfs_mime_set_extensions_list</a>
 239                                             (const char *mime_type,
 240                                              const char *extensions_list);
 241 void        <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-registered-mime-type-delete">gnome_vfs_mime_registered_mime_type_delete</a>
 242                                             (const char *mime_type);
 243 void        <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-reset">gnome_vfs_mime_reset</a>            (void);
 244 </pre></div><div class="refsect1" lang="en"><h2>Description</h2><p>
 245
 246 </p></div><div class="refsect1" lang="en"><h2>Details</h2><div class="refsect2" lang="en"><h3><a name="GNOME-VFS-MIME-TYPE-UNKNOWN-CAPS"></a>GNOME_VFS_MIME_TYPE_UNKNOWN</h3><pre class="programlisting">#define GNOME_VFS_MIME_TYPE_UNKNOWN &quot;application/octet-stream&quot;
 247 </pre><p>
 248 The value returned for the MIME type when a file did
 249 not match any entries in the MIME database. May be
 250 treated as a file of an unknown type.</p><p>
 251
 252 </p></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-get-mime-type-for-data"></a>gnome_vfs_get_mime_type_for_data ()</h3><pre class="programlisting">const char* gnome_vfs_get_mime_type_for_data
 253                                             (<a
 254 href="../glib/glib-Basic-Types.html#gconstpointer"
 255 >gconstpointer</a> data,
 256                                              int data_size);</pre><p>
 257 Tries to guess the mime type of the data in <i class="parameter"><tt>data</tt></i>
 258 using the magic patterns.</p><p>
 259
 260 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>data</tt></i> :</span></td><td> A pointer to data in memory.
 261 </td></tr><tr><td><span class="term"><i class="parameter"><tt>data_size</tt></i> :</span></td><td> Size of the data.
 262 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the mime-type for this filename.
 263 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-get-mime-type"></a>gnome_vfs_get_mime_type ()</h3><pre class="programlisting">char*       gnome_vfs_get_mime_type         (const char *text_uri);</pre><p>
 264 Determine the mime type of <i class="parameter"><tt>text_uri</tt></i>. The mime type is determined
 265 in the same way as by <a href="gnome-vfs-gnome-vfs-file-info-ops.html#gnome-vfs-get-file-info">gnome_vfs_get_file_info</a>(). This is meant as
 266 a convenience function for times when you only want the mime type.</p><p>
 267
 268 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>text_uri</tt></i> :</span></td><td> URI of the file for which to get the mime type
 269 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The mime type, or NULL if there is an error reading
 270 the file.
 271 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="GnomeVFSMimeActionType"></a>enum GnomeVFSMimeActionType</h3><pre class="programlisting">typedef enum {
 272         GNOME_VFS_MIME_ACTION_TYPE_NONE,
 273         GNOME_VFS_MIME_ACTION_TYPE_APPLICATION,
 274         GNOME_VFS_MIME_ACTION_TYPE_COMPONENT
 275 } GnomeVFSMimeActionType;
 276 </pre><p>
 277
 278 </p></div><hr><div class="refsect2" lang="en"><h3><a name="GnomeVFSMimeApplicationArgumentType"></a>enum GnomeVFSMimeApplicationArgumentType</h3><pre class="programlisting">typedef enum {
 279         GNOME_VFS_MIME_APPLICATION_ARGUMENT_TYPE_URIS,
 280         GNOME_VFS_MIME_APPLICATION_ARGUMENT_TYPE_PATHS,
 281         GNOME_VFS_MIME_APPLICATION_ARGUMENT_TYPE_URIS_FOR_NON_FILES
 282 } GnomeVFSMimeApplicationArgumentType;
 283 </pre><p>
 284
 285 </p></div><hr><div class="refsect2" lang="en"><h3><a name="GnomeVFSMimeApplication"></a>GnomeVFSMimeApplication</h3><pre class="programlisting">typedef struct {
 286         char *id;
 287         char *name;
 288         char *command;
 289         gboolean can_open_multiple_files;
 290         GnomeVFSMimeApplicationArgumentType expects_uris;
 291         GList *supported_uri_schemes;
 292         gboolean requires_terminal;
 293
 294         /* Padded to avoid future breaks in ABI compatibility */
 295         void *reserved1;
 296         void *reserved2;
 297
 298 } GnomeVFSMimeApplication;
 299 </pre><p>
 300
 301 </p></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-application-copy"></a>gnome_vfs_mime_application_copy ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-mime-database.html#GnomeVFSMimeApplication">GnomeVFSMimeApplication</a>* gnome_vfs_mime_application_copy
 302                                             (<a href="gnome-vfs-gnome-vfs-mime-database.html#GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> *application);</pre><p>
 303 Creates a newly referenced copy of a GnomeVFSMimeApplication object.</p><p>
 304
 305 </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> The GnomeVFSMimeApplication to be duplicated.
 306 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A copy of <i class="parameter"><tt>application</tt></i>
 307 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-get-default-action-type"></a>gnome_vfs_mime_get_default_action_type ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-mime-database.html#GnomeVFSMimeActionType">GnomeVFSMimeActionType</a> gnome_vfs_mime_get_default_action_type
 308                                             (const char *mime_type);</pre><p>
 309 Query the MIME database for the type of action to be performed on a particular MIME type by default.</p><p>
 310
 311 </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> A const char * containing a mime type, e.g. &quot;application/x-php&quot;
 312 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The type of action to be performed on a file of
 313 MIME type, <i class="parameter"><tt>mime_type</tt></i> by default.
 314 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-get-default-action"></a>gnome_vfs_mime_get_default_action ()</h3><pre class="programlisting">GnomeVFSMimeAction* gnome_vfs_mime_get_default_action
 315                                             (const char *mime_type);</pre><p>
 316 Query the MIME database for default action associated with a particular MIME type <i class="parameter"><tt>mime_type</tt></i>.</p><p>
 317
 318 </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> A const char * containing a mime type, e.g. &quot;application/x-php&quot;
 319 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A GnomeVFSMimeAction representing the default action to perform upon
 320 file of type <i class="parameter"><tt>mime_type</tt></i>.
 321 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-get-default-application"></a>gnome_vfs_mime_get_default_application ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-mime-database.html#GnomeVFSMimeApplication">GnomeVFSMimeApplication</a>* gnome_vfs_mime_get_default_application
 322                                             (const char *mime_type);</pre><p>
 323 Query the MIME database for the application to be executed on files of MIME type
 324 <i class="parameter"><tt>mime_type</tt></i> by default.</p><p>
 325
 326 </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> A const char * containing a mime type, e.g. &quot;image/png&quot;
 327 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A GnomeVFSMimeApplication representing the default handler of <i class="parameter"><tt>mime_type</tt></i>
 328 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-get-default-component"></a>gnome_vfs_mime_get_default_component ()</h3><pre class="programlisting">Bonobo_ServerInfo* gnome_vfs_mime_get_default_component
 329                                             (const char *mime_type);</pre><p>
 330 Query the MIME database for the default Bonobo component to be activated to
 331 view files of MIME type <i class="parameter"><tt>mime_type</tt></i>.</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>mime_type</tt></i> :</span></td><td> A const char * containing a mime type, e.g. &quot;image/png&quot;
 334 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> An Bonobo_ServerInfo * representing the OAF server to be activated
 335 to get a reference to the proper component.
 336 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-get-short-list-applications"></a>gnome_vfs_mime_get_short_list_applications ()</h3><pre class="programlisting"><a
 337 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 338 >GList</a>*      gnome_vfs_mime_get_short_list_applications
 339                                             (const char *mime_type);</pre><p>
 340 Return an alphabetically sorted list of GnomeVFSMimeApplication
 341 data structures for the requested mime type.    The short list contains
 342 &quot;select&quot; applications recommended for handling this MIME type, appropriate for
 343 display to the user.</p><p>
 344
 345 </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> A const char * containing a mime type, e.g. &quot;image/png&quot;
 346 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A GList * where the elements are GnomeVFSMimeApplication *
 347 representing various applications to display in the short list for <i class="parameter"><tt>mime_type</tt></i>.
 348 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-get-short-list-components"></a>gnome_vfs_mime_get_short_list_components ()</h3><pre class="programlisting"><a
 349 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 350 >GList</a>*      gnome_vfs_mime_get_short_list_components
 351                                             (const char *mime_type);</pre><p>
 352 Return an unsorted sorted list of Bonobo_ServerInfo *
 353 data structures for the requested mime type.    The short list contains
 354 &quot;select&quot; components recommended for handling this MIME type, appropriate for
 355 display to the user.</p><p>
 356
 357 </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> A const char * containing a mime type, e.g. &quot;image/png&quot;
 358 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A GList * where the elements are Bonobo_ServerInfo *
 359 representing various components to display in the short list for <i class="parameter"><tt>mime_type</tt></i>.
 360 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-get-all-applications"></a>gnome_vfs_mime_get_all_applications ()</h3><pre class="programlisting"><a
 361 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 362 >GList</a>*      gnome_vfs_mime_get_all_applications
 363                                             (const char *mime_type);</pre><p>
 364 Return an alphabetically sorted list of GnomeVFSMimeApplication
 365 data structures representing all applications in the MIME database registered
 366 to handle files of MIME type <i class="parameter"><tt>mime_type</tt></i> (and supertypes).</p><p>
 367
 368 </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> A const char * containing a mime type, e.g. &quot;image/png&quot;
 369 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A GList * where the elements are GnomeVFSMimeApplication *
 370 representing applications that handle MIME type <i class="parameter"><tt>mime_type</tt></i>.
 371 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-get-all-components"></a>gnome_vfs_mime_get_all_components ()</h3><pre class="programlisting"><a
 372 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 373 >GList</a>*      gnome_vfs_mime_get_all_components
 374                                             (const char *mime_type);</pre><p>
 375 Return an alphabetically sorted list of Bonobo_ServerInfo
 376 data structures representing all Bonobo components registered
 377 to handle files of MIME type <i class="parameter"><tt>mime_type</tt></i> (and supertypes).</p><p>
 378
 379 </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> A const char * containing a mime type, e.g. &quot;image/png&quot;
 380 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A GList * where the elements are Bonobo_ServerInfo *
 381 representing components that can handle MIME type <i class="parameter"><tt>mime_type</tt></i>.
 382 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-set-default-action-type"></a>gnome_vfs_mime_set_default_action_type ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_set_default_action_type
 383                                             (const char *mime_type,
 384                                              <a href="gnome-vfs-gnome-vfs-mime-database.html#GnomeVFSMimeActionType">GnomeVFSMimeActionType</a> action_type);</pre><p>
 385 Sets the default action type to be performed on files of MIME type <i class="parameter"><tt>mime_type</tt></i>.</p><p>
 386
 387 </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> A const char * containing a mime type, e.g. &quot;image/png&quot;
 388 </td></tr><tr><td><span class="term"><i class="parameter"><tt>action_type</tt></i> :</span></td><td> A GnomeVFSMimeActionType containing the action to perform by default
 389 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A GnomeVFSResult indicating the success of the operation or reporting
 390 any errors encountered.
 391 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-set-default-application"></a>gnome_vfs_mime_set_default_application ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_set_default_application
 392                                             (const char *mime_type,
 393                                              const char *application_id);</pre><p>
 394 Sets the default application to be run on files of MIME type <i class="parameter"><tt>mime_type</tt></i>.</p><p>
 395
 396 </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> A const char * containing a mime type, e.g. &quot;application/x-php&quot;
 397 </td></tr><tr><td><span class="term"><i class="parameter"><tt>application_id</tt></i> :</span></td><td> A key representing an application in the MIME database
 398 (GnomeVFSMimeApplication-&gt;id, for example)
 399 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A GnomeVFSResult indicating the success of the operation or reporting
 400 any errors encountered.
 401 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-set-default-component"></a>gnome_vfs_mime_set_default_component ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_set_default_component
 402                                             (const char *mime_type,
 403                                              const char *component_iid);</pre><p>
 404 Sets the default component to be activated for files of MIME type <i class="parameter"><tt>mime_type</tt></i>.</p><p>
 405
 406 </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> A const char * containing a mime type, e.g. &quot;application/x-php&quot;
 407 </td></tr><tr><td><span class="term"><i class="parameter"><tt>component_iid</tt></i> :</span></td><td> The OAFIID of a component
 408 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A GnomeVFSResult indicating the success of the operation or reporting
 409 any errors encountered.
 410 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-get-icon"></a>gnome_vfs_mime_get_icon ()</h3><pre class="programlisting">const char* gnome_vfs_mime_get_icon         (const char *mime_type);</pre><p>
 411 Query the MIME database for an icon representing the specified MIME type.</p><p>
 412
 413 </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> A const char * containing a  MIME type
 414 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The filename of the icon as listed in the MIME database. This is
 415 usually a filename without path information, e.g. &quot;i-chardev.png&quot;, and sometimes
 416 does not have an extension, e.g. &quot;i-regular&quot; if the icon is supposed to be image
 417 type agnostic between icon themes. Icons are generic, and not theme specific. These
 418 will not necessarily match with the icons a user sees in Nautilus, you have been warned.
 419 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-set-icon"></a>gnome_vfs_mime_set_icon ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_set_icon      (const char *mime_type,
 420                                              const char *filename);</pre><p>
 421 Set the icon entry for a particular MIME type in the MIME database. Note that
 422 icon entries need not necessarily contain the full path, and do not necessarily need to
 423 specify an extension. So &quot;i-regular&quot;, &quot;my-special-icon.png&quot;, and &quot;some-icon&quot;
 424 are all valid icon filenames.</p><p>
 425
 426 </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> A const char * containing a  MIME type
 427 </td></tr><tr><td><span class="term"><i class="parameter"><tt>filename</tt></i> :</span></td><td> a const char * containing an image filename
 428 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A GnomeVFSResult indicating the success of the operation
 429 or any errors that may have occurred.
 430 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-get-description"></a>gnome_vfs_mime_get_description ()</h3><pre class="programlisting">const char* gnome_vfs_mime_get_description  (const char *mime_type);</pre><p>
 431 Query the MIME database for a description of the specified MIME type.</p><p>
 432
 433 </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> the mime type
 434 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A description of MIME type <i class="parameter"><tt>mime_type</tt></i>
 435 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-set-description"></a>gnome_vfs_mime_set_description ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_set_description
 436                                             (const char *mime_type,
 437                                              const char *description);</pre><p>
 438 Set the description of this MIME type in the MIME database. The description
 439 should be something like &quot;Gnumeric spreadsheet&quot;.</p><p>
 440
 441 </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> A const char * containing a mime type
 442 </td></tr><tr><td><span class="term"><i class="parameter"><tt>description</tt></i> :</span></td><td> A description of this MIME type
 443 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> GnomeVFSResult indicating the success of the operation or any
 444 errors that may have occurred.
 445 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-can-be-executable"></a>gnome_vfs_mime_can_be_executable ()</h3><pre class="programlisting"><a
 446 href="../glib/glib-Basic-Types.html#gboolean"
 447 >gboolean</a>    gnome_vfs_mime_can_be_executable
 448                                             (const char *mime_type);</pre><p>
 449 Check whether files of this MIME type might conceivably be executable.
 450 Default for known types if FALSE. Default for unknown types is TRUE.</p><p>
 451
 452 </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> A const char * containing a mime type
 453 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> gboolean containing TRUE if some files of this MIME type
 454 are registered as being executable, and false otherwise.
 455 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-set-can-be-executable"></a>gnome_vfs_mime_set_can_be_executable ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_set_can_be_executable
 456                                             (const char *mime_type,
 457                                              <a
 458 href="../glib/glib-Basic-Types.html#gboolean"
 459 >gboolean</a> new_value);</pre><p>
 460 Set whether files of this MIME type might conceivably be executable.</p><p>
 461
 462 </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> A const char * containing a mime type
 463 </td></tr><tr><td><span class="term"><i class="parameter"><tt>new_value</tt></i> :</span></td><td> A boolean value indicating whether <i class="parameter"><tt>mime_type</tt></i> could be executable.
 464 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> GnomeVFSResult indicating the success of the operation or any
 465 errors that may have occurred.
 466 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-set-short-list-applications"></a>gnome_vfs_mime_set_short_list_applications ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_set_short_list_applications
 467                                             (const char *mime_type,
 468                                              <a
 469 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 470 >GList</a> *application_ids);</pre><p>
 471 Set the short list of applications for the specified MIME type. The short list
 472 contains applications recommended for possible selection by the user.</p><p>
 473
 474 </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> A const char * containing a mime type, e.g. &quot;application/x-php&quot;
 475 </td></tr><tr><td><span class="term"><i class="parameter"><tt>application_ids</tt></i> :</span></td><td> GList of const char * application ids
 476 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A GnomeVFSResult indicating the success of the operation or reporting
 477 any errors encountered.
 478 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-set-short-list-components"></a>gnome_vfs_mime_set_short_list_components ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_set_short_list_components
 479                                             (const char *mime_type,
 480                                              <a
 481 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 482 >GList</a> *component_iids);</pre><p>
 483 Set the short list of components for the specified MIME type. The short list
 484 contains companents recommended for possible selection by the user. *</p><p>
 485
 486 </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> A const char * containing a mime type, e.g. &quot;application/x-php&quot;
 487 </td></tr><tr><td><span class="term"><i class="parameter"><tt>component_iids</tt></i> :</span></td><td> GList of const char * OAF IIDs
 488 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A GnomeVFSResult indicating the success of the operation or reporting
 489 any errors encountered.
 490 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-add-application-to-short-list"></a>gnome_vfs_mime_add_application_to_short_list ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_add_application_to_short_list
 491                                             (const char *mime_type,
 492                                              const char *application_id);</pre><p>
 493 Add an application to the short list for MIME type <i class="parameter"><tt>mime_type</tt></i>. The short list contains
 494 applications recommended for display as choices to the user for a particular MIME type.</p><p>
 495
 496 </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> A const char * containing a mime type, e.g. &quot;application/x-php&quot;
 497 </td></tr><tr><td><span class="term"><i class="parameter"><tt>application_id</tt></i> :</span></td><td> const char * containing the application's id in the MIME database
 498 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A GnomeVFSResult indicating the success of the operation or reporting
 499 any errors encountered.
 500 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-remove-application-from-short-list"></a>gnome_vfs_mime_remove_application_from_short_list ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_remove_application_from_short_list
 501                                             (const char *mime_type,
 502                                              const char *application_id);</pre><p>
 503 Remove an application from the short list for MIME type <i class="parameter"><tt>mime_type</tt></i>. The short list contains
 504 applications recommended for display as choices to the user for a particular MIME type.</p><p>
 505
 506 </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> A const char * containing a mime type, e.g. &quot;application/x-php&quot;
 507 </td></tr><tr><td><span class="term"><i class="parameter"><tt>application_id</tt></i> :</span></td><td> const char * containing the application's id in the MIME database
 508 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A GnomeVFSResult indicating the success of the operation or reporting
 509 any errors encountered.
 510 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-add-component-to-short-list"></a>gnome_vfs_mime_add_component_to_short_list ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_add_component_to_short_list
 511                                             (const char *mime_type,
 512                                              const char *iid);</pre><p>
 513 Add a component to the short list for MIME type <i class="parameter"><tt>mime_type</tt></i>. The short list contains
 514 components recommended for display as choices to the user for a particular MIME type.</p><p>
 515
 516 </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> A const char * containing a mime type, e.g. &quot;application/x-php&quot;
 517 </td></tr><tr><td><span class="term"><i class="parameter"><tt>iid</tt></i> :</span></td><td> const char * containing the component's OAF IID
 518 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A GnomeVFSResult indicating the success of the operation or reporting
 519 any errors encountered.
 520 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-remove-component-from-short-list"></a>gnome_vfs_mime_remove_component_from_short_list ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_remove_component_from_short_list
 521                                             (const char *mime_type,
 522                                              const char *iid);</pre><p>
 523 Remove a component from the short list for MIME type <i class="parameter"><tt>mime_type</tt></i>. The short list contains
 524 components recommended for display as choices to the user for a particular MIME type.</p><p>
 525
 526 </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> A const char * containing a mime type, e.g. &quot;application/x-php&quot;
 527 </td></tr><tr><td><span class="term"><i class="parameter"><tt>iid</tt></i> :</span></td><td> const char * containing the component's OAF IID
 528 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A GnomeVFSResult indicating the success of the operation or reporting
 529 any errors encountered.
 530 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-add-extension"></a>gnome_vfs_mime_add_extension ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_add_extension (const char *mime_type,
 531                                              const char *extension);</pre><p>
 532 Add a file extension to the specificed MIME type in the MIME database.</p><p>
 533
 534 </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> The mime type to add the mapping to.
 535 </td></tr><tr><td><span class="term"><i class="parameter"><tt>extension</tt></i> :</span></td><td> The extension to add (e.g. &quot;txt&quot;)
 536 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> GnomeVFSResult indicating the success of the operation or any
 537 errors that may have occurred.
 538 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-remove-extension"></a>gnome_vfs_mime_remove_extension ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_remove_extension
 539                                             (const char *mime_type,
 540                                              const char *extension);</pre><p>
 541 Removes a file extension from the specificed MIME type in the MIME database.</p><p>
 542
 543 </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> The mime type to remove the extension from
 544 </td></tr><tr><td><span class="term"><i class="parameter"><tt>extension</tt></i> :</span></td><td> The extension to remove
 545 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> GnomeVFSResult indicating the success of the operation or any
 546 errors that may have occurred.
 547 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-extend-all-applications"></a>gnome_vfs_mime_extend_all_applications ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_extend_all_applications
 548                                             (const char *mime_type,
 549                                              <a
 550 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 551 >GList</a> *application_ids);</pre><p>
 552 Register <i class="parameter"><tt>mime_type</tt></i> as being handled by all applications list in <i class="parameter"><tt>application_ids</tt></i>.</p><p>
 553
 554 </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> A const char * containing a mime type, e.g. &quot;application/x-php&quot;
 555 </td></tr><tr><td><span class="term"><i class="parameter"><tt>application_ids</tt></i> :</span></td><td> a GList of const char * containing application ids
 556 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A GnomeVFSResult indicating the success of the operation or reporting
 557 any errors encountered.
 558 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-remove-from-all-applications"></a>gnome_vfs_mime_remove_from_all_applications ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_remove_from_all_applications
 559                                             (const char *mime_type,
 560                                              <a
 561 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 562 >GList</a> *application_ids);</pre><p>
 563 Remove <i class="parameter"><tt>mime_type</tt></i> as a handled type from every application in <i class="parameter"><tt>application_ids</tt></i></p><p>
 564
 565 </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> A const char * containing a mime type, e.g. &quot;application/x-php&quot;
 566 </td></tr><tr><td><span class="term"><i class="parameter"><tt>application_ids</tt></i> :</span></td><td> a GList of const char * containing application ids
 567 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A GnomeVFSResult indicating the success of the operation or reporting
 568 any errors encountered.
 569 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-application-new-from-id"></a>gnome_vfs_mime_application_new_from_id ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-mime-database.html#GnomeVFSMimeApplication">GnomeVFSMimeApplication</a>* gnome_vfs_mime_application_new_from_id
 570                                             (const char *id);</pre><p>
 571 Fetches the GnomeVFSMimeApplication associated with the specified
 572 application ID from the MIME database.</p><p>
 573
 574 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>id</tt></i> :</span></td><td> A const char * containing an application id
 575 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> GnomeVFSMimeApplication * corresponding to <i class="parameter"><tt>id</tt></i>
 576 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-application-free"></a>gnome_vfs_mime_application_free ()</h3><pre class="programlisting">void        gnome_vfs_mime_application_free (<a href="gnome-vfs-gnome-vfs-mime-database.html#GnomeVFSMimeApplication">GnomeVFSMimeApplication</a> *application);</pre><p>
 577 Frees a GnomeVFSMimeApplication *.</p><p>
 578
 579 </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> The GnomeVFSMimeApplication to be freed
 580 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-action-free"></a>gnome_vfs_mime_action_free ()</h3><pre class="programlisting">void        gnome_vfs_mime_action_free      (GnomeVFSMimeAction *action);</pre><p>
 581 Frees a GnomeVFSMimeAction *.</p><p>
 582
 583 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>action</tt></i> :</span></td><td> The GnomeVFSMimeAction to be freed
 584 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-application-list-free"></a>gnome_vfs_mime_application_list_free ()</h3><pre class="programlisting">void        gnome_vfs_mime_application_list_free
 585                                             (<a
 586 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 587 >GList</a> *list);</pre><p>
 588 Frees lists of GnomeVFSApplications, as returned from functions such
 589 as gnome_vfs_get_all_applications().</p><p>
 590
 591 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>list</tt></i> :</span></td><td> a GList of GnomeVFSApplication * to be freed
 592 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-component-list-free"></a>gnome_vfs_mime_component_list_free ()</h3><pre class="programlisting">void        gnome_vfs_mime_component_list_free
 593                                             (<a
 594 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 595 >GList</a> *list);</pre><p>
 596 Frees lists of Bonobo_ServerInfo * (as returned from functions such
 597 as <i class="parameter"><tt>gnome_vfs_get_all_components</tt></i>)</p><p>
 598
 599 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>list</tt></i> :</span></td><td> a GList of Bonobo_ServerInfo * to be freed
 600 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-id-in-application-list"></a>gnome_vfs_mime_id_in_application_list ()</h3><pre class="programlisting"><a
 601 href="../glib/glib-Basic-Types.html#gboolean"
 602 >gboolean</a>    gnome_vfs_mime_id_in_application_list
 603                                             (const char *id,
 604                                              <a
 605 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 606 >GList</a> *applications);</pre><p>
 607 Check whether an application id is in a list of GnomeVFSMimeApplications.</p><p>
 608
 609 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>id</tt></i> :</span></td><td> An application id.
 610 </td></tr><tr><td><span class="term"><i class="parameter"><tt>applications</tt></i> :</span></td><td> A GList * whose nodes are GnomeVFSMimeApplications, such as the
 611 result of <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-short-list-applications">gnome_vfs_mime_get_short_list_applications</a>().
 612 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE if an application whose id matches <i class="parameter"><tt>id</tt></i> is in <i class="parameter"><tt>applications</tt></i>.
 613 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-id-in-component-list"></a>gnome_vfs_mime_id_in_component_list ()</h3><pre class="programlisting"><a
 614 href="../glib/glib-Basic-Types.html#gboolean"
 615 >gboolean</a>    gnome_vfs_mime_id_in_component_list
 616                                             (const char *iid,
 617                                              <a
 618 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 619 >GList</a> *components);</pre><p>
 620 Check whether a component iid is in a list of Bonobo_ServerInfos.</p><p>
 621
 622 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>iid</tt></i> :</span></td><td> A component iid.
 623 </td></tr><tr><td><span class="term"><i class="parameter"><tt>components</tt></i> :</span></td><td> A GList * whose nodes are Bonobo_ServerInfos, such as the
 624 result of <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-short-list-components">gnome_vfs_mime_get_short_list_components</a>().
 625 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE if a component whose iid matches <i class="parameter"><tt>iid</tt></i> is in <i class="parameter"><tt>components</tt></i>.
 626 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-remove-application-from-list"></a>gnome_vfs_mime_remove_application_from_list ()</h3><pre class="programlisting"><a
 627 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 628 >GList</a>*      gnome_vfs_mime_remove_application_from_list
 629                                             (<a
 630 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 631 >GList</a> *applications,
 632                                              const char *application_id,
 633                                              <a
 634 href="../glib/glib-Basic-Types.html#gboolean"
 635 >gboolean</a> *did_remove);</pre><p>
 636 Remove an application specified by id from a list of GnomeVFSMimeApplications.</p><p>
 637
 638 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>applications</tt></i> :</span></td><td> A GList * whose nodes are GnomeVFSMimeApplications, such as the
 639 result of <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-short-list-applications">gnome_vfs_mime_get_short_list_applications</a>().
 640 </td></tr><tr><td><span class="term"><i class="parameter"><tt>application_id</tt></i> :</span></td><td> The id of an application to remove from <i class="parameter"><tt>applications</tt></i>.
 641 </td></tr><tr><td><span class="term"><i class="parameter"><tt>did_remove</tt></i> :</span></td><td> If non-NULL, this is filled in with TRUE if the application
 642 was found in the list, FALSE otherwise.
 643 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The modified list. If the application is not found, the list will
 644 be unchanged.
 645 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-remove-component-from-list"></a>gnome_vfs_mime_remove_component_from_list ()</h3><pre class="programlisting"><a
 646 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 647 >GList</a>*      gnome_vfs_mime_remove_component_from_list
 648                                             (<a
 649 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 650 >GList</a> *components,
 651                                              const char *iid,
 652                                              <a
 653 href="../glib/glib-Basic-Types.html#gboolean"
 654 >gboolean</a> *did_remove);</pre><p>
 655 Remove a component specified by iid from a list of Bonobo_ServerInfos.</p><p>
 656
 657 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>components</tt></i> :</span></td><td> A GList * whose nodes are Bonobo_ServerInfos, such as the
 658 result of <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-short-list-components">gnome_vfs_mime_get_short_list_components</a>().
 659 </td></tr><tr><td><span class="term"><i class="parameter"><tt>iid</tt></i> :</span></td><td> The iid of a component to remove from <i class="parameter"><tt>components</tt></i>.
 660 </td></tr><tr><td><span class="term"><i class="parameter"><tt>did_remove</tt></i> :</span></td><td> If non-NULL, this is filled in with TRUE if the component
 661 was found in the list, FALSE otherwise.
 662 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> The modified list. If the component is not found, the list will
 663 be unchanged.
 664 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-id-list-from-component-list"></a>gnome_vfs_mime_id_list_from_component_list ()</h3><pre class="programlisting"><a
 665 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 666 >GList</a>*      gnome_vfs_mime_id_list_from_component_list
 667                                             (<a
 668 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 669 >GList</a> *components);</pre><p>
 670 Create a list of component iids from a list of Bonobo_ServerInfos.</p><p>
 671
 672 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>components</tt></i> :</span></td><td> A GList * whose nodes are Bonobo_ServerInfos, such as the
 673 result of <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-short-list-components">gnome_vfs_mime_get_short_list_components</a>().
 674 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A new list where each Bonobo_ServerInfo in the original
 675 list is replaced by a char * with the component's iid. The original list is
 676 not modified.
 677 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-id-list-from-application-list"></a>gnome_vfs_mime_id_list_from_application_list ()</h3><pre class="programlisting"><a
 678 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 679 >GList</a>*      gnome_vfs_mime_id_list_from_application_list
 680                                             (<a
 681 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 682 >GList</a> *applications);</pre><p>
 683 Create a list of application ids from a list of GnomeVFSMimeApplications.</p><p>
 684
 685 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>applications</tt></i> :</span></td><td> A GList * whose nodes are GnomeVFSMimeApplications, such as the
 686 result of <a href="gnome-vfs-gnome-vfs-mime-database.html#gnome-vfs-mime-get-short-list-applications">gnome_vfs_mime_get_short_list_applications</a>().
 687 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A new list where each GnomeVFSMimeApplication in the original
 688 list is replaced by a char * with the application's id. The original list is
 689 not modified.
 690 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-freeze"></a>gnome_vfs_mime_freeze ()</h3><pre class="programlisting">void        gnome_vfs_mime_freeze           (void);</pre><p>
 691 Freezes the mime data so that you can do multiple
 692 updates to the dat in one batch without needing
 693 to back the files to disk or readind them</p><p>
 694
 695 </p></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-thaw"></a>gnome_vfs_mime_thaw ()</h3><pre class="programlisting">void        gnome_vfs_mime_thaw             (void);</pre><p>
 696 UnFreezes the mime data so that you can do multiple
 697 updates to the dat in one batch without needing
 698 to back the files to disk or readind them</p><p>
 699
 700 </p></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-info-reload"></a>gnome_vfs_mime_info_reload ()</h3><pre class="programlisting">void        gnome_vfs_mime_info_reload      (void);</pre><p>
 701 Reload the MIME database from disk and notify any listeners
 702 holding active GnomeVFSMIMEMonitor objects.</p><p>
 703
 704 </p></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-type-is-known"></a>gnome_vfs_mime_type_is_known ()</h3><pre class="programlisting"><a
 705 href="../glib/glib-Basic-Types.html#gboolean"
 706 >gboolean</a>    gnome_vfs_mime_type_is_known    (const char *mime_type);</pre><p>
 707 This function returns TRUE if <i class="parameter"><tt>mime_type</tt></i> is in the MIME database at all.</p><p>
 708
 709 </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> a mime type.
 710 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> TRUE if anything is known about <i class="parameter"><tt>mime_type</tt></i>, otherwise FALSE
 711 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-get-value"></a>gnome_vfs_mime_get_value ()</h3><pre class="programlisting">const char* gnome_vfs_mime_get_value        (const char *mime_type,
 712                                              const char *key);</pre><p>
 713 This function retrieves the value associated with <i class="parameter"><tt>key</tt></i> in
 714 the given GnomeMimeContext.  The string is private, you
 715 should not free the result.</p><p>
 716
 717 </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> a mime type.
 718 </td></tr><tr><td><span class="term"><i class="parameter"><tt>key</tt></i> :</span></td><td> A key to lookup for the given mime-type
 719 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> GNOME_VFS_OK if the operation succeeded, otherwise an error code
 720 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-set-value"></a>gnome_vfs_mime_set_value ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_set_value     (const char *mime_type,
 721                                              const char *key,
 722                                              const char *value);</pre><p>
 723 This function is going to set the value
 724 associated to the key and it will save it
 725 to the user' file if necessary.
 726 You should not free the key/values passed to
 727 this function. They are used internally.</p><p>
 728
 729 </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> a mime type.
 730 </td></tr><tr><td><span class="term"><i class="parameter"><tt>key</tt></i> :</span></td><td> a key to store the value in.
 731 </td></tr><tr><td><span class="term"><i class="parameter"><tt>value</tt></i> :</span></td><td> the value to store in the key.
 732 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> GNOME_VFS_OK if the operation succeeded, otherwise an error code
 733
 734 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-get-key-list"></a>gnome_vfs_mime_get_key_list ()</h3><pre class="programlisting"><a
 735 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 736 >GList</a>*      gnome_vfs_mime_get_key_list     (const char *mime_type);</pre><p>
 737 Gets a list of all keys associated with <i class="parameter"><tt>mime_type</tt></i>.</p><p>
 738
 739 </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> the MIME type to lookup
 740 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> a GList of const char * representing keys associated
 741 with <i class="parameter"><tt>mime_type</tt></i>
 742 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-keys-list-free"></a>gnome_vfs_mime_keys_list_free ()</h3><pre class="programlisting">void        gnome_vfs_mime_keys_list_free   (<a
 743 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 744 >GList</a> *mime_type_list);</pre><p>
 745 Frees the mime type list.</p><p>
 746
 747 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>mime_type_list</tt></i> :</span></td><td> A mime type list to free.
 748 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-get-extensions-list"></a>gnome_vfs_mime_get_extensions_list ()</h3><pre class="programlisting"><a
 749 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 750 >GList</a>*      gnome_vfs_mime_get_extensions_list
 751                                             (const char *mime_type);</pre><p>
 752 Get the file extensions associated with mime type <i class="parameter"><tt>mime_type</tt></i>.</p><p>
 753
 754 </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> type to get the extensions of
 755 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> a GList of char *s
 756 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-extensions-list-free"></a>gnome_vfs_mime_extensions_list_free ()</h3><pre class="programlisting">void        gnome_vfs_mime_extensions_list_free
 757                                             (<a
 758 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 759 >GList</a> *list);</pre><p>
 760 Call this function on the list returned by gnome_vfs_mime_extensions
 761 to free the list and all of its elements.</p><p>
 762
 763 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>list</tt></i> :</span></td><td> the extensions list
 764 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-get-extensions-string"></a>gnome_vfs_mime_get_extensions_string ()</h3><pre class="programlisting">char*       gnome_vfs_mime_get_extensions_string
 765                                             (const char *mime_type);</pre><p>
 766 Retrieves the extensions associated with <i class="parameter"><tt>mime_type</tt></i> as a single
 767 space seperated string.</p><p>
 768
 769 </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> the mime type
 770 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> a string containing space seperated extensions for <i class="parameter"><tt>mime_type</tt></i>
 771 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-get-extensions-pretty-string"></a>gnome_vfs_mime_get_extensions_pretty_string ()</h3><pre class="programlisting">char*       gnome_vfs_mime_get_extensions_pretty_string
 772                                             (const char *mime_type);</pre><p>
 773 Returns the supported extensions for <i class="parameter"><tt>mime_type</tt></i> as a comma-seperated list.</p><p>
 774
 775 </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> the mime type
 776 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> a string containing comma seperated extensions for this mime-type
 777 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-get-registered-mime-types"></a>gnome_vfs_get_registered_mime_types ()</h3><pre class="programlisting"><a
 778 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 779 >GList</a>*      gnome_vfs_get_registered_mime_types
 780                                             (void);</pre><p>
 781
 782 </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>
 783
 784
 785 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-registered-mime-type-list-free"></a>gnome_vfs_mime_registered_mime_type_list_free ()</h3><pre class="programlisting">void        gnome_vfs_mime_registered_mime_type_list_free
 786                                             (<a
 787 href="../glib/glib-Doubly-Linked-Lists.html#GList"
 788 >GList</a> *list);</pre><p>
 789 Call this function on the list returned by gnome_vfs_get_registered_mime_types
 790 to free the list and all of its elements.</p><p>
 791
 792 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>list</tt></i> :</span></td><td> the extensions list
 793 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-set-registered-type-key"></a>gnome_vfs_mime_set_registered_type_key ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_set_registered_type_key
 794                                             (const char *mime_type,
 795                                              const char *key,
 796                                              const char *data);</pre><p>
 797 This function sets the key data for the registered mime
 798 type's hash table.</p><p>
 799
 800 </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 to set key for
 801 </td></tr><tr><td><span class="term"><i class="parameter"><tt>key</tt></i> :</span></td><td>    The key to set
 802 </td></tr><tr><td><span class="term"><i class="parameter"><tt>data</tt></i> :</span></td><td>   The data to set for the key
 803 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> GNOME_VFS_OK if the operation succeeded, otherwise an error code
 804 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-set-extensions-list"></a>gnome_vfs_mime_set_extensions_list ()</h3><pre class="programlisting"><a href="gnome-vfs-gnome-vfs-result.html#GnomeVFSResult">GnomeVFSResult</a> gnome_vfs_mime_set_extensions_list
 805                                             (const char *mime_type,
 806                                              const char *extensions_list);</pre><p>
 807 Sets the extensions for a given mime type. Overrides
 808 the previously set extensions.</p><p>
 809
 810 </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> the mime type.
 811 </td></tr><tr><td><span class="term"><i class="parameter"><tt>extensions_list</tt></i> :</span></td><td> a whitespace-separated list of the
 812                   extensions to set for this mime type.
 813 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> GNOME_VFS_OK if the operation succeeded, otherwise an error code.
 814 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-registered-mime-type-delete"></a>gnome_vfs_mime_registered_mime_type_delete ()</h3><pre class="programlisting">void        gnome_vfs_mime_registered_mime_type_delete
 815                                             (const char *mime_type);</pre><p>
 816 Delete a mime type for the user which runs this command.
 817 You can undo this only by calling gnome_vfs_mime_reset</p><p>
 818
 819 </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> string representing the existing type to delete
 820 </td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><h3><a name="gnome-vfs-mime-reset"></a>gnome_vfs_mime_reset ()</h3><pre class="programlisting">void        gnome_vfs_mime_reset            (void);</pre><p>
 821 resets the user's mime database to the system defaults.</p><p>
 822
 823 </p></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="gnome-vfs-gnome-vfs-application-registry.html"><b>&lt;&lt;
 824 Application Registry</b></a></td><td align="right"><a accesskey="n" href="gnome-vfs-gnome-vfs-mime-monitor.html"><b>
 825 MIME Database Monitor &gt;&gt;</b></a></td></tr></table></body></html>