enum GnomeVFSMimeActionType

typedef enum {
	GNOME_VFS_MIME_ACTION_TYPE_NONE,
	GNOME_VFS_MIME_ACTION_TYPE_APPLICATION,
	GNOME_VFS_MIME_ACTION_TYPE_COMPONENT
} GnomeVFSMimeActionType;

This is used to specify the type of a GnomeVFSMimeAction.

enum GnomeVFSMimeApplicationArgumentType

typedef enum {
	GNOME_VFS_MIME_APPLICATION_ARGUMENT_TYPE_URIS,
	GNOME_VFS_MIME_APPLICATION_ARGUMENT_TYPE_PATHS,
	GNOME_VFS_MIME_APPLICATION_ARGUMENT_TYPE_URIS_FOR_NON_FILES
} GnomeVFSMimeApplicationArgumentType;

GnomeVFSMimeAction

typedef struct {
	GnomeVFSMimeActionType action_type;
	union {
		void *component;
		void *dummy_component;
		GnomeVFSMimeApplication *application;
} GnomeVFSMimeAction;

This data structure describes an action that can be done on a file.

gnome_vfs_mime_get_default_action_type ()

GnomeVFSMimeActionType gnome_vfs_mime_get_default_action_type
                                            (const char *mime_type);

Query the MIME database for the type of action to be performed on mime_type.

Return value:

gnome_vfs_mime_get_default_action ()

GnomeVFSMimeAction* gnome_vfs_mime_get_default_action
                                            (const char *mime_type);

Query the MIME database for default action associated with mime_type.

Return value:

gnome_vfs_mime_get_short_list_applications ()

GList*      gnome_vfs_mime_get_short_list_applications
                                            (const char *mime_type);

Return an alphabetically sorted list of GnomeVFSMimeApplication data structures for the mime_type. gnome-vfs no longer supports the concept of a "short list" of applications that the user might be interested in.

gnome_vfs_mime_get_short_list_components ()

GList*      gnome_vfs_mime_get_short_list_components
                                            (const char *mime_type);

gnome_vfs_mime_set_default_action_type ()

GnomeVFSResult gnome_vfs_mime_set_default_action_type
                                            (const char *mime_type,
                                             GnomeVFSMimeActionType action_type);

Sets the default action type to be performed on files of mime_type.

gnome_vfs_mime_set_icon ()

GnomeVFSResult gnome_vfs_mime_set_icon      (const char *mime_type,
                                             const char *filename);

Set the icon entry for mime_type in the MIME database. Note that icon entries need not necessarily contain the full path, and do not necessarily need to specify an extension. So "i-regular", "my-special-icon.png", and "some-icon" are all valid icon filenames.

gnome_vfs_mime_set_description ()

GnomeVFSResult gnome_vfs_mime_set_description
                                            (const char *mime_type,
                                             const char *description);

Set the description of this MIME type in the MIME database. The description should be something like "Gnumeric spreadsheet".

gnome_vfs_mime_set_can_be_executable ()

GnomeVFSResult gnome_vfs_mime_set_can_be_executable
                                            (const char *mime_type,
                                             gboolean new_value);

Set whether files of mime_type might conceivably be executable.

gnome_vfs_mime_set_short_list_applications ()

GnomeVFSResult gnome_vfs_mime_set_short_list_applications
                                            (const char *mime_type,
                                             GList *application_ids);

Set the short list of applications for the specified MIME type. The short list contains applications recommended for possible selection by the user.

gnome_vfs_mime_set_short_list_components ()

GnomeVFSResult gnome_vfs_mime_set_short_list_components
                                            (const char *mime_type,
                                             GList *component_iids);

Set the short list of components for the mime_type. The short list contains companents recommended for possible selection by the user.

gnome_vfs_mime_add_application_to_short_list ()

GnomeVFSResult gnome_vfs_mime_add_application_to_short_list
                                            (const char *mime_type,
                                             const char *application_id);

Add an application to the short list for mime_type. The short list contains applications recommended for display as choices to the user for a particular MIME type.

gnome_vfs_mime_remove_application_from_short_list ()

GnomeVFSResult gnome_vfs_mime_remove_application_from_short_list
                                            (const char *mime_type,
                                             const char *application_id);

Remove an application specified by application_id from the short list for mime_type. A short list contains applications recommended for display as choices to the user for a particular MIME type.

gnome_vfs_mime_add_component_to_short_list ()

GnomeVFSResult gnome_vfs_mime_add_component_to_short_list
                                            (const char *mime_type,
                                             const char *iid);

Add a component to the short list for mime_type. A short list contains components recommended for display as choices to the user for a particular MIME type.

gnome_vfs_mime_remove_component_from_short_list ()

GnomeVFSResult gnome_vfs_mime_remove_component_from_short_list
                                            (const char *mime_type,
                                             const char *iid);

Remove a component from the short list for mime_type. The short list contains components recommended for display as choices to the user for a particular MIME type.

gnome_vfs_mime_set_default_application ()

GnomeVFSResult gnome_vfs_mime_set_default_application
                                            (const char *mime_type,
                                             const char *application_id);

Sets the default application to be run on files of mime_type.

gnome_vfs_mime_set_default_component ()

GnomeVFSResult gnome_vfs_mime_set_default_component
                                            (const char *mime_type,
                                             const char *component_iid);

Sets the default component to be activated for files of mime_type.

gnome_vfs_mime_add_extension ()

GnomeVFSResult gnome_vfs_mime_add_extension (const char *mime_type,
                                             const char *extension);

Add a file extension to the specificed MIME type in the MIME database.

gnome_vfs_mime_remove_extension ()

GnomeVFSResult gnome_vfs_mime_remove_extension
                                            (const char *mime_type,
                                             const char *extension);

Removes a file extension from the mime_type in the MIME database.

gnome_vfs_mime_extend_all_applications ()

GnomeVFSResult gnome_vfs_mime_extend_all_applications
                                            (const char *mime_type,
                                             GList *application_ids);

Register mime_type as being handled by all applications list in application_ids.

gnome_vfs_mime_remove_from_all_applications ()

GnomeVFSResult gnome_vfs_mime_remove_from_all_applications
                                            (const char *mime_type,
                                             GList *application_ids);

Remove mime_type as a handled type from every application in application_ids

gnome_vfs_mime_application_new_from_id ()

GnomeVFSMimeApplication* gnome_vfs_mime_application_new_from_id
                                            (const char *id);

Fetches the GnomeVFSMimeApplication associated with the specified application id from the MIME database.

gnome_vfs_mime_action_launch ()

GnomeVFSResult gnome_vfs_mime_action_launch (GnomeVFSMimeAction *action,
                                             GList *uris);

Launches the given mime action with the given parameters. If the action is an application the command line parameters will be expanded as required by the application. The application will also be launched in a terminal if that is required. If the application only supports one argument per instance then multiple instances of the application will be launched.

If the default action is a component it will be launched with the component viewer application defined using the gconf value: /desktop/gnome/application/component_viewer/exec. The parameters s and c in the command line will be replaced with the list of parameters and the default component IID respectively.

Since 2.4

gnome_vfs_mime_action_launch_with_env ()

GnomeVFSResult gnome_vfs_mime_action_launch_with_env
                                            (GnomeVFSMimeAction *action,
                                             GList *uris,
                                             char **envp);

Same as gnome_vfs_mime_action_launch() except that the application or component viewer will be launched with the given environment.

Since 2.4

gnome_vfs_mime_action_free ()

void        gnome_vfs_mime_action_free      (GnomeVFSMimeAction *action);

Frees a GnomeVFSMimeAction *.

gnome_vfs_mime_id_in_application_list ()

gboolean    gnome_vfs_mime_id_in_application_list
                                            (const char *id,
                                             GList *applications);

Check whether an application id is in a list of GnomeVFSMimeApplications.

gnome_vfs_mime_id_in_component_list ()

gboolean    gnome_vfs_mime_id_in_component_list
                                            (const char *iid,
                                             GList *components);

gnome_vfs_mime_remove_application_from_list ()

GList*      gnome_vfs_mime_remove_application_from_list
                                            (GList *applications,
                                             const char *application_id,
                                             gboolean *did_remove);

Remove an application specified by id from a list of GnomeVFSMimeApplications.

gnome_vfs_mime_remove_component_from_list ()

GList*      gnome_vfs_mime_remove_component_from_list
                                            (GList *components,
                                             const char *iid,
                                             gboolean *did_remove);

gnome_vfs_mime_id_list_from_component_list ()

GList*      gnome_vfs_mime_id_list_from_component_list
                                            (GList *components);

gnome_vfs_mime_id_list_from_application_list ()

GList*      gnome_vfs_mime_id_list_from_application_list
                                            (GList *applications);

Create a list of application ids from a list of GnomeVFSMimeApplications.

gnome_vfs_mime_freeze ()

void        gnome_vfs_mime_freeze           (void);

Freezes the mime data so that you can do multiple updates to the data in one batch without needing to back the files to disk or reading them.

gnome_vfs_mime_thaw ()

void        gnome_vfs_mime_thaw             (void);

UnFreezes the mime data so that you can do multiple updates to the data in one batch without needing to back the files to disk or reading them.

gnome_vfs_mime_info_reload ()

void        gnome_vfs_mime_info_reload      (void);

Reload the MIME database from disk and notify any listeners holding active GnomeVFSMIMEMonitor objects.

gnome_vfs_mime_type_is_known ()

gboolean    gnome_vfs_mime_type_is_known    (const char *mime_type);

This function returns TRUE if mime_type is in the MIME database at all.

gnome_vfs_mime_get_value ()

const char* gnome_vfs_mime_get_value        (const char *mime_type,
                                             const char *key);

This function retrieves the value associated with key in the given GnomeMimeContext. The string is private, you should not free the result.

gnome_vfs_mime_set_value ()

GnomeVFSResult gnome_vfs_mime_set_value     (const char *mime_type,
                                             const char *key,
                                             const char *value);

This function will set the value for the key and it will save it to the user' file if necessary. You should not free the key/value passed to this function. They are used internally.

gnome_vfs_mime_get_key_list ()

GList*      gnome_vfs_mime_get_key_list     (const char *mime_type);

gnome_vfs_mime_keys_list_free ()

void        gnome_vfs_mime_keys_list_free   (GList *mime_type_list);

gnome_vfs_mime_get_extensions_list ()

GList*      gnome_vfs_mime_get_extensions_list
                                            (const char *mime_type);

Get the file extensions associated with mime type mime_type.

gnome_vfs_mime_extensions_list_free ()

void        gnome_vfs_mime_extensions_list_free
                                            (GList *list);

Call this function on the list returned by gnome_vfs_mime_get_extensions_list() to free the list and all of its elements.

gnome_vfs_mime_get_extensions_string ()

char*       gnome_vfs_mime_get_extensions_string
                                            (const char *mime_type);

gnome_vfs_mime_get_extensions_pretty_string ()

char*       gnome_vfs_mime_get_extensions_pretty_string
                                            (const char *mime_type);

gnome_vfs_get_registered_mime_types ()

GList*      gnome_vfs_get_registered_mime_types
                                            (void);

gnome_vfs_mime_registered_mime_type_list_free ()

void        gnome_vfs_mime_registered_mime_type_list_free
                                            (GList *list);

gnome_vfs_mime_set_registered_type_key ()

GnomeVFSResult gnome_vfs_mime_set_registered_type_key
                                            (const char *mime_type,
                                             const char *key,
                                             const char *data);

gnome_vfs_mime_set_extensions_list ()

GnomeVFSResult gnome_vfs_mime_set_extensions_list
                                            (const char *mime_type,
                                             const char *extensions_list);

gnome_vfs_mime_registered_mime_type_delete ()

void        gnome_vfs_mime_registered_mime_type_delete
                                            (const char *mime_type);

gnome_vfs_mime_reset ()

void        gnome_vfs_mime_reset            (void);