The Project Manager Find (All) function searches for the specified string through event procedures and COBOL procedures belonging to the selected part of the project tree. The Find dialog, in the process of performing a find, is shown below:
Figure 5.15 The Find dialog window
The Find dialog is made up of three panes: the Control pane, the Target pane, and the Result pane. The contents of these panes are described below.
Control Pane
The control pane provides the functions for specifying the type and range of the Find and for controlling the Find operation. You specify the find range and method of displaying results before you start the Find operation.
Currently there is only one type of find supported - searching for text - so the selection is disabled. This will be expanded in future releases.
The drop down list shows the name of the project being searched. This field is disabled.
Check this box to have Find search objects that are on branches of the selected object in the project tree.
Select this box if you only want to search objects that are on branches of the selected object and not the selected object. The check box is disabled if "Includes children of the selected object" is not selected.
Select this button if you want Find to stop each time it makes a find.
Select this button if you want Find to search through the whole range, displaying results in the Result pane.
The Find button initiates the Find operation, locating the first string that matches the "Find what" string. The Find operation continues until all matching strings have been found or until the Cancel button is pushed.
The Close button closes the Find dialog. It is disabled during a Find operation.
The Find Next button is enabled when a Find one-by-one operation starts. It registers the result of the previous Find in the Result pane and searches for the next occurrence of the "Find what" string.
The Skip button is enabled when a Find one-by-one operation starts. It does NOT register the result of the previous Find in the Result pane and searches for the next occurrence of the "Find what" string.
The Find All button is enabled when a Find one-by-one operation starts. It causes the Find operation to search for all remaining occurrences of the "Find what" string and display the results in the Result pane.
The Cancel button is enabled when a Find one-by-one operation starts. It terminates the Find operation so that you can start a new Find operation or close the Find dialog.
Target Pane
Specify the string for which Find should search in the "Find what" combo box. You can either select a string from the drop down list of strings used in previous searches or enter a new string.
Check the "Match case" box if you only want to find strings that exactly match the case of the characters in the "Find what" string.
Result Pane
The Result pane lists the Find results that have not been skipped (using the Skip button). You can double-click on the position of a result item to see the text in the PowerCOBOL Editor or use the pop-up menu described below.
The results are listed with:
The location of the string in the project. Includes starting and ending row and column numbers.
Displays the contents of the line containing the "Find what" string.
Results Pane Pop-up Menu
If you right click on the position of a result item Find displays a pop-up menu with the following functions:
Displays the procedure containing the selected line in the PowerCOBOL Editor with the string highlighted.
Copies the string to the clipboard and deletes it from the selected location in the procedure.
Copies the string to the clipboard.
Deletes the string from the selected location in the procedure.
Note
These functions only work if you are using the PowerCOBOL Editor.
Caution
Updates to procedures after a Find operation has been executed may invalidate the Find result positions so be sure you have the correct text selected before using these operations.
