bonobo-file-selector-util: LibBonoboUI API Reference Manual

bonobo-file-selector-util

Functions

char *	bonobo_file_selector_open ()
char **	bonobo_file_selector_open_multi ()
char *	bonobo_file_selector_save ()

Description

Functions

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.

Parameters

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.

Parameters

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.

Parameters

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.