<!-- ##### SECTION Title ##### -->
XfceFileChooser

<!-- ##### SECTION Short_Description ##### -->
a wrapper around <ulink url="http://developer.gnome.org/doc/API/2.0/gtk/GtkFileSelection.html">GtkFileSelection</ulink> and <ulink url="http://developer.gnome.org/doc/API/2.0/gtk/GtkFileChooserDialog.html">GtkFileChooserDialog</ulink>

<!-- ##### SECTION Long_Description ##### -->
<para>
#XfceFileChooser is meant to be used as a gtk-version-neutral file selector.
If libxfcegui4 is compiled against GTK+ 2.0 or 2.2, #XfceFileChooser will use
the older
<ulink url="http://developer.gnome.org/doc/API/2.0/gtk/GtkFileSelection.html">GtkFileSelection</ulink>.
If libxfcegui4 is compiled against GTK+ 2.4 or greater, #XfceFileChooser will
use <ulink url="http://developer.gnome.org/doc/API/2.0/gtk/GtkFileChooserDialog.html">GtkFileChooserDialog</ulink>.
The API of #XfceFileChooser is designed to be similar to that of the
<ulink url="http://developer.gnome.org/doc/API/2.0/gtk/GtkFileChooser.html">GtkFileChooser</ulink>
interface, and may behave differently from the older
<ulink url="http://developer.gnome.org/doc/API/2.0/gtk/GtkFileSelection.html">GtkFileSelection</ulink>
API.
</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### SECTION Stability_Level ##### -->


<!-- ##### TYPEDEF XfceFileChooser ##### -->
<para>

</para>


<!-- ##### ENUM XfceFileChooserAction ##### -->
    <para>
      Describes whether a #XfceFileChooser is being used to open
      existing files or to save to a possibly new file.
    </para>

@XFCE_FILE_CHOOSER_ACTION_OPEN: Indicates open mode.  The file chooser
    will only let the user pick an existing file.
@XFCE_FILE_CHOOSER_ACTION_SAVE: Indicates save mode.  The file chooser
    will let the user pick an existing file, or type in a new
    filename.
@XFCE_FILE_CHOOSER_ACTION_SELECT_FOLDER: Indicates an Open mode for
    selecting folders.  The file chooser will let the user pick an
    existing folder.
@XFCE_FILE_CHOOSER_ACTION_CREATE_FOLDER: Indicates a mode for creating a
    new folder.  The file chooser will let the user name an existing or
    new folder.

<!-- ##### USER_FUNCTION PreviewUpdateFunc ##### -->
<para>
Use this function prototype for functions to be passed to
xfce_file_chooser_set_preview_callback().
</para>

@chooser: The #XfceFileChooser where the signal occurred.
@user_data: The @user_data passed to xfce_file_chooser_set_preview_callback().


<!-- ##### FUNCTION xfce_file_chooser_dialog_new ##### -->
<para>

</para>

@title: 
@parent: 
@action: 
@first_button_text: 
@Varargs: 
@Returns: 


<!-- ##### FUNCTION xfce_file_chooser_new ##### -->
<para>

</para>

@title: 
@parent: 
@action: 
@first_button_text: 
@Varargs: 
@Returns: 


<!-- ##### FUNCTION xfce_file_chooser_set_select_multiple ##### -->
<para>

</para>

@chooser: 
@select_multiple: 


<!-- ##### FUNCTION xfce_file_chooser_get_select_multiple ##### -->
<para>

</para>

@chooser: 
@Returns: 


<!-- ##### FUNCTION xfce_file_chooser_set_current_name ##### -->
<para>

</para>

@chooser: 
@name: 


<!-- ##### FUNCTION xfce_file_chooser_get_filename ##### -->
<para>

</para>

@chooser: 
@Returns: 


<!-- ##### FUNCTION xfce_file_chooser_set_filename ##### -->
<para>

</para>

@chooser: 
@filename: 
@Returns: 


<!-- ##### FUNCTION xfce_file_chooser_get_filenames ##### -->
<para>

</para>

@chooser: 
@Returns: 


<!-- ##### FUNCTION xfce_file_chooser_set_current_folder ##### -->
<para>

</para>

@chooser: 
@filename: 
@Returns: 


<!-- ##### FUNCTION xfce_file_chooser_get_current_folder ##### -->
<para>

</para>

@chooser: 
@Returns: 


<!-- ##### FUNCTION xfce_file_chooser_set_preview_widget ##### -->
<para>

</para>

@chooser: 
@preview_widget: 


<!-- ##### FUNCTION xfce_file_chooser_get_preview_widget ##### -->
<para>

</para>

@chooser: 
@Returns: 


<!-- ##### FUNCTION xfce_file_chooser_set_preview_callback ##### -->
<para>

</para>

@chooser: 
@func: 
@user_data: 


<!-- ##### FUNCTION xfce_file_chooser_set_preview_widget_active ##### -->
<para>

</para>

@chooser: 
@active: 


<!-- ##### FUNCTION xfce_file_chooser_get_preview_widget_active ##### -->
<para>

</para>

@chooser: 
@Returns: 


<!-- ##### FUNCTION xfce_file_chooser_set_use_preview_label ##### -->
<para>

</para>

@chooser: 
@use_label: 


<!-- ##### FUNCTION xfce_file_chooser_set_extra_widget ##### -->
<para>

</para>

@chooser: 
@extra_widget: 


<!-- ##### FUNCTION xfce_file_chooser_get_extra_widget ##### -->
<para>

</para>

@chooser: 
@Returns: 


<!-- ##### FUNCTION xfce_file_chooser_add_filter ##### -->
<para>

</para>

@chooser: 
@filter: 


<!-- ##### FUNCTION xfce_file_chooser_remove_filter ##### -->
<para>

</para>

@chooser: 
@filter: 


<!-- ##### FUNCTION xfce_file_chooser_set_filter ##### -->
<para>

</para>

@chooser: 
@filter: 


<!-- ##### FUNCTION xfce_file_chooser_set_local_only ##### -->
<para>

</para>

@chooser: 
@local_only: 


<!-- ##### FUNCTION xfce_file_chooser_get_local_only ##### -->
<para>

</para>

@chooser: 
@Returns: 


<!-- ##### FUNCTION xfce_file_chooser_add_shortcut_folder ##### -->
<para>

</para>

@chooser: 
@folder: 
@error: 
@Returns: 


<!-- ##### FUNCTION xfce_file_chooser_remove_shortcut_folder ##### -->
<para>

</para>

@chooser: 
@folder: 
@error: 
@Returns: 


<!-- ##### TYPEDEF XfceFileFilter ##### -->
<para>
With GTK+ 2.4, this object is mapped to a
<ulink url="http://developer.gnome.org/doc/API/2.0/gtk/GtkFileFilter.html">GtkFileFilter</ulink>.
However, with GTK+ 2.0 or 2.2, this object doesn't exist, so functions that use
it will return and expect a %NULL value.  As such, pointers to an
#XfceFileFilter should be treated as opaque, and no attempt should be made to
dereference them.
</para>


<!-- ##### FUNCTION xfce_file_filter_new ##### -->
<para>

</para>

@Returns: 


<!-- ##### FUNCTION xfce_file_filter_set_name ##### -->
<para>

</para>

@filter: 
@name: 


<!-- ##### FUNCTION xfce_file_filter_add_mime_type ##### -->
<para>

</para>

@filter: 
@mime_type: 


<!-- ##### FUNCTION xfce_file_filter_add_pattern ##### -->
<para>

</para>

@filter: 
@pattern: 


