gnome-file-selector-util

Name

gnome-file-selector-util -- Making the new GNOME File Selector easy.

Synopsis



char*       gnome_file_selector_open        (GtkWindow *parent,
                                             gboolean enable_vfs,
                                             const char *mime_types,
                                             const char *default_path);
char**      gnome_file_selector_open_multi  (GtkWindow *parent,
                                             gboolean enable_vfs,
                                             const char *mime_types,
                                             const char *default_path);
char*       gnome_file_selector_save        (GtkWindow *parent,
                                             gboolean enable_vfs,
                                             const char *mime_types,
                                             const char *default_path,
                                             const char *default_filename);

Description

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.

Details

gnome_file_selector_open ()

char*       gnome_file_selector_open        (GtkWindow *parent,
                                             gboolean enable_vfs,
                                             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.
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.


gnome_file_selector_open_multi ()

char**      gnome_file_selector_open_multi  (GtkWindow *parent,
                                             gboolean enable_vfs,
                                             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.
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.


gnome_file_selector_save ()

char*       gnome_file_selector_save        (GtkWindow *parent,
                                             gboolean enable_vfs,
                                             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.
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.