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.