Applied Parameters: None
This command is used to access the Find Text dialog, from where you can configure a search for specific text located in the current document, all text-based documents in the active project, all open text-based documents, or all text-based documents in a specified directory.
This command can be accessed from the Text Editor (or any coding-aware variant of the Text Editor), by:
- Choosing the Edit » Find command from the main menus.
- Clicking the button on the Standard toolbar.
- Using the Ctrl+F keyboard shorcut.
After launching the command, the Find Text dialog will appear. The dialog essentially operates in two modes, with functionality delivered courtesy of two tabs:
- Find - use the options on this tab to configure a search within the current document only. After clicking OK, the first instance of matching text found will be highlighted on the document.
- Find in Files - use the options on this tab to configure a search across all text-based documents in the active project, all open text-based documents, or all text-based documents in a specified directory. After clicking OK, all instances of matching text found in the files coming under the scope of the search, will be listed as entries in the Messages panel. Each message will reflect the source file, the line on which the searched text was found, the entire text on that line, and the character position within that line at which the searched text string starts.
- Each message in the Messages panel is in the form (x, y): <LineText>, where x is the character position on line y of the document.
- Files do not have to be open in order to search text using the Find in Files mode.
- When using the Find in Files mode, resulting found text can be cross-probed to, from the Messages panel entry - simply double-click on the message.
- See related options in the Find region, on the Text Editors - General page of the Preferences dialog.