Status: Validated

Searching (Find/Replace) Features

Desktop Studio lets you:


Find

To find a string inside the scope of the current Code Editor:

  • Select the desired string in the Code Editor, right-click the selection and select the 'Find and replace\Find' context menu item (or hit the Ctrl+F key),
  • The following Find dialog is displayed:

You can:

  • Edit the search string with the Find what editbox (1) (or select one from the 'Find what' history),
  • Change the scope of the search via the Look in combobox (2):
    • Current Document search in the whole document,
    • Selection limits the search to the current selection (if not empty),
  • Change the find option using the Options checkboxes (3):
    • Match whole word only lets you search whole words rather than partial words,
    • Match case lets you perform a case-sensitive search,
    • Regular expression interprets the searched string as a regular expression rather than a literal string,
    • Search up lets you perform the search backwards rather than forwards.

Find the next occurrence

To find the next occurrence of the search string, click the Find next button:

  • The Code Editor automatically scrolls and selects the next occurrence found,
  • If the end of the document is reached, the search continues from the beginning of the document,
  • If no other occurrence is found, the 'Find next' button is disabled.


Find all occurrences

To search for all occurrences:

  • Click the Find all button,
  • The 'Find dialog' is closed and the search results are displayed in the Find Results Tool Window.


Quick Find

Quick find lets you search in the current Code Editor without opening the 'Find dialog':

  • Select the desired string in the Code Editor, right-click on the selection and select the Find and replace\Quick Find next context menu item (or hit the Ctrl+F3 key),
  • The Code Editor automatically scrolls and selects the next occurrence found.

Find the next occurrence

  • Hit the F3 key to find the next occurrence,
  • If the end of the document is reached, the search continues from the beginning of the document.


Find the previous occurrence

  • Hit the Shift+F3 key to find the previous occurrence,
  • If the start of the document is reached, the search continues from the end of the document.


Find in Files

To 'Find' a string outside the scope of the current Code Editor:

  • Select the desired string in the Code Editor, right-click the selection and select the 'Find and replace\Find in Files' context menu item (or hit the Ctrl+Shift+F key),
  • The following 'Find dialog' is displayed:

You can:

  • Edit the search string via the Find what editbox (1) (or select one from the Find what history),
  • Change the scope of the search via the Look in combobox (2):
    • Whole Solution extends the search to all project files,
    • All open Documents extends the search to all documents (script files and XML blocks) opened in the Editor Perspective,
    • Current Document limits the search to the current Code Editor,
  • Change the find options via the options checkboxes (3):
    • Match whole word only lets you search for whole words rather than partial words,
    • Match case lets you perform a case-sensitive search,
    • Regular expression interprets the searched string as a regular expression rather than a literal string,
    • Search in SDK files lets you include SDK files in your search.

Find all occurrences

You can choose to search for all occurrences of the search string:

  • Click on the Find all button
  • The 'Find dialog' is closed and the results of the search are displayed in the Find Results Tool Window


Find and Replace

To 'Find and Replace' a string outside of the current Code Editor:

  • Select the desired string in the Code Editor, right-click the selection and select the 'Find and replace\Replace in Files' context menu item (or hit the Ctrl+H key),
  • The following 'Find dialog' is displayed:

You can:

  • Edit the search string in the Find what editbox (1) (or select one from the Find what history),
  • Edit the replacement string in the Replace with editbox (2) (or select one from the Replace with history),
  • Change the scope of the search using the Look in combobox (3):
    • Whole Solution extends the search to all project files,
    • All open Documents extends the search to all documents (script files and XML blocks) opened in the Editor Perspective,
    • Current Document limits the search to the current Code Editor,
    • Selection limits the search to the current selection (if not empty),
  • Change the find options using the options checkboxes (4):
    • Match whole word only lets you search for whole words rather than partial words,
    • Match case lets you perform a case-sensitive search,
    • Regular expression interprets the searched string as a regular expression rather than a literal string,
    • Search in SDK files lets you include SDK files in your search.

Find all occurrences

To find the next occurrence of the search string, click the Find next button:

  • The Code Editor automatically scrolls and selects the next occurrence found,
  • If the end of the document is reached, the search continues from the beginning of the document,
  • If no other occurrence is found, the 'Find next' button is disabled.


Replace the selected occurrence

To replace the selected occurrence of the search string, click the Replace button:

  • The Code Editor replaces the selected occurrence and automatically searches for the next occurrence,
  • If the end of the document is reached, the search continues from the beginning of the document,
  • If no other occurrence is found, the 'Find next' button is disabled.


Replace all occurrences

To replace all occurrences of the search string:

  • Click the Replace all button.


Find Results Tool Window

Find Results tool window The Find Results Tool Window in the Editor Perspective displays the Results history of the various Find All operations.

It consists of:

  • A 'Result selector' (1),
  • The current results set (2).

The Result selector (1) displays a Results tab for each results set.
Each Result tab displays the 'search text' of its results set.

Using the Result selector

The current results set can be changed by selecting its Results tab.

The 'Results Tab Menu' suggests the following operations:
Result selector

Close Close the corresponding results set
Refresh Restart the corresponding 'Find All' search without changing the search options, and update the results set
Edit Edit the corresponding 'Find All' search options
Close All but This Close the 'Results history' apart from the corresponding results set
Close All Clear the 'Results history'


Using a results set

A results set displays all the occurences found by the corresponding Find All operation.
These occurences are grouped by document (script file or XML block).

You can navigate to the position of an occurrence by double-clicking that occurrence.