The Find/Replace dialog is used to find and/or replace text in the current edit page.
The Find: field is where to enter the string you wish to search for. If a word or phrase was selected in the current edit page when the Find/Replace dialog was opened, that word or phrase will automatically be entered in the Find: field. The Find: field remembers the last ten unique items entered into it. To select a previous entry, click the Find: field’s down arrow and choose it from the drop-down list.
The Origin group controls where the search begins from; from the Top or from the Cursor. Selecting Top starts the search from the top of the file (or from the top of the selection if Selection is set in the Scope group). Selecting Cursor starts the search from the current cursor (caret) position in the file. Note: The “Top” option changes to “Bottom” if the Direction group is set to Backward.
The Scope group controls the range of the search: the Entire File or just the current Selection. This is a convenient way to perform a find, or a find and replace, within only a limited region of the file. The Scope group is set to Entire File by default and is disabled unless a selection is made prior to opening the Find/Replace dialog. The Scope group is set to Selection automatically if a selection of at least one entire line is made prior to opening the Find/Replace dialog.
The Direction group controls the direction of the search; in the Forward direction (towards the bottom of the file) or the Backward direction (towards the top of the file). If set to Backward, the Origin group’s first option changes from “Top” to “Bottom,” meaning the origin is from the bottom of the file or selection.
The Find button starts the search process based on all the settings in the Find/Replace dialog. If text in the edit page matches the criteria, it is selected and moved into view, and then the Find button changes to a Find Next button. Additional clicks on the Find Next button result in the next matching text being selected and shown. You can also use the F3 key, with or without the Find/Replace dialog open, to perform more Find Next searches.
The Replace button is enabled if a string was entered in the Replace: field and a matching string was found (via Find button or F3). Clicking Replace, or pressing F4 with or without the Find/Replace dialog open, causes the currently matched string in the file to be replaced with the string in the Replace: field. After a replace, the Find Next button, or F3 key, needs to be used before Replace becomes available again. Holding the Control (Ctrl) key down changes the Replace button to “Replace/Find” and clicking it, or pressing Ctrl+F4 with or without the Find/Replace dialog open, causes the currently matched string to be replaced and then another Find Next operation to be performed immediately.
The Replace All button is enabled if a string was entered in the Replace: field. Clicking on Replace All causes every matching string in the file to be found and replaced with the string in the Replace field, the dialog closes, and a results dialog appears indicating the number of occurrences found and replaced.
Propeller Help Version 1.1
Copyright © Parallax Inc.
5/13/2009