
			   GETFILEM.LSP   Version 0.5
========================================================================================

     	Written By: David Rogillio
     	Date:       August 10, 1994

	David Rogillio
	815 Lonita St.
	Baton Rouge, La. 70815
	(504) 925-2646


	Permission to use, copy, modify, and distribute this software for any
	purpose and without fee is hereby granted. This copy is a simple preuse
	version, and has not been fully tested. It carries no warranties of any
	kind. The LISP and DCL files provided solely on an "as-is" basis. The
	use and responsibility of using these routines or any part of these routines
	lie solely on the user. 


	Some of the routines in the lisp file are adoptions of routines found in
	AutoCADs APPLOAD.LSP, and some of the layout of the dialogue box is an 
	adoption of the dlfmulti routine found in AutoCADs ACAD.DCL. Some 
	modifications have been made to these routines, but they still carry
	the AutoCAD disclaimer, and all AutoCADs copy rights.



     DESCRIPTION:

     An AutoLISP routine with a dialogue interface allowing users select
     multiple files. The Lisp routine must be able to find DOSLIB, which
     contains many ADS commands used by the lisp to do DOS commands.
     This program works similar to AutoCADs 'getfiled' command, but used
     for multi-select file selection. The file getfilem.dcl that accompanies 
     this lisp is the dialog interface for this lisp.

     The lisp program will also use about the same bit values as AutoCADs
     'getfiled' command, with some excptions.  The (bit 0) value '1'
     code which is used for new drawings, which this program should
     not be used for. Also, the typeit button was removed from the
     dialog description. 
     
     GETFILEM COMMAND USAGE & BIT VALUES
     -----------------------------------

     (getfilem "Title of Dialog Box:" "drv:" "\\startup\\directory" "def,ext,lsp" bit)

     Title of Dialog Box - The heading that appears in the top border of the dialog box.

     drv: - The drive letter (followed by a ":" colon) for the dialog box to start on.
                 If the drive letter is invalid or "" null string the lisp defaults to the
                 drive that is presently set in the DOS shell.

     \\startup\\directory - The directory path for the dialog box to start in.
                 If the directory is invalid or "" null string the lisp defaults to the
                 directory that is presently set as the working directory.

    def,ext,lsp - The patterns of the extensions (separated by a "," comma) you
                 wish to search as initial match pattern. If pattern is "" null the lisp
                 defaults to "*" and retrieves all files.

    bit (code/value) - Each bit code has a value associated with it and the final
                 bit value is the addition of all bit values added together. See
                 bit codes descriptions and values below.




    (bit 0) value = 1 - Bit 0 controls the available drives to the user.        
                        If on (set to 1) the drive popup list is disabled & only
                        the initial drive set when the command was called is valid.
                        If off (set to 0) the drive popup list is enabled & the user
                        may select from any available drive.

    (bit 1) value = 2 - Bit 1 controls the type it button in 'getfiled' and is not used
                        in this lisp so this bit doesn't change any settings if on (set to 2)
                        or off (set to 0).

    (bit 2) value = 4 - Bit 2 controls the available extension patterns to the user.        
                        If on (set to 4) the pattern edit box is disabled & only
                        the initial pattern or patterns set when the command was called  
                        are valid. If off (set to 0) the pattern edit box is enabled & 
                        the user may change the extension pattern search path.

    (bit 3) value = 8 - Bit 3 controls the list of files returned by the 'getfilem' command.
                        If on (set to 8) the full path name of each file is returned.
                        If off (set to 0) only the file names with extension of the files 
                        selected are returned.

	My thanks to Robert McNeel & Associates, developers of the DOSLIB ADS DOS Library.
	Without the ADS routines found in this library I would have never been able to write
	this LISP. DOSLIB adds the commands necessary for file and directory manipulation
	from inside AutoLISP without shelling out of AutoCAD.  The routines found in DOSLIB
	also have many more powerful uses not shown in this program.


DOSLIB found in library

*********************************************************************************************
                               *   DOSLIB Version 2.0     *
			       *     ADS DOS Library      *
			       *  Programmer's Reference  *
                               ****************************


		*******     disclaimer notice found in DOSLIB    *******

DOSLIB Version 2.0
Copyright c 1992-1994, Robert McNeel & Associates
3670 Woodland Park Avenue North
Seattle, WA  98103
(206) 545-7000

Permission to use, copy, modify, and distribute this software for any
purpose and without fee is hereby granted, provided that the above
copyright notice appears in all copies and that both that copyright
notice and this permission notice appear in all supporting documentation.

Robert McNeel & Associates makes no warranty, including but not limited
to any implied warranties of merchantability or fitness for a particular
purpose, regarding the software and accompanying materials.  The software
and accompanying materials are provided solely on an "as-is" basis.

In no event shall Robert McNeel & Associates be liable to any special,
collateral, incidental, or consequential damages in connection with or
arising out of the use of the software or accompanying materials.

* DOSLIB is a trademark of Robert McNeel & Associates.
* AutoCAD, AutoLISP and ADS are registered trademarks of Autodesk, Inc.
* MS-DOS and Windows are registered trademarks of Microsoft Corporation.
* All other brands and product names are trademarks or registered
  trademarks of their respective holders.


*****************************************************************************************


			**** NOTICE ****

	This program has not been completely tested and is a preuse
	version.  This means it seems to work in the instances that
	I have used it, but it in no way means it will work in all
	cases, on all platforms, or even at all. If you do have problems
	or would like a more polished version as it becomes available
	please let me know.
				David Rogillio
				CompuServ 75023,1441
