[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 cGetFile( cFileMask, cTitle, nDefaultMask, cInitDir, lSave )-> <cFileName>
------------------------------------------------------------------------------


 PARAMETER:

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

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

                 +--------------------------------------+
                 |  /* Show 'HELLO.C' */                |
                 |                                      |
                 | cGetFile( "Hello.prg","Select File") |
                 |                                      |
                 +--------------------------------------+


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

                 +--------------------------------------+
                 | /* Select FileTypes       */         |
                 |                                      |
                 | cDir := "DataBase | *.DBF" + ;       |
                 |         "Index    | *.CDX" + ;       |
                 |         "Bitmap   | *.BMP"           |
                 |                                      |
                 | cGetFile( cDir, "Select File", 2 )   |
                 +--------------------------------------+



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

  <nDefaultMask> is 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). In the
                 above example, it will be the second mask ( *.CDX )

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

  <cInitDir>     Is the initial directory. This is very handy to start
                 the file search in a default directory.

  <lSave>        If this Flag is TRUE ( default is FALSE ), a
                 SAVEFILENAME dialog box instead of the OPENFILEAME box
                 is created.


 RETURNS:

  <cFileName> is a string with the name of the filename selected, or an
  empty string if the cancel button or ESC was pressed.   


 SOURCE:

  SOURCE\WINAPI\GETFILE.C



See Also: nGetFileFilter
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson