## Documentation

Table of Contents
Class Inheritance Tree
Widget Screenshots
Package groups

1.     -----------------------------------------------------------------------

2.     --               GtkAda - Ada95 binding for Gtk+/Gnome               --

3.     --                                                                   --

4.     --      Copyright (C) 2000 E. Briot, J. Brobecker and A. Charlet     --

5.     --                Copyright (C) 2000-2003 ACT-Europe                 --

6.     --                                                                   --

7.     -- This library is free software; you can redistribute it and/or     --

8.     -- modify it under the terms of the GNU General Public               --

9.     -- License as published by the Free Software Foundation; either      --

10.     -- version 2 of the License, or (at your option) any later version.  --

11.     --                                                                   --

12.     -- This library is distributed in the hope that it will be useful,   --

13.     -- but WITHOUT ANY WARRANTY; without even the implied warranty of    --

14.     -- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU --

15.     -- General Public License for more details.                          --

16.     --                                                                   --

17.     -- You should have received a copy of the GNU General Public         --

18.     -- License along with this library; if not, write to the             --

19.     -- Free Software Foundation, Inc., 59 Temple Place - Suite 330,      --

20.     -- Boston, MA 02111-1307, USA.                                       --

21.     --                                                                   --

22.     -- As a special exception, if other files instantiate generics from  --

23.     -- this unit, or you link this unit with other files to produce an   --

24.     -- executable, this  unit  does not  by itself cause  the resulting  --

25.     -- executable to be covered by the GNU General Public License. This  --

26.     -- exception does not however invalidate any other reasons why the   --

27.     -- executable file  might be covered by the  GNU Public License.     --

28.     -----------------------------------------------------------------------

30.     --  <description>

31.     --  This package provides a high level support for creating file selection

32.     --  dialogs by handling the signals internally.

33.     --  </description>

34.     --  <group>Selectors</group>

36.     with GlibTo API docTo specTo body;

38.     package Gtkada.File_SelectionTo API docTo specTo body is

40.        function File_Selection_DialogTo API docTo body

41.          (Title       : Glib.UTF8_StringTo API docTo spec := "Select File";

42.           Default_Dir : String := "";

43.           Dir_Only    : Boolean := False;

44.           Must_Exist  : Boolean := False) return String;

45.        --  Open a file selection dialog and make it modal.

46.        --  Return when either the Cancel button is clicked or when a file is

47.        --  selected.

48.        --  Default_Dir is the directory to display in dialog initially. Note that

49.        --  it must end with a directory separator ('/' or '\', depending on your

50.        --  system). You can use GNAT.Os_Lib.Directory_Separator to get the correct

51.        --  value for your system.

52.        --  If Must_Exist is True, then the file (or directory if Dir_Only is True)

53.        --  must exist.

54.        --  If Dir_Only is True, then the dialog is modified so that the user can

55.        --  only choose a directory name, but not a file name.

56.        --  The value returned is the name of the file selected, or "" if none.

58.     end Gtkada.File_SelectionTo API docTo specTo body;