GETFNAME    TYPE=OPEN_MODE:
                   PROMPT_STRING:
                   FILE_NAME:
                   FILE_PATH:
                   FILTER_STRING

• The TYPE parameter defines the "mode" and the "dialog type". That is, it tells Windows how to handle the interaction with the user. We'll defened that below.
  
  
• The PROMPT_STRING will appear in the title of the Windows open dialog box. You can use a literal or a string variable for this one.
  
  
• The FILE_NAME is just that. If you pre-load the name, even with a mask like *.TXT, then only files matching that name or mask will be shown. On return you get the file name that the user clicked.
  
  
• The FILE_PATH is just that. You can enter any path that you want and that's where the open dialog starts. The user can still navigate to other paths as you'd expect. On return you get the final path to the file that the user selected.
  
  
• FILTER_STRING is a special case and only goes with certain open dialog types. We'll talk about those next.

• If user CANCELs, OVER is set.
  
  
• If NOT OVER:
  • File name is stored in the name variable
  • The path is stored in the path variable.
    (Path ends with a backslash).

• In OPEN mode the user selects a file and control immediately returns to your program.
• In PREP mode Windows will see if the selected filename already exists and, if so, it will ask the "overwrite" question. If the user answers NO to "overwrite" then control stays in the open dialog so the user can try again.

    OPEN_TYPE  FORM        2
               MOVE        "1" to OPEN_TYPE
               GETFNAME    TYPE=OPEN_TYPE

MODE	DIALOG TYPE
OPEN	Standard open dialog
PREP	Standard prep dialog
TYPE=1	Standard open dialog
TYPE=2	Standard prep dialog
TYPE=17	Open dialog with user filter
TYPE=18	Prep dialog with user filter.
TYPE=33	Open dialog with multi-select feature.
TYPE=34	Prep dialog with multi-select feature.
TYPE=49	Open dialog with filter and multi-select.
TYPE=50	Prep dialog with filter and multi-select.

3. When {mode} identifies employment of a user filter, the string format requires {info} and {filter} pairs to follow the extension which are then passed to the Open or Prep dialogs. The {type} string format is as follows:
      {ext}[,{info1},{filter1}[,{info2},{filter2}]...]
Where:

• {ext} Identifies the default extension used when no name filtering is provided.
• {info1} First information/comment string presented and associated with the file filter which follows it.
• {filter1} First file filter which can be one or more files separated by the semicolon character. The file names can be specific or partial names and include wildcard characters. When a user selects the {info1} identifier, only those files which conform to the filter appear in the dialog presentation window.

• You can use a variable or a literlal numeric parameter for the GETFNAME. For type 1 you can use the literal OPEN and for type 2 you can use PREP. Example code might include:

  OPEN_TYPE  FORM   2
             MOVE    "1",OPEN_TYPE
             GETFNAME  TYPE=OPEN_TYPE ....
                or
             GETFNAME  TYPE=1 ....
                or
             GETFNAME  TYPE=OPEN ....
  

  
  
• The numeric types are grouped in pairs for OPEN and PREP dialogs:

       1 = open      2 = prep
      17 = open     18 = prep
      33 = open     34 = prep
      49 = open     50 = prep
  

• The numeric types are grouped broadly by MULTI-SELECT capability.
  
  What multi-select does is to allow the user to click more than one file, drag a box around a group of files, use CTRL-click and SHIFT-click. When the GETFNAME operation returns, multi selected files are returned as a comma-delimited list of files (without path) in FILE_NAME.

       1,  2, 17 and 18   do NOT allow multi-select
      33, 34, 49 and 50   DO allow multi-select
  

• Two groups of the numeric types allow FILTERS to be used. (Filters are described below)

      17  Open with filter
      18  Prep with filter
      49  Open with filter and multi-select
      50  Prep with filter and multi-select
  

• This entire filter string can be a literal or can be a string variable.
• The values are comma delimited and don't need any quotes within the string.
• There can be multiple "filters" elements in the string but they're delimited by semi-colons.

• {ext} Identifies the default extension used when no name filtering is provided. That means that if you don't give any other information in the filter string, this is the file extent ion that will be displayed. If you are going to use filter pairs, you can just ignore this parameter and use a "," as a place holder. For example:
        ,pictures,*.jpg;*.tif
  
  
• {info1},{filter} work in pairs. The info string is just text describing what the filter represents. For example the pair could be
        picture types allowed,*.jpg;*.tif;*.bmp
  In that example, the description will be the entire string picture types allowed. Note that there are no quotes.
  
  The actual filter is *.jpg;*.tif;*.bmp. Again, these are not in quotes... they're just a string. Note that the three types are separated by semi-colons.
  
  The actual filters may be wild card masks such as CWV*.TXT.
  
  
• SPECIAL NOTE:
  To make the filter work, you MUST provide a default value in the FILENAME field of the GETFNAME. That doesn't sound reasonable, but if you don't the filter will be ignored and you'll get everything. Interestingly, the value can be a SPACE. What it can NOT be is NUL.
  
  If you include an actual name in the FILENAME field, that will be shown as the default filename in the dialog box... even if it is a non-existant file!

       PACK        FILTER_STRING WITH "":
                      ",Picture Files,*.tif;*.jpg;*.bmp":
                      ",BGT Text File,*.txt":
                      ",Source code,*.pls;*.plf":
                      ",Programs,*.plc;*.exe"
					  
       MOVE        " ",FILE_NAME             ;Insure it's not NUL
	  
       GETFNAME    TYPE=17:                  ;open dialog, with filter
                   "Select a file":          ;prompt
                   FILE_NAME:                ;file name return string
                   "C:\MMCC-WWW\BARGAINT":   ;starting path to look in          
                   FILTER_STRING

• WWW-ANLZ was started as a file chaser to find all HTML files in a given directory structure.
• GET-TREE is an external routine to chase all folders within a given path.
• GET-DIR is an external routine which gets the list of files within a directory.