Top |
enum | GnomeVFSMimeActionType |
enum | GnomeVFSMimeApplicationArgumentType |
struct | GnomeVFSMimeAction |
GnomeVFSMimeActionType
gnome_vfs_mime_get_default_action_type
(const char *mime_type
);
gnome_vfs_mime_get_default_action_type
is deprecated and should not be used in newly-written code.
This function does not work with the new mime system. It always returns none
Query the MIME database for the type of action to be performed on mime_type
.
GnomeVFSMimeAction *
gnome_vfs_mime_get_default_action (const char *mime_type
);
gnome_vfs_mime_get_default_action
is deprecated and should not be used in newly-written code.
Use gnome_vfs_mime_get_default_application()
instead.
Query the MIME database for default action associated with mime_type
.
a GnomeVFSMimeAction representing the default action to perform upon
file of type mime_type
.
GList *
gnome_vfs_mime_get_short_list_applications
(const char *mime_type
);
gnome_vfs_mime_get_short_list_applications
is deprecated and should not be used in newly-written code.
Use gnome_vfs_mime_get_all_applications()
instead.
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.
a GList * where the elements are GnomeVFSMimeApplication *
representing various applications to display in the short list for mime_type
.
GList *
gnome_vfs_mime_get_short_list_components
(const char *mime_type
);
gnome_vfs_mime_get_short_list_components
is deprecated and should not be used in newly-written code.
GnomeVFSResult gnome_vfs_mime_set_default_action_type (const char *mime_type
,GnomeVFSMimeActionType action_type
);
gnome_vfs_mime_set_default_action_type
is deprecated and should not be used in newly-written code.
User modifications to the MIME database are no longer supported by gnome-vfs.
Sets the default action type to be performed on files of mime_type
.
mime_type |
a const char * containing a mime type, e.g. "image/png". |
|
action_type |
a GnomeVFSMimeActionType containing the action to perform by default. |
a GnomeVFSResult indicating the success of the operation or reporting any errors encountered.
GnomeVFSResult gnome_vfs_mime_set_icon (const char *mime_type
,const char *filename
);
gnome_vfs_mime_set_icon
is deprecated and should not be used in newly-written code.
User modifications to the MIME database are no longer supported in gnome-vfs.
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.
mime_type |
a const char * containing a MIME type. |
|
filename |
a const char * containing an image filename. |
a GnomeVFSResult indicating the success of the operation or any errors that may have occurred.
GnomeVFSResult gnome_vfs_mime_set_description (const char *mime_type
,const char *description
);
gnome_vfs_mime_set_description
is deprecated and should not be used in newly-written code.
User modifications to the MIME database are no longer supported by gnome-vfs.
Set the description
of this MIME type in the MIME database. The description
should be something like "Gnumeric spreadsheet".
mime_type |
a const char * containing a mime type. |
|
description |
a description of this MIME type. |
GnomeVFSResult indicating the success of the operation or any errors that may have occurred.
GnomeVFSResult gnome_vfs_mime_set_can_be_executable (const char *mime_type
,gboolean new_value
);
gnome_vfs_mime_set_can_be_executable
is deprecated and should not be used in newly-written code.
Set whether files of mime_type
might conceivably be executable.
mime_type |
a const char * containing a mime type. |
|
new_value |
a boolean value indicating whether |
a GnomeVFSResult indicating the success of the operation or any errors that may have occurred.
GnomeVFSResult gnome_vfs_mime_set_short_list_applications (const char *mime_type
,GList *application_ids
);
gnome_vfs_mime_set_short_list_applications
is deprecated and should not be used in newly-written code.
User modifications to the MIME database are no longer supported by gnome-vfs.
Set the short list of applications for the specified MIME type. The short list contains applications recommended for possible selection by the user.
mime_type |
a const char * containing a mime type, e.g. "application/x-php". |
|
application_ids |
GList of const char * application ids. |
a GnomeVFSResult indicating the success of the operation or reporting any errors encountered.
GnomeVFSResult gnome_vfs_mime_set_short_list_components (const char *mime_type
,GList *component_iids
);
gnome_vfs_mime_set_short_list_components
is deprecated and should not be used in newly-written code.
User modifications to the MIME database are no longer supported by gnome-vfs.
Set the short list of components for the mime_type
. The short list
contains companents recommended for possible selection by the user.
mime_type |
a const char * containing a mime type, e.g. "application/x-php". |
|
component_iids |
GList of const char * OAFIIDs. |
a GnomeVFSResult indicating the success of the operation or reporting any errors encountered.
GnomeVFSResult gnome_vfs_mime_add_application_to_short_list (const char *mime_type
,const char *application_id
);
gnome_vfs_mime_add_application_to_short_list
is deprecated and should not be used in newly-written code.
User modifications to the MIME database are no longer supported by gnome-vfs.
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.
mime_type |
a const char * containing a mime type, e.g. "application/x-php". |
|
application_id |
const char * containing the application's id in the MIME database. |
a GnomeVFSResult indicating the success of the operation or reporting any errors encountered.
GnomeVFSResult gnome_vfs_mime_remove_application_from_short_list (const char *mime_type
,const char *application_id
);
gnome_vfs_mime_remove_application_from_short_list
is deprecated and should not be used in newly-written code.
User modifications to the MIME database are no longer supported by gnome-vfs.
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.
mime_type |
a const char * containing a mime type, e.g. "application/x-php". |
|
application_id |
const char * containing the application's id in the MIME database. |
a GnomeVFSResult indicating the success of the operation or reporting any errors encountered.
GnomeVFSResult gnome_vfs_mime_add_component_to_short_list (const char *mime_type
,const char *iid
);
gnome_vfs_mime_add_component_to_short_list
is deprecated and should not be used in newly-written code.
User modifications to the MIME database are no longer supported by gnome-vfs.
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.
mime_type |
a const char * containing a mime type, e.g. "application/x-php". |
|
iid |
const char * containing the component's OAFIID. |
a GnomeVFSResult indicating the success of the operation or reporting any errors encountered.
GnomeVFSResult gnome_vfs_mime_remove_component_from_short_list (const char *mime_type
,const char *iid
);
gnome_vfs_mime_remove_component_from_short_list
is deprecated and should not be used in newly-written code.
User modifications to the MIME database are no longer supported by gnome-vfs.
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.
mime_type |
a const char * containing a mime type, e.g. "application/x-php". |
|
iid |
const char * containing the component's OAFIID. |
a GnomeVFSResult indicating the success of the operation or reporting any errors encountered.
GnomeVFSResult gnome_vfs_mime_set_default_application (const char *mime_type
,const char *application_id
);
gnome_vfs_mime_set_default_application
is deprecated and should not be used in newly-written code.
User modifications to the MIME database are no longer supported by gnome-vfs.
Sets the default application to be run on files of mime_type
.
mime_type |
a const char * containing a mime type, e.g. "application/x-php". |
|
application_id |
a key representing an application in the MIME database (GnomeVFSMimeApplication->id, for example). |
a GnomeVFSResult indicating the success of the operation or reporting any errors encountered.
GnomeVFSResult gnome_vfs_mime_set_default_component (const char *mime_type
,const char *component_iid
);
gnome_vfs_mime_set_default_component
is deprecated and should not be used in newly-written code.
User modifications to the MIME database are no longer supported by gnome-vfs.
Sets the default component to be activated for files of mime_type
.
mime_type |
a const char * containing a mime type, e.g. "application/x-php". |
|
component_iid |
OAFIID of a component. |
a GnomeVFSResult indicating the success of the operation or reporting any errors encountered.
GnomeVFSResult gnome_vfs_mime_add_extension (const char *mime_type
,const char *extension
);
gnome_vfs_mime_add_extension
is deprecated and should not be used in newly-written code.
User modifications to the MIME database are no longer supported by gnome-vfs.
Add a file extension to the specificed MIME type in the MIME database.
a GnomeVFSResult indicating the success of the operation or any errors that may have occurred.
GnomeVFSResult gnome_vfs_mime_remove_extension (const char *mime_type
,const char *extension
);
gnome_vfs_mime_remove_extension
is deprecated and should not be used in newly-written code.
User modifications to the MIME database are no longer supported by gnome-vfs.
Removes a file extension from the mime_type
in the MIME database.
a GnomeVFSResult indicating the success of the operation or any errors that may have occurred.
GnomeVFSResult gnome_vfs_mime_extend_all_applications (const char *mime_type
,GList *application_ids
);
gnome_vfs_mime_extend_all_applications
is deprecated and should not be used in newly-written code.
User modifications to the MIME database are no longer supported by gnome-vfs.
Register mime_type
as being handled by all applications list in application_ids
.
mime_type |
a const char * containing a mime type, e.g. "application/x-php". |
|
application_ids |
a GList of const char * containing application ids. |
a GnomeVFSResult indicating the success of the operation or reporting any errors encountered.
GnomeVFSResult gnome_vfs_mime_remove_from_all_applications (const char *mime_type
,GList *application_ids
);
gnome_vfs_mime_remove_from_all_applications
is deprecated and should not be used in newly-written code.
User modifications to the MIME database are no longer supported by gnome-vfs.
Remove mime_type
as a handled type from every application in application_ids
mime_type |
a const char * containing a mime type, e.g. "application/x-php". |
|
application_ids |
a GList of const char * containing application ids. |
a GnomeVFSResult indicating the success of the operation or reporting any errors encountered.
GnomeVFSMimeApplication *
gnome_vfs_mime_application_new_from_id
(const char *id
);
gnome_vfs_mime_application_new_from_id
is deprecated and should not be used in newly-written code.
Use gnome_vfs_mime_application_new_from_desktop_id()
instead.
Fetches the GnomeVFSMimeApplication associated with the specified
application id
from the MIME database.
GnomeVFSResult gnome_vfs_mime_action_launch (GnomeVFSMimeAction *action
,GList *uris
);
gnome_vfs_mime_action_launch
is deprecated and should not be used in newly-written code.
MIME actions are deprecated, use
gnome_vfs_mime_application_launch()
instead.
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.
GNOME_VFS_OK
if the action
was launched,
GNOME_VFS_ERROR_BAD_PARAMETERS
for an invalid action
.
GNOME_VFS_ERROR_NOT_SUPPORTED
if the uri protocol is
not supported by the action
.
GNOME_VFS_ERROR_PARSE
if the action
command can not be parsed.
GNOME_VFS_ERROR_LAUNCH
if the action
command can not be launched.
GNOME_VFS_ERROR_INTERNAL
for other internal and GConf errors.
Since: 2.4
GnomeVFSResult gnome_vfs_mime_action_launch_with_env (GnomeVFSMimeAction *action
,GList *uris
,char **envp
);
gnome_vfs_mime_action_launch_with_env
is deprecated and should not be used in newly-written code.
MIME actions are deprecated, use
gnome_vfs_mime_application_launch_with_env()
instead.
Same as gnome_vfs_mime_action_launch()
except that the
application or component viewer will be launched with
the given environment.
action |
the GnomeVFSMimeAction to launch. |
|
uris |
parameters for the GnomeVFSMimeAction. |
|
envp |
the environment to use for the action. |
Since: 2.4
void
gnome_vfs_mime_action_free (GnomeVFSMimeAction *action
);
gnome_vfs_mime_action_free
is deprecated and should not be used in newly-written code.
GnomeVFSMimeAction structures should not be used in new code.
Frees a GnomeVFSMimeAction *.
gboolean gnome_vfs_mime_id_in_application_list (const char *id
,GList *applications
);
gnome_vfs_mime_id_in_application_list
is deprecated and should not be used in newly-written code.
Check whether an application id is in a list of GnomeVFSMimeApplications.
id |
an application id. |
|
applications |
a GList * whose nodes are GnomeVFSMimeApplications, such as the
result of |
gboolean gnome_vfs_mime_id_in_component_list (const char *iid
,GList *components
);
gnome_vfs_mime_id_in_component_list
is deprecated and should not be used in newly-written code.
GList * gnome_vfs_mime_remove_application_from_list (GList *applications
,const char *application_id
,gboolean *did_remove
);
gnome_vfs_mime_remove_application_from_list
is deprecated and should not be used in newly-written code.
User modifications to the MIME database are no longer supported by gnome-vfs.
Remove an application specified by id from a list of GnomeVFSMimeApplications.
applications |
a GList * whose nodes are GnomeVFSMimeApplications, such as the
result of |
|
application_id |
id of an application to remove from |
|
did_remove |
If non-NULL, this is filled in with |
GList * gnome_vfs_mime_remove_component_from_list (GList *components
,const char *iid
,gboolean *did_remove
);
gnome_vfs_mime_remove_component_from_list
is deprecated and should not be used in newly-written code.
GList *
gnome_vfs_mime_id_list_from_component_list
(GList *components
);
gnome_vfs_mime_id_list_from_component_list
is deprecated and should not be used in newly-written code.
GList *
gnome_vfs_mime_id_list_from_application_list
(GList *applications
);
gnome_vfs_mime_id_list_from_application_list
is deprecated and should not be used in newly-written code.
Create a list of application ids from a list of GnomeVFSMimeApplications.
applications |
a GList * whose nodes are GnomeVFSMimeApplications, such as the
result of |
a new list where each GnomeVFSMimeApplication in the original list is replaced by a char * with the application's id. The original list is not modified.
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.
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.
void
gnome_vfs_mime_info_reload (void
);
Reload the MIME database from disk and notify any listeners holding active GnomeVFSMIMEMonitor objects.
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.
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.
GnomeVFSResult gnome_vfs_mime_set_value (const char *mime_type
,const char *key
,const char *value
);
gnome_vfs_mime_set_value
is deprecated and should not be used in newly-written code.
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.
GList *
gnome_vfs_mime_get_key_list (const char *mime_type
);
gnome_vfs_mime_get_key_list
is deprecated and should not be used in newly-written code.
void
gnome_vfs_mime_keys_list_free (GList *mime_type_list
);
gnome_vfs_mime_keys_list_free
is deprecated and should not be used in newly-written code.
GList *
gnome_vfs_mime_get_extensions_list (const char *mime_type
);
Get the file extensions associated with mime type mime_type
.
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.
char *
gnome_vfs_mime_get_extensions_string (const char *mime_type
);
gnome_vfs_mime_get_extensions_string
is deprecated and should not be used in newly-written code.
char *
gnome_vfs_mime_get_extensions_pretty_string
(const char *mime_type
);
gnome_vfs_mime_get_extensions_pretty_string
is deprecated and should not be used in newly-written code.
GList *
gnome_vfs_get_registered_mime_types (void
);
gnome_vfs_get_registered_mime_types
is deprecated and should not be used in newly-written code.
void
gnome_vfs_mime_registered_mime_type_list_free
(GList *list
);
gnome_vfs_mime_registered_mime_type_list_free
is deprecated and should not be used in newly-written code.
GnomeVFSResult gnome_vfs_mime_set_registered_type_key (const char *mime_type
,const char *key
,const char *data
);
GnomeVFSResult gnome_vfs_mime_set_extensions_list (const char *mime_type
,const char *extensions_list
);
gnome_vfs_mime_set_extensions_list
is deprecated and should not be used in newly-written code.
void
gnome_vfs_mime_registered_mime_type_delete
(const char *mime_type
);
gnome_vfs_mime_registered_mime_type_delete
is deprecated and should not be used in newly-written code.
GnomeVFSMimeActionType
is deprecated and should not be used in newly-written code.
This is used to specify the type
of a GnomeVFSMimeAction.
struct GnomeVFSMimeAction { GnomeVFSMimeActionType action_type; union { void *component; void *dummy_component; GnomeVFSMimeApplication *application; } action; };
GnomeVFSMimeAction
is deprecated and should not be used in newly-written code.
This data structure describes an action that can be done on a file.
GnomeVFSMimeActionType |
The GnomeVFSMimeActionType describing the type of this action. |