| GNOME Library Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | ||||
#include <libgnome/libgnome.h> enum GnomeURLError; #define GNOME_URL_ERROR gboolean gnome_url_show (const char *url,GError **error); gboolean gnome_url_show_with_env (const char *url,char **envp,GError **error);
typedef enum {
GNOME_URL_ERROR_PARSE,
GNOME_URL_ERROR_LAUNCH,
GNOME_URL_ERROR_URL,
GNOME_URL_ERROR_NO_DEFAULT,
GNOME_URL_ERROR_NOT_SUPPORTED,
GNOME_URL_ERROR_VFS,
GNOME_URL_ERROR_CANCELLED
} GnomeURLError;
The errors that can be returned due to bad parameters being pass to
gnome_url_show().
gboolean gnome_url_show (const char *url,GError **error);
Once the input has been converted into a fully qualified url this function
calls gnome_vfs_url_show. Any error codes returned by gnome-vfs will be wrapped
in the error parameter. All errors comes from the GNOME_URL_ERROR% domain.
|
The url or path to display. The path can be relative to the current working directory or the user's home directory. This function will convert it into a fully qualified url using the gnome_url_get_from_input function. |
|
Used to store any errors that result from trying to display the url. |
Returns : |
TRUE if everything went fine, FALSE otherwise (in which case
error will contain the actual error). |
gboolean gnome_url_show_with_env (const char *url,char **envp,GError **error);
Like gnome_url_show(), but gnome_vfs_url_show_with_env
will be called with the given envirnoment.
|
The url or path to display. |
|
child's environment, or NULL to inherit parent's. |
|
Used to store any errors that result from trying to display the url. |
Returns : |
TRUE if everything went fine, FALSE otherwise (in which case
error will contain the actual error). |
Since 2.2