Copyright: Find in Files Help v1.0   Tue Dec 01 14:06:07 1998


FIND IN FILES V1.0 FOR LOTUS® WORDPRO – ©1998 BY TDK

 Find in Files is a Lotus WordPro script that searches through all WordPro files across multiple folders/drives for a text string. Files containing the text can be opened in WordPro and listed in a new document.

The search is a 3-step process :

Step 1 is where all program options are set : where the search is conducted (folders and drives), how the search is carried out (the text being searched for, match upper/lower case, etc.), and what to search (file types).

Step 2 is the actual search process itself. A dialog box monitors the search progress and provides a Cancel button to allow cancellation of lengthy searches.

Step 3 is where the results of the search are presented. All files containing the search text specified in Step 1 are presented in a list. Options are available to open the files selected in the list and to generate a listing of all the files in a new WordPro document.

Additional Topics :

Setting Search Options

Monitoring Search Progress

Processing the Results

Version Information


FIND IN FILES – SETTING SEARCH OPTIONS

Click on any item in the window below for more information.

Additional Topics :

Overview

Monitoring Search Progress

Processing the Results

Version Information


FIND IN FILES – MONITORING SEARCH PROGRESS

Click on any item in the window below for more information.

Additional Topics :

Overview

Setting Search Options

Processing the Results

Version Information


FIND IN FILES – PROCESSING THE RESULTS

Click on any item in the window below for more information.

Additional Topics :

Overview

Setting Search Options

Monitoring Search Progress

Version Information


FIND IN FILES – VERSION INFORMATION

VERSION INFORMATION

•	Find in Files requires WordPro 97 (or later) and 32-bit Windows. It will not run under previous versions of WordPro nor will it run under OS/2 or 16-bit Windows.

•	WordPro stresses the video drivers and Find in Files stresses WordPro. Therefore, up-to-date Windows video drivers are essential. While every effort has been made to make this program as robust as possible, exercise caution when opening or closing a large number of files in succession.

•	The Cancel button in the Progress dialog box may be "sticky" and have a delayed response. Click a few times if necessary to cancel the script, or press the <Esc> key instead.

•	Files that are open and invisible (e.g., Application startup scripts) will not be searched. However, these files may be included in the search if they are first opened normally in WordPro.

•	Document open scripts are not run when a file is opened from the Results list.

•	WordPro SmartMasters are opened in edit mode and not as new document templates.

•	Invisible and system folders, as well as 0-byte files, are not scanned.

•	Due to a WordPro bug, plain-text files containing TABLE OF CONTENTS as the first line will not be opened.

•	Due to a WordPro bug, graphics in the "Browse for Folder" window become corrupted after the window is invoked multiple times. Only the graphics are affected; the window itself remains fully functional.

•	On some systems, opening a large number of files may cause font mapping problems in WordPro. Although the fonts used in a particular document may actually be present, WordPro will consider them unavailable and substitute an alternate font. Closing multiple open documents in WordPro and then re-opening the particular document where fonts are being substituted will usually clear up the problem.

VERSION HISTORY

Version 1.0 (Dec. 1998)

First public release.

Betas 1 - ReallyBigNumber (July-Dec. 1998)

A continuing work in progress. Lots of features were added, bugs fixed, and WordPro bugs worked around.

Additional Topics :

Overview

Setting Search Options

Monitoring Search Progress

Processing the Results


FOLDER BUTTON

Instead of typing in a folder name, clicking this button (or pressing Alt+F) lets you browse for the folder where Find in Files will begin it's search.


FOLDER TEXTBOX

Provides a space to type in the starting folder where Find in Files begins it's search.

Note :

• The trailing backslash is optional.

• Entering a single letter will match the root folder of a drive if it exists.

• The drive letter is optional; if omitted, a leading backslash is required and the active drive will be used.

• Enclosing the folder name in quotes is also optional (for folder names containing spaces).

• The initial folder is set to WordPro's default document folder.

• If a nonexistent folder is entered into the textbox, the starting folder will be reset to C:\ before the search begins.


INCLUDE SUBFOLDERS OPTION

If checked, all folders located below the starting folder will also be searched. Folders that are marked as hidden or system folders will not be searched, however. This option is disabled when the All Local Hard Drives option is checked.


ALL LOCAL HARD DRIVES OPTION

If checked, all visible, non-system folders on all fixed disks will be included in the search; network drives, CD-ROMS, and other removable media will be omitted from the search.

This can be a lengthy operation, but the search may be canceled at any point during its progess.


SEARCH LOCATION

A group of options specifying where Find in Files will search for any WordPro files that may contain a user-specified text string.


SEARCH FOR

A group of options specifying how Find in Files scan the text of any WordPro files it finds.


FILE TYPES

A group of options specifying the types of files that Find in Files will include in the search.


SEARCH TEXTBOX

Type in the text that you want Find in Files to search for. As each WordPro file is found, it will be opened invisibly and scanned for the text specified here. This search text is considered a literal string - what you type is exactly what will be searched for, with the following exceptions :

• Leaving the search string blank will find all files of the selected type(s) but ignore their contents. This also disables all  of the other Search For options.

• All ^ characters will be replaced with ^^, which is WordPro's method for matching the literal ^ character.

• ^T will match the <Tab> character, and ^R will match the <Enter> character.

• All other WordPro character sequences which include the ^ character will not perform the intended action.

• The search text is limited to a maximum of 255 characters.


MATCH CASE OPTION

If checked, all uppercase and lowercase letters must match exactly; that is, DOG and DOG will be considered a match but DOG and dog will not. Leaving this option unchecked ignores the case of any text found which matches the search string (dog and DOG will be considered a match). This option is disabled if the search text is blank.


WHOLE WORDS ONLY OPTION

If checked, the search text must not be contained within a larger string of text within the file. As an example, with this option enabled, dog and dogged wouldn't be considered a match. Leave this option unchecked if you want to find a string of text located at any place within a file. This option is disabled if the search text is blank.


SCAN DESCRIPTION AND KEYWORDS OPTION

If checked, and if LWP or MWP file types are included in the search, then Find in Files also scans within the document description and keywords for the search string. Any carriage return and line feed characters in the document description are ignored in the comparison. This option is disabled if the search text is blank.

All WordPro documents contain a description and keywords separate from the main document text; these properties can be viewed from the standard WordPro menu by selecting File|Document Properties|Document...


LSS FILES

If checked, LSS (plaint-text LotusScript) files will be included in the search.


LWP FILES

If checked, LWP (WordPro document) files will be included in the search. This option is checked by default. If all file types are left unchecked then LWP files will be searched automatically.


MWP FILES

If checked, MWP (WordPro SmartMaster) files will be included in the search. Any MWP files opened from the Results List will be opened as editable documents and not as new document templates.


TXT FILES

If checked, TXT (plain-text) files will be included in the search.


OK BUTTON

Closes the Options dialog box, opens the Search Progress dialog box, and begins the search.


CANCEL BUTTON

Closes the Options dialog box, cancels the search, and returns control to WordPro.


HELP BUTTON

Displays this help topic in FindFile.hlp. Duh.


SEARCH RESULTS INFO

Displays the total number of files found containing the search string. If the search string isn't blank (i.e., files are located but not scanned for text) then the search string will also be displayed.


RESULTS LIST

Displays all of the files found in the search path that contained the search string. The file list is limited to a maximum of 10,000 entries. Any number of files can be selected, but the maximum number that can be opened is 50. Selected files will not be opened unless the Open Selected Files option is checked. Some useful mouse/key combinations for selecting files :

• Ctrl+Click toggles the selected status of any file

• Shift+Click extends the selection to the current file

• Ctrl+/ selects all files in the list


FILE PROPERTIES INFO

Displays the file properties for the filename that currently has the focus in the Results List. File attributes may be a combination of Normal, Archive, Read-Only, or Hidden.

Multiple filenames may be selected in the Results List but only one filename will have the focus - indicated by a dotted line surrounding the filename.


OPEN SELECTED FILES OPTION

If checked, files (up to a maximum of 50) that are selected in the Results List will be opened in WordPro after clicking the OK button. This option remains disabled until one or more files have been selected in the list. This option must be checked to open any selected files


SKIP AUTO-RUNNING FILES OPTION

If checked, any LWP or MWP files selcted in the Results List that contain document greetings, "must-run" startup scripts, or update-on-load powerfields and document fields will not be opened. This option remains disabled until the Open Selected Files option has been checked.

Skipping files is normally not necessary but the option is provided as an added safety measure. Documents that are self-modifying may cause unpredictable behavior when they are opened by Find in Files. Note : Document Open scripts are always bypassed except when they are set to "must-run" by the document's original editor.


LIST FILES IN NEW DOCUMENT OPTION

If checked, ALL files in the Results List are listed in a new WordPro document. Files don't have to be selected to generate a listing.

Note : Selected files are opened before a listing is created so if an error occurs while opening any files - due to low memory or resources, for example - then the file listing will not be generated.


OK BUTTON

Opens the selected files and creates a file listing if those options are checked. Otherwise, control is returned to WordPro (equivalent to clicking the Cancel button).


CANCEL BUTTON

Cancels the opening or listing of files and returns control to WordPro. If Find in Files is in the process of opening files (the OK button was already pressed) - then this button cancels the opening of any additional files.


HELP BUTTON

Displays this help topic in FindFile.hlp. Duh.


MAXIMIZE / RESTORE ICON

Toggles the size of the Results dialog box between maximized and restored. The dialog box can also be resized by dragging it's window border with the mouse.


CURRENT FOLDER

Displays the name of the folder currently being searched.


CURRENT FILE

Displays the name of the file currently being scanned for the search text. If the search text specified in the Options dialog box is blank, then all files will be displayed as they are found.


FOLDER COUNT

Displays a running count of the number of folders that have been searched thus far. Note that Hidden and System folders are never searched.


TOTAL FILE COUNT

Displays a running count of the number of files of the type(s) specified in the Options dialog box that have been found thus far.


MATCHING FILE COUNT

Displays a running count of the number of files of the type(s) specified in the Options dialog box that contain the search string specified in the Options dialog box.


CANCEL BUTTON

Cancels a search in progress (as do the <Enter> and <Esc> keys) after user confirmation. If any file matches have been found up to that point then the partial results will be displayed in the Results dialog box.


RESULTS DIALOG BOX CAPTION

The dialog's caption will display a count of the number of files in the Results List that are currently selected. After the OK button is pressed, and while any files are being opened, the dialog's caption will be used to display status and error information.


NEW SEARCH BUTTON

Opens the selected files and creates a file listing if those options are checked. Then begins another search by opening the Options dialog box with the same settings used previously (equivalent to clicking OK and beginning a new search).