bonobo-file-selector-util

bonobo-file-selector-util

Synopsis

char *              bonobo_file_selector_open           (GtkWindow *parent,
                                                         gboolean enable_vfs,
                                                         const char *title,
                                                         const char *mime_types,
                                                         const char *default_path);
char **             bonobo_file_selector_open_multi     (GtkWindow *parent,
                                                         gboolean enable_vfs,
                                                         const char *title,
                                                         const char *mime_types,
                                                         const char *default_path);
char *              bonobo_file_selector_save           (GtkWindow *parent,
                                                         gboolean enable_vfs,
                                                         const char *title,
                                                         const char *mime_types,
                                                         const char *default_path,
                                                         const char *default_filename);

Description

Details

bonobo_file_selector_open ()

char *              bonobo_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.

bonobo_file_selector_open_multi ()

char **             bonobo_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.

bonobo_file_selector_save ()

char *              bonobo_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.