|
|
|
GIMP Widgets Library Reference Manual | |
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Signals | ||||
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 +----GimpFileEntry
GimpFileEntry implements AtkImplementorIface, GtkBuildable and GtkOrientable.
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 GtkFileChooserDialog.
You can restrict the GimpFileEntry to directories. In this case the filename listbox of the GtkFileChooser dialog will be set to directory mode.
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 GimpFileEntry 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. |