PyCharm 2016.3 Help

Favorites Tool Window

View | Tool Windows | Favorites
Alt+2


This tool window is marked with the icon /help/img/idea/icon_star.png.

The Favorites tool window lets you manage the following lists:

Initially, the lists are empty. So doing, the favorites list has the same name as the project.

The lists of bookmarks and breakpoints are filled in automatically, as the new bookmarks or breakpoints are added.

To add items to favorites, do one of the following:

  • Select one or more items in the Project tool window or the Find tool window. Then choose File | Add To Favorites.
  • Right-click an editor tab, and choose Add to Favorites or Add All to Favorites.

On this page:

Toolbar buttons

ItemShortcutDescription
/help/img/idea/new.pngAlt+InsertUse this button to create a new list of favorite items. In the Add New Favorites List dialog, specify the name for the new list and click OK.
/help/img/idea/editFlexLibraryNew.pngCtrl+Enter Click this button to rename the selected list.
/help/img/idea/delete.pngAlt+DeleteUse this button to delete the selected list or list item.

Depending on the selection, the following behaviors take place:

  • If a Favorites list /help/img/idea/icon_star.png, or one of the nested favorites is selected, click this button to delete an entire favorites list, or the selected item. So doing an item or a list is deleted from the Favorites tool window, but is left intact in project.
  • If a bookmark under the Bookmarks list bookmarkCheck is selected, click this button to delete this bookmark from the list and from the source code.
    Vice versa, if a bookmark is deleted from the source code, it is also removed from the Favorites tool window.
  • If a breakpoint under the Breakpoints list set_breakpoint is selected, click this button to delete the selected breakpoint from the list and from the source code.
    Vice versa, if a breakpoint is deleted from the source code, it is also removed from the Favorites tool window.

Context menu commands

When you right-click an item in the content pane, the context menu for this item is shown. This menu provides access to all the functions available for the selected item.

The commands and functionally are similar to those in the Project tool window.

Title bar context menu and buttons

The title bar context menu provides the options for controlling the tool window viewing modes. It also contains the commands for associating the tool window with a different tool window bar, resizing and hiding the tool window.

To access the menu, right-click the window title bar.

Note that most of the menu options may alternatively be accessed by means of the title bar buttons.

Toolbar iconContext menu commandDescription
/help/img/idea/viewMode.pngPinned, Docked, Floating, Windowed, Split ModeThese options let you control general appearance and behavior of the tool window, see Viewing Modes.
Move toTo associate the tool window with a different tool window bar, select this command, and then select the destination tool window bar (Top, Left, Bottom or Right).
ResizeTo resize the tool window by moving one of its borders, select this command, and then select the necessary Stretch to option.

Note that this command is not available in the floating mode.

/help/img/idea/hideSide.png
Shift+Escape
HideUse this command to hide the tool window.
/help/img/idea/icon_collapse_all_on_title_bar.pngUse this button to collapse all expanded nodes.

Context menu of the side bar button

Right-click the side bar button to reveal this context menu. Refer to the section Viewing Modes for the detailed information about the viewing modes.

ItemDescription
/help/img/idea/icon_show_members.pngUse this command to turn the Show Members option on or off.

If this option is on, the class members (fields, methods, etc.) are shown.

/help/img/idea/autoScrollToSource.pngUse this command to turn the Autoscroll to Source option on or off.

If this option is on, PyCharm automatically navigates from a file (or a class member) selected in the Favorites tool window to the corresponding source file (or its fragment) in the editor. If the corresponding file is not currently open, it will open automatically.

/help/img/idea/autoscrollFromSource.pngUse this command to turn the Autoscroll from Source option on or off.

If this option is on, PyCharm automatically navigates from a file (or a class member) selected in the editor, to the corresponding file in the Favorites tool window.

Using drag-and-drop

You can use drag-and-drop to:

  • Add items to favorites: drag the item of interest from the Project tool window and drop it onto the desired favorites list in the Favorites tool window.
  • Drag an external item from the Explorer/Finder and drop it onto the desired favorites list in the Favorites tool window.
  • Move an item from one favorites list to another in the Favorites tool window.

See Also

Last modified: 23 November 2016