PyCharm 2021.1 Help

Find tool window

View | Tool Windows | Find
Alt+3

The Find tool window displays the results of the following searches:

The results of each search are displayed in a separate tab, or replace the contents of the current tab, depending on the Open in new tab dialog setting. By default the window appears at the bottom of the screen.

It has a toolbar with a set of buttons, a pane of results, and additional buttons for Replace in Path, and Refactoring Preview operations.

Toolbar buttons

ItemTooltip and ShortcutDescription
the Settings button Options
Ctrl+Alt+Shift+F7
Click this button to open one of the Find Usages dialogs, which corresponds to the symbol. You can edit the search settings and click Rerun button to execute the modified search query.
the Rerun buttonRerun
Ctrl+F5
Repeat the last search. This button is not available for viewing code coverage results.
the Close buttonClose
Ctrl+Shift+F4
Close the current tab or the tool window. This button is not available in Replace in Path and Refactoring Preview dialogs.
Icons general pin tabPin TabClick this button to pin or unpin the current tab. You may need to pin a tab to prevent it from closing automatically when the maximum number of tabs is reached in this window.
Expand all
Collapse all
Expand all
Ctrl+NumPad +
Collapse all
Ctrl+NumPad -
Use these buttons to have all nodes expanded or collapsed.
Previous occurrence/ Next occurrencePrevious/next occurrence
Ctrl+Alt+Up
Ctrl+Alt+Down
Navigate to the previous/next element in the tab of results.
Group byGroup by

Click this icon to open the menu for the following grouping options:

  • File Structure Ctrl+S: select this option to display the found usages under the corresponding method nodes.

  • Module Ctrl+Alt+M: if you select this option, the found usages will show under the corresponding module or the library node.

  • Flatten ModulesAlt+O: select this option to display all the modules as a single-level tree view.

  • Package Ctrl+P: select this option to display all the found usages under their respective packages.

  • Test/Production: select this option to group the usages according the Production and Test scopes.

  • Usage type Ctrl+T: if this option is selected, the search results are grouped by the following categories:
    • comments

    • unclassified usage not related to any of the categories

  • Merge Usages from the Same Line: select this option to merge the duplicate usages found on the same line.

Show read accessShow read access
Ctrl+R
This button is available for Find Usages only.
If this button is pressed, the search results include references to the read access methods.
Show write accessShow write access
Ctrl+W
This button is available for Find Usages only.
If this button is pressed, the search results include references to the write access methods.
Show import statementsShow import statements
Ctrl+I
This button is available for Find Usages only.
If this button is pressed, the search results include the usages in the import statements.
the Preview Usages buttonPreview Usages Click this icon to open the Preview pane next to the search results.

Context menu commands

ItemShortcutDescription
RerunCtrl+F5Run the action again and show the results on the same tab.
Jump to SourceF4Navigate to the selected item in the source code.
IncludeInsertFor an excluded item: include the item in the list of results.
ExcludeDelete

Exclude the selected item from the list of results. (Excluded items are shown strikethrough.)

When you carry out the Replace All or the Do Refactor command, the excluded items are not affected.

RemoveCtrl+XRemove the selected item from the list of results.
Recent Find UsagesCtrl+EShow the list of recent searches. Select an item in the list to see the search results.
Add to FavoritesAdd the selected node to the Favorites list.

You can also create the new favourites list and add the selected node to it. PyCharm displays the created favourites list next to the Add to New Favourites List option.

Export to Text FileAlt+OSave the contents of the current result tab. In the Export preview dialog, specify the target file or copy information to the clipboard. Before saving, you can also modify the information to be saved.

Upper Toolbar buttons

IconTooltipDescription
Show Options MenuShow Options MenuClick this icon to open a menu with more options for managing the tool window such as displaying or hiding side toolbars, group tabs, selecting viewing mode, resizing, and so on.
HideHideHides the tool window. Press Alt+3 to restore it.
Last modified: 08 March 2021