50c8c56fe0
2003-01-05 Sven Neumann <sven@gimp.org>
* libgimpwidgets/gimpchainbutton.[ch]
* libgimpwidgets/gimpcolorarea.[ch]
* libgimpwidgets/gimpcolorbutton.[ch]
* libgimpwidgets/gimpdialog.c
* libgimpwidgets/gimpfileselection.[ch]
* libgimpwidgets/gimpoffsetarea.c
* libgimpwidgets/gimppickbutton.c
* libgimpwidgets/gimpquerybox.c
* libgimpwidgets/gimpwidgets.c: added more API documentation.
Declared gimp_scale_entry_new_internal() as static.
* libgimpwidgets/gimpwidgets.def: changed accordingly.
80 lines
1.6 KiB
Text
80 lines
1.6 KiB
Text
<!-- ##### 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>
|
|
|
|
@selection:
|
|
@Returns:
|
|
<!-- # Unused Parameters # -->
|
|
@gfs:
|
|
|
|
|
|
<!-- ##### FUNCTION gimp_file_selection_set_filename ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@selection:
|
|
@filename:
|
|
<!-- # Unused Parameters # -->
|
|
@gfs:
|
|
|
|
|
|
<!-- ##### SIGNAL GimpFileSelection::filename-changed ##### -->
|
|
<para>
|
|
This signal is emitted whenever the user changes the filename.
|
|
</para>
|
|
|
|
@gimpfileselection: the object which received the signal.
|
|
|