DOWNLOAD
To view this script, click the button below. Your browser should show you the script in your browser window. Copy and paste that script into ToolBook.

View Now
 


FILE FUNCTION: fileFile()

Add-on OpenScript Function - should work in version 6 and higher of ToolBook

  Syntax

findFile(<filename>,<drives>,<doStop>,<hGlass>)

  Parameters <filename>
The name of the file you are searching for, including the extension. No wild card characters permitted.

<drives>
A comma separated list of drive letters or drive type identifiers. If NULL, drive C will be searched.
   A through Z: Specifies the specific drive letter to search
   CD-ROM: Will search all CD-ROM drives
   FIXED: Will search all hard drives
   REMOVABLE: Will search all removable media (ie: Floppy Drive)
   NETWORK: Will search all mapped network drives

<doStop>
True or False: Indicates if the search should stop after first find. If NULL, the default of True is used.

<hGlass>
True or False: Indicates if the hour glass mouse cursor should be shown during the searching process. If NULL, the default of False is used.

    Returns Returns a comma separated list of files (complete with path) found by this searching process. Or, if an error occurs, one of the following error codes are returned instead.

-1 - FILE NOT FOUND
-2 - FILE NAME NOT VALID
-3 - DRIVE LETTERS INVALID
-4 - DOSTOP PARAMETER NOT VALID
-5 - HGLASS PARAMETER NOT VALID

    Sample myFiles= findFile("DENNY.TXT","C,CD-ROM",TRUE,FALSE)