Replace text in the current document

Use the Find/Replace command to find and replace some specified text in the current document.

For this task, a document is any one of the several screens and worksheets that make up your project. If you want to search the tags database, use the filter tools in the Project Tags Datasheet View. For more information, see Sort or filter the rows in a worksheet.

There is no option to replace all occurrences of the specified text in your entire project, because it cannot be undone.

When you create a new project, a search database is also created for it. This database contains an index of every document in your project — that is, every project screen, script worksheet, task worksheet, tags datasheet, and so on — and it allows you to quickly find all occurrences of the specified text. Each time you edit and save a document, the search database is also updated.

To replace text in the current document:

1. Make sure the document that you want to search is open in the Screen/Worksheet Editor. If more than one document is open, click the tab of the document you want in order to bring it to the front.

   It is now the "current document".

2. On the ribbon, go to the Home tab, and then in the Clipboard group, select Find/Replace.

   The Find/Replace dialog box is displayed.

3. In the Find/Replace dialog box, select the Document Replace tab.

   The Document Replace tab of the dialog box is displayed.

   

   Whenever you use the Find/Replace command, it synchronizes the search database with the current state of the project. That synchronization is shown as a progress bar in the dialog box, immediately after the dialog box is displayed. The synchronization should be finished quickly, but in some cases — for example, if you are using the command for the first time in a large, existing project — it will take more time. You can proceed with finding text before the synchronization is finished, but if you do, the results might be inaccurate or incomplete.

4. In the Find What box, type or select the text that you want to find.

   Previous texts are saved in the list. To see the list, click the down arrow on the right.

5. In the Replace With box, type or select the text that will replace the found text.

   Previous texts are saved in the list. To see the list, click the down arrow on the right.

6. To find and replace the specified text one occurrence at a time, do the following.

   (This works only for script and task worksheets, not for project screens.)

   1. Select Find Next.

      If the text is found, it is highlighted in the document. If the text is not found, a message is displayed to notify you of that.

   2. To replace the highlighted text, select Replace.

      The text is replaced, and then the next occurrence (if any) is highlighted.

   3. To skip the highlighted text and find the next, select Find Next.

   When it reaches the end of the document, it starts over from the beginning.

7. To find and replace all occurrences of the specified text, select Replace All.

   If the text is found, it is replaced and then the results are displayed in the Find Results tab of the Output window, in the development environment. If the text is not found, a message is displayed to notify you of that.

To save your changes, save and close the document as you normally would.