Search Quick Reference
Scope of searching
The search window can work in three different ways, it can search the current file, all open
files, or the entire project. The scope of the search is set by the window from which the
search menu was selected, and is as follows:
The Toolbar and Build windows will
search the entire project.
The Project window will search all open files (ones which
have editor tabs)
The Editor window will search the all open files (The
Find button and the
Find menu searches the current file)
The Quick-Link window will search the current file.
Once the search window is open, you can specify the type of search to be carried out manually
by selecting the scope in the top gadget. Certain gadgets may then be available, depending of
which search type you have selected.
back to the top
We shall cover the functions available while searching the current file in this first section.
The second section covers the searching of open files and the entire
To make searching easier, the search window will automatically detect if there is
a marked block of text in the editor, and insert it into the string gadget for you
when the window opens. Multiple lines cannot be inserted, and in this case, the
text inserted will finish at the end of the first line. It will also be truncated
to the maximum length allowed in string gadgets if it is too long. Double or
Triple clicking text items will highlight words and lines easily for you prior to
opening the search window.
When entering text into string gadgets, you have to confirm the entry by pressing <Return>
or <Enter> after the text is entered, this is a requirement of the operating system, and
allows the user to change or even cancel text entry by simply navigating away from the string
Navigation via the keyboard has also been improved, and by pressing "TAB" will activate
the search string gadget for you. Further presses of TAB will activate each gadget in turn.
When searching the current file, the requester will look like this. The string that you are
searching for should be entered into the top string gadget. You can select whether you want
this search to match exactly with what you supplied. or whether to ignore the case of any
letters in the string.
There is also an option to replace what was found with something else by ticking the checkbox
in the "Replace attributes" section. You should then enter the string you
want to replace with in the next string gadget.
The bank of buttons at the bottom will then allow you to continue with carrying out the
"Search" simply finds the first occurrence of the supplied string
from the current cursor position.
"Replace Next " will be enabled if you have supplied a string in
the second gadget, and this will replace the next occurrence.
"Replace All" will, again if you have supplied a string, replace
all occurrences of the string found with the one supplied.
"From Top" will start the search from the top of the file instead
of at the current cursor position.
"Next" finds the next occurrence of the string.
"Prev" finds the previous occurrence of the string.
This second section covers searching all open files and the entire project. The process is the
same for both types of search, except the range of the search is limited accordingly.
You will notice that the search requester looks slightly different from the last time, where we
searched only the current file. This time there is the addition of a list at the bottom. This is
where the results of the action to be carried out will be shown.
The ability to replace one string with another is still possible, but now the scope of that change
is expanded to the entire project or all open files. Open files have a corresponding
"Tab" in the editor, not just the file
that is currently shown. The open files are also highlighted with a white background in the
Project window list.
This time, because the scope of the search (with optional replace) has changed to a much broader
range, the "Replace Next " button is not available.
The "Search" button will find all occurrences of the string supplied
in either all of the open files or the entire project, depending on what was specified.
The "Replace All" button will not only find all occurrences of the
string within the scope of the search, but will replace it with the string supplied.
Finally clicking "Search" will start the process of searching the
required files. Depending on how many files are to be looked in to, this may take a while.
Luckily the search will run separately from the rest of the system, so you can continue to
work while it does, and even click on items in the search results while the search is still
In either case, once the search has finished, the list will contain the results of any actions
carried out. In our example project, searching the project for "Welcome"
with case-sensitivity turned off gives us the results below.