GimpFileEntry

GimpFileEntry — Widget for entering a filename.

Synopsis




struct      GimpFileEntry;
GtkWidget*  gimp_file_entry_new             (const gchar *title,
                                             const gchar *filename,
                                             gboolean dir_only,
                                             gboolean check_valid);
gchar*      gimp_file_entry_get_filename    (GimpFileEntry *entry);
void        gimp_file_entry_set_filename    (GimpFileEntry *entry,
                                             const gchar *filename);

Object Hierarchy


  GObject
   +----GtkObject
         +----GtkWidget
               +----GtkContainer
                     +----GtkBox
                           +----GtkHBox
                                 +----GimpFileEntry

Implemented Interfaces

GimpFileEntry implements AtkImplementorIface.

Signal Prototypes


"filename-changed"
            void        user_function      (GimpFileEntry *,
                                            gpointer user_data);

Description

This widget is used to enter filenames or directories.

There is a GtkEntry for entering the filename manually and a "..." button which will pop up a GtkFileSelection dialog.

You can restrict the GimpFileSelection to directories. In this case the filename listbox of the GtkFileSelection dialog will be hidden.

If you specify check_valid as TRUE in gimp_file_entry_new() the entered filename will be checked for validity and a pixmap will be shown which indicates if the file exists or not.

Whenever the user changes the filename, the "filename_changed" signal will be emitted.

Details

struct GimpFileEntry

struct GimpFileEntry;

gimp_file_entry_new ()

GtkWidget*  gimp_file_entry_new             (const gchar *title,
                                             const gchar *filename,
                                             gboolean dir_only,
                                             gboolean check_valid);

Creates a new GimpFileEntry widget.

`title` :	The title of the GtkFileEntry dialog.
`filename` :	The initial filename.
`dir_only` :	`TRUE` if the file entry should accept directories only.
`check_valid` :	`TRUE` if the widget should check if the entered file really exists.
Returns :	A pointer to the new GimpFileEntry widget.

gimp_file_entry_get_filename ()

gchar*      gimp_file_entry_get_filename    (GimpFileEntry *entry);

Note that you have to g_free() the returned string.

`entry` :	The file entry you want to know the filename from.
Returns :	The file or directory the user has entered.

gimp_file_entry_set_filename ()

void        gimp_file_entry_set_filename    (GimpFileEntry *entry,
                                             const gchar *filename);

If you specified check_valid as TRUE in gimp_file_entry_new() the GimpFileEntry will immediately check the validity of the file name.

`entry` :	The file entry you want to set the filename for.
`filename` :	The new filename.

Signals

The "filename-changed" signal

void        user_function                  (GimpFileEntry *,
                                            gpointer user_data);

This signal is emitted whenever the user changes the filename.

user_data : user data set when the signal handler was connected.