|
|
|
GIMP Widgets Library Reference Manual | |
|---|---|---|---|---|
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);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkHBox +----GimpFileEntry
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.
typedef struct _GimpFileEntry GimpFileEntry;
GimpFileEntry is deprecated and should not be used in newly-written code.
GtkWidget* 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.
|
The title of the GtkFileEntry dialog. |
|
The initial filename. |
|
TRUE if the file entry should accept directories only.
|
|
TRUE if the widget should check if the entered file
really exists.
|
Returns : |
A pointer to the new GimpFileEntry widget. |
gchar* 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.
|
The file entry you want to know the filename from. |
Returns : |
The file or directory the user has entered. |
void 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.
|
The file entry you want to set the filename for. |
|
The new filename. |
"filename-changed" signalvoid user_function (GimpFileEntry *arg0, gpointer user_data) : Run First
This signal is emitted whenever the user changes the filename.
|
user data set when the signal handler was connected. |