GimpFileEntry 3 LIBGIMPWIDGETS Library GimpFileEntry Widget 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. Details <anchor id="GimpFileEntry-struct" role="struct"/>GimpFileEntry GimpFileEntrytypedef struct _GimpFileEntry GimpFileEntry; GimpFileEntry is deprecated and should not be used in newly-written code. <anchor id="gimp-file-entry-new" role="function" condition="deprecated:"/>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. <anchor id="gimp-file-entry-get-filename" role="function" condition="deprecated:"/>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. <anchor id="gimp-file-entry-set-filename" role="function" condition="deprecated:"/>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 Details <anchor id="GimpFileEntry-filename-changed"/>The "filename-changed" signal GimpFileEntry::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 Also GimpPathEditor