Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                             ◄Up► ◄Contents► ◄Index► ◄Back►
─────PWB Extensions─────────────────────────────────────────────────────────
 
  Syntax:  void SelectFiles( PCMD List, char far *Title,
                             char far *ListLabel, char far *Pattern,
                             flagType fQualify, int idHelp );
 
  Returns: True if the user chooses OK, false if the user chooses
           Cancel.
 
  See:     ForFile, GetListEntry, NameToFunc, ScanList, SelectFile
           ◄PWB Mgreplist Macro►
 
     SelectFiles displays the standard PWB dialog box that allows the
     user to select a list of files and wildcards.
 
     This is the same dialog box associated with the Files button in
     some dialog boxes. To see an example of this dialog box, choose the
     Merge command from the File menu and choose the Files button in the
     Merge File dialog box.
 
     SelectFiles creates or modifies a list (a text macro such as
     Mgreplist) that contains a list of filenames and wildcards. The
     resulting list can then be processed with ScanList. Use
     GetListEntry to process individual items on the list. The items can
     be processed by ForFile to take some action on each file or
     wildcard.
 
     Argument       Description
 
     <List>         PCMD of the list to be created or modified. To
                    obtain the PCMD for an existing list macro, call
                    GetListHandle.
 
     <Title>        Title for the dialog box.
 
     <ListLabel>    Label for the lower list box in which the selected
                    files are listed.
 
     <Pattern>      Default filename or wildcard to appear in the File
                    Name text box. The files that are displayed in the
                    list box are filtered by the specified pattern.
 
     <fQualify>     If TRUE, wildcard patterns that are added to the
                    list are fully qualified, resulting in fully
                    qualified file specifications when processed by
                    ScanList or GetListEntry.
 
                    If FALSE, wildcard patterns are unchanged, resulting
                    in filenames without a path or drive.
 
     <idHelp>       ID number of the PWB Help topic to be displayed when
                    the user chooses the Help button. Specify 0 for no
                    Help button.
                    See: ◄Using Help IDs►
                                    -♦-