Go to Glossary Search VisualAge C++ Help Go to VisualAge C++ Help Home Page Go to WWW VisualAge C++ Site

Find and Replace - Options

This dialog box lets you specify further options to the find and replace operation.

Select the scope of your search by selecting one of the three search range options described below:
All documents Look for the search item in all documents (files) currently open in the Editor.
Current document Look for the search item only in the current document (file) view.
Selection, if exists look for the search item only in the marked text selection of the current file view. If no text is selected, the find operation tries to find the search item in the current file view.

Columns allows you to further restrict the scope of your search to certain columns only. To set the column boundaries of your text search, enter a value for the following fields:

Between Indicates the first column search operations apply to.
And Indicates the last column search operations apply to.
Select one of these options to specify whether you want to find character strings occurring before or after the current cursor position.
Forward Locates the next occurrence in the current file of the character string you typed in the Find field.
Backward Locates the previous occurrence in the current file of the character string you typed in the Find field.
Mark found text marks the text found by the Find feature. Any previously marked text will no longer be marked.
Shift data on replace uses your replacement text to replace only the search item. If the replacement text has a different length than the search item, other text following the search item shifts either left or right as needed to accomodate the length of the replacement text. The length of the line containing the search item changes if the search item and the replacement text are of different lengths.

If you do not select this option, and the length of your replacement text is (when compared to the length of the search item):

  • longer, the replacement text overwrites the search item and text following the search item as needed to place the entire replacement text into your file. The overall length of the line is not changed.
  • shorter, the search item is replaced with the replacement text and trailing spaces to a total length
    of the orginal search item. The overall length of the line is not changed.
Cancel after find closes the Find and Replace dialog box after the search item has been found. If you do not select this check box, the Find and Replace dialog box remains open until you close it by clicking the Cancel button.
Update find list will record this find operation in the find event history log.
Find list maximum size changes the number of Find entries that can be stored in the find events history log. To change the size of the find events history log, type the desired number directly into the Find list maximum size number entry field, or click on the up or down arrows to change the value in this field. You can find the events history log in the macros directory.
Note: This file is found in the /usr/vatools/macros directory.
This file is found in the product_installation\macros directory.
OK accepts the options set in the Find and Replace - Options dialog box, and returns you to the Find and Replace dialog box.
Defaults resets the options set in the Find and Replace - Options dialog box to the Editor installation-time settings.
Cancel ignores any changes to settings, and returns you to the Find and Replace dialog box.