Click above to get retro games delivered to your door ever month!

 cGetFile()             File selection standard DialogBox
--------------------------------------------------------------------------------

   Syntax:              cGetFile( <cFileMask>, <cTitle>,
                                      [<nDefaultMask>],
                                      [<cInitialDirecory>] )  --> <cFileName>

                        This function invokes the Windows default select
                        a file DialogBox.

   Parameters:

   <cFileMask>          A string that contains a default filename, or
                        a list of possible file types to select:

                        ? cGetFile( "Hello.prg", "Select a file" )

                        In this case "Hello.prg" is shown as the default
                        filename.

                        If you want to specify some different types of
                        files the following format must be used:

                        "DataBase | *.dbf |" + ;
                        "Index    | *.cdx |" + ;
                        "Bitmap   | *.bmp"

   <cTitle>             The title of the DialogBox. By default
                        "Select a file" is shown.

   <nDefaultMask>       An optional numeric value in case that
                        you want to start the DialogBox with a certain
                        file type selected (if you are using the multiple
                        file types format).

                        To request lately what was the file type selected,
                        you may use the function nGetFileFilter().

   <cInitialDirectory>  The initial directory where to start
                        looking for files. By default it uses ".\\"

   Returns:             A string with the name of the filename selected.

   Sample:              See IDE\\SOURCE for a lot of different samples.

   Source code:         SOURCE\\WINAPI\\GetFile.c

   See also:            nGetFileFilter()