=head1 NAME

Gtk2::FileSelection

=head1 HIERARCHY

  Glib::Object
  +----Gtk2::Object
        +----Gtk2::Widget
              +----Gtk2::Container
                    +----Gtk2::Bin
                          +----Gtk2::Window
                                +----Gtk2::Dialog
                                      +----Gtk2::FileSelection

=head1 INTERFACES

  Gtk2::Atk::ImplementorIface


=head1 METHODS

=head2 widget = Gtk2::FileSelection-E<gt>B<new> ($title)

=over

=over

=item * $title (string) 

=back

=back

=head2 widget = $fs-E<gt>B<action_area> 

=over

=back

=head2 widget = $fs-E<gt>B<button_area> 

=over

=back

=head2 widget = $fs-E<gt>B<cancel_button> 

=over

=back

=head2 $filesel-E<gt>B<complete> ($pattern)

=over

=over

=item * $pattern (string) 

=back

=back

=head2 widget = $fs-E<gt>B<dir_list> 

=over

=back

=head2 widget = $fs-E<gt>B<file_list> 

=over

=back

=head2 localized file name = $filesel-E<gt>B<get_filename> 

=over

=back

=head2 $filesel-E<gt>B<set_filename> ($filename)

=over

=over

=item * $filename (localized file name) 

=back

=back

=head2 widget = $fs-E<gt>B<fileop_c_dir> 

=over

=back

=head2 widget = $fs-E<gt>B<fileop_del_file> 

=over

=back

=head2 widget = $fs-E<gt>B<fileop_dialog> 

=over

=back

=head2 widget = $fs-E<gt>B<fileop_entry> 

=over

=back

=head2 string = $fs-E<gt>B<fileop_file> 

=over

=back

=head2 widget = $fs-E<gt>B<fileop_ren_file> 

=over

=back

=head2 widget = $fs-E<gt>B<help_button> 

=over

=back

=head2 $filesel-E<gt>B<hide_fileop_buttons> 

=over

=back

=head2 widget = $fs-E<gt>B<history_menu> 

=over

=back

=head2 widget = $fs-E<gt>B<history_pulldown> 

=over

=back

=head2 widget = $fs-E<gt>B<main_vbox> 

=over

=back

=head2 widget = $fs-E<gt>B<ok_button> 

=over

=back

=head2 boolean = $filesel-E<gt>B<get_select_multiple> 

=over

=back

=head2 $filesel-E<gt>B<set_select_multiple> ($select_multiple)

=over

=over

=item * $select_multiple (boolean) 

=back

=back

=head2 widget = $fs-E<gt>B<selection_entry> 

=over

=back

=head2 widget = $fs-E<gt>B<selection_text> 

=over

=back

=head2 list = $filesel-E<gt>B<get_selections> 

=over

Returns the list of file name(s) selected.

=back

=head2 $filesel-E<gt>B<show_fileop_buttons> 

=over

=back


=head1 PROPERTIES

=over

=item 'filename' (string : readable / writable)

The currently selected filename

=item 'select-multiple' (boolean : readable / writable)

Whether to allow multiple files to be selected

=item 'show-fileops' (boolean : readable / writable)

Whether buttons for creating/manipulating files should be displayed

=back


=head1 ENUMS AND FLAGS

=head2 flags Gtk2::Gdk::EventMask

=over

=item * 'exposure-mask' / 'GDK_EXPOSURE_MASK'

=item * 'pointer-motion-mask' / 'GDK_POINTER_MOTION_MASK'

=item * 'pointer-motion-hint-mask' / 'GDK_POINTER_MOTION_HINT_MASK'

=item * 'button-motion-mask' / 'GDK_BUTTON_MOTION_MASK'

=item * 'button1-motion-mask' / 'GDK_BUTTON1_MOTION_MASK'

=item * 'button2-motion-mask' / 'GDK_BUTTON2_MOTION_MASK'

=item * 'button3-motion-mask' / 'GDK_BUTTON3_MOTION_MASK'

=item * 'button-press-mask' / 'GDK_BUTTON_PRESS_MASK'

=item * 'button-release-mask' / 'GDK_BUTTON_RELEASE_MASK'

=item * 'key-press-mask' / 'GDK_KEY_PRESS_MASK'

=item * 'key-release-mask' / 'GDK_KEY_RELEASE_MASK'

=item * 'enter-notify-mask' / 'GDK_ENTER_NOTIFY_MASK'

=item * 'leave-notify-mask' / 'GDK_LEAVE_NOTIFY_MASK'

=item * 'focus-change-mask' / 'GDK_FOCUS_CHANGE_MASK'

=item * 'structure-mask' / 'GDK_STRUCTURE_MASK'

=item * 'property-change-mask' / 'GDK_PROPERTY_CHANGE_MASK'

=item * 'visibility-notify-mask' / 'GDK_VISIBILITY_NOTIFY_MASK'

=item * 'proximity-in-mask' / 'GDK_PROXIMITY_IN_MASK'

=item * 'proximity-out-mask' / 'GDK_PROXIMITY_OUT_MASK'

=item * 'substructure-mask' / 'GDK_SUBSTRUCTURE_MASK'

=item * 'scroll-mask' / 'GDK_SCROLL_MASK'

=item * 'all-events-mask' / 'GDK_ALL_EVENTS_MASK'

=back



=head1 SEE ALSO

L<Gtk2>, L<Glib::Object>, L<Gtk2::Object>, L<Gtk2::Widget>, L<Gtk2::Container>, L<Gtk2::Bin>, L<Gtk2::Window>, L<Gtk2::Dialog>

=head1 COPYRIGHT

Copyright (C) 2003-2005 by the gtk2-perl team.

This software is licensed under the LGPL.  See L<Gtk2> for a full notice.


=cut

