| Libgnomefilesel Reference Manual | |||
|---|---|---|---|
| <<< Previous Page | Home | Up | |
char* gnome_file_selector_open (GtkWindow *parent, gboolean enable_vfs, const char *title, const char *mime_types, const char *default_path); char** gnome_file_selector_open_multi (GtkWindow *parent, gboolean enable_vfs, const char *title, const char *mime_types, const char *default_path); char* gnome_file_selector_save (GtkWindow *parent, gboolean enable_vfs, const char *title, const char *mime_types, const char *default_path, const char *default_filename); |
This library provides some utility functions for using the new GNOME File Selector. It provides a way to use the most common features of the new dialog, with a simple 1 function API. It also provides a fallback on the old GTK file selector if the new one is not installed.
char* gnome_file_selector_open (GtkWindow *parent,
gboolean enable_vfs,
const char *title,
const char *mime_types,
const char *default_path); |
Creates and shows a modal open file dialog, waiting for the user to select a file or cancel before returning.
| parent : | optional window the dialog should be a transient for. |
| enable_vfs : | if FALSE, restrict files to local paths. |
| title : | optional window title to use |
| mime_types : | optional list of mime types to provide filters for. These are of the form: "HTML Files:text/html|Text Files:text/html,text/plain" |
| default_path : | optional directory to start in |
| Returns : | the URI (or plain file path if enable_vfs is FALSE) of the file selected, or NULL if cancel was pressed. |
char** gnome_file_selector_open_multi (GtkWindow *parent,
gboolean enable_vfs,
const char *title,
const char *mime_types,
const char *default_path); |
Creates and shows a modal open file dialog, waiting for the user to select a file or cancel before returning.
| parent : | optional window the dialog should be a transient for |
| enable_vfs : | if FALSE, restrict files to local paths. |
| title : | optional window title to use |
| mime_types : | optional list of mime types to provide filters for. These are of the form: "HTML Files:text/html|Text Files:text/html,text/plain" |
| default_path : | optional directory to start in |
| Returns : | a NULL terminated string array of the selected URIs (or local file paths if enable_vfs is FALSE), or NULL if cancel was pressed. |
char* gnome_file_selector_save (GtkWindow *parent,
gboolean enable_vfs,
const char *title,
const char *mime_types,
const char *default_path,
const char *default_filename); |
Creates and shows a modal save file dialog, waiting for the user to select a file or cancel before returning.
| parent : | optional window the dialog should be a transient for |
| enable_vfs : | if FALSE, restrict files to local paths. |
| title : | optional window title to use |
| mime_types : | optional list of mime types to provide filters for. These are of the form: "HTML Files:text/html|Text Files:text/html,text/plain" |
| default_path : | optional directory to start in |
| default_filename : | optional file name to default to |
| Returns : | the URI (or plain file path if enable_vfs is FALSE) of the file selected, or NULL if cancel was pressed. |