GimpFileEntry3LIBGIMPWIDGETS LibraryGimpFileEntryWidget for entering a filename.Synopsis
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
+----GInitiallyUnowned
+----GtkObject
+----GtkWidget
+----GtkContainer
+----GtkBox
+----GtkHBox
+----GimpFileEntry
Implemented Interfaces
GimpFileEntry implements
AtkImplementorIface.Signals
"filename-changed" : Run First
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.
DetailsGimpFileEntryGimpFileEntrytypedef struct _GimpFileEntry GimpFileEntry;GimpFileEntry is deprecated and should not be used in newly-written code.gimp_file_entry_new ()gimp_file_entry_newGtkWidget* gimp_file_entry_new (const gchar *title,
const gchar *filename,
gboolean dir_only,
gboolean check_valid);gimp_file_entry_new is deprecated and should not be used in newly-written code.
You should use GtkFileChooserButton instead.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 ()gimp_file_entry_get_filenamegchar* gimp_file_entry_get_filename (GimpFileEntry *entry);gimp_file_entry_get_filename is deprecated and should not be used in newly-written code.
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 ()gimp_file_entry_set_filenamevoid gimp_file_entry_set_filename (GimpFileEntry *entry,
const gchar *filename);gimp_file_entry_set_filename is deprecated and should not be used in newly-written code.
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.
Signal DetailsThe "filename-changed" signalGimpFileEntry::filename-changedvoid user_function (GimpFileEntry *arg0,
gpointer user_data) : Run First
This signal is emitted whenever the user changes the filename.user_data :user data set when the signal handler was connected.See AlsoGimpPathEditor