gimp/devel-docs/libgimpwidgets/tmpl/gimpfileselection.sgml

77 lines
1.5 KiB
Plaintext

<!-- ##### SECTION Title ##### -->
GimpFileSelection
<!-- ##### SECTION Short_Description ##### -->
Widget for entering a filename.
<!-- ##### SECTION Long_Description ##### -->
<para>
This widget is used to enter filenames or directories.
</para>
<para>
There is a #GtkEntry for entering the filename manually and a "..."
button which will pop up a #GtkFileSelection dialog.
</para>
<para>
You can restrict the #GimpFileSelection to directories. In this case
the filename listbox of the #GtkFileSelection dialog will be hidden.
</para>
<para>
If you specify @check_valid as #TRUE in gimp_file_selection_new()
the entered filename will be checked for validity and a pixmap will be
shown which indicates if the file exists or not.
</para>
<para>
Whenever the user changes the filename, the "filename_changed" signal
will be emitted.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
#GimpPathEditor
</para>
<!-- ##### STRUCT GimpFileSelection ##### -->
<para>
</para>
<!-- ##### FUNCTION gimp_file_selection_new ##### -->
<para>
</para>
@title:
@filename:
@dir_only:
@check_valid:
@Returns:
<!-- ##### FUNCTION gimp_file_selection_get_filename ##### -->
<para>
</para>
@gfs:
@Returns:
<!-- ##### FUNCTION gimp_file_selection_set_filename ##### -->
<para>
</para>
@gfs:
@filename:
<!-- ##### SIGNAL GimpFileSelection::filename-changed ##### -->
<para>
This signal is emitted whenever the user changes the filename.
</para>
@gimpfileselection: the object which received the signal.