MPS
 
2021.2
Shortcuts: Windows
Get MPS
You are viewing the documentation for an earlier version of MPS.
  1. Write and edit source code
  2. MPS Editor. Guided Tour
  3. Fold code elements

Fold code elements

Last modified: 13 August 2021

You can collapse (fold) code fragments reducing them to a single visible line. In this way, you can hide the details that, at the moment, seem unimportant. If and when necessary, the folded code fragments can be expanded (unfolded).

Folded code fragments, normally, are shown as shaded ellipses (Folded fragment).

If the folded code block contains errors, MPS highlights the folded fragment in red.

tip

You can extend the editor area to the whole size of the IDE window by temporarily hiding all tool windows — press Ctrl+Shift+F12 or double-click the current editor tab.

Code folding means

You can collapse and expand code fragments by using:

  • Code folding toggles (Folding start, Folding end or folding). These toggles are shown in the editor to the left of the corresponding folding regions. If a region is unfolded, Folding start indicates the beginning of the region while Folding end is located at its end. For folded regions, the toggle is shown as folding.

    If you hold the Alt key and click Folding start, Folding end or folding, the region is collapsed or expanded recursively, for example along with all its subordinate regions.

  • Commands of the Folding menu and associated keyboard shortcuts. The Folding menu can be accessed from the main menu (Code | Folding), or as a context menu in the editor. The shortcuts are shown right in the menu. See Commands of the Folding menu and associated shortcuts.

  • Folded fragments themselves: click folded fragment to expand the corresponding fragment. See also, Viewing folded code fragments.

Folding predefined and custom regions

You can fold and unfold:

  • Predefined regions that correspond import declarations, method bodies, documentation comments, etc. The predefined regions, roughly, correspond to the ones listed under Collapse by default on the Editor | General | Code Folding page of the IDE settings Ctrl+Alt+S.

    For the predefined regions, the folding toggles are available right away, without the need to perform any additional actions.

  • Any selected code fragment. A custom folding region for a selection is created and removed by means of the Code | Folding | Fold Selection/ Remove Region command Ctrl+..

note

Code folding works for the keywords if/while/else/for/try/except/finally/with in case of at least two statements.

Commands of the Folding menu and associated shortcuts

The Folding menu can be accessed from the main menu (Code | Folding), or as a context menu in the editor.

Command

Shortcut

Description

Expand

Ctrl+NumPad +

Expand the current collapsed fragment.

Collapse

Ctrl+NumPad -

Collapse the current folding region.

Expand Recursively

Ctrl+Alt+NumPad +

Expand the current folded fragment and all the subordinate collapsed folding regions within that fragment.

Collapse Recursively

Ctrl+Alt+NumPad -

Collapse the current folding region and all the subordinate folding regions within it.

Expand All

Ctrl+Shift+NumPad +

Expand all collapsed fragments within the selection, or, if nothing is selected, expand all the collapsed fragments in the current file.

Collapse All

Ctrl+Shift+NumPad -

Collapse all folding regions within the selection, or, if nothing is selected, collapse all the folding regions in the current file.

Expand to level | 1, 2, 3, 4 or 5

  • Ctrl+NumPad *, 1

  • Ctrl+NumPad *, 2

  • Ctrl+NumPad *, 3

  • Ctrl+NumPad *, 4

  • Ctrl+NumPad *, 5

Expand the current fragment and all the nested fragments up to the specified level.

Expand all to level | 1, 2, 3, 4 or 5

  • Ctrl+Shift+NumPad *, 1

  • Ctrl+Shift+NumPad *, 2

  • Ctrl+Shift+NumPad *, 3

  • Ctrl+Shift+NumPad *, 4

  • Ctrl+Shift+NumPad *, 5

Expand all the collapsed fragments in the file up to the specified nesting level.

Expand doc comments

Expand all documentation comments in the current file.

Collapse doc comments

Collapse all documentation comments in the current file.

Fold Selection / Remove region

Ctrl+.

Collapse the selected fragment and create a custom folding region for it to make it "foldable" / Expand the current fragment and remove the corresponding custom folding region to make the fragment "unfoldable".

Specifying code folding preferences

You can specify:

  • Whether the code folding toggles should be shown.

  • Which folding regions should be collapsed by default.

The corresponding settings are on the Editor | General | Code Folding page of the IDE settings Ctrl+Alt+S.

Viewing folded code fragments

To see the contents of a folded fragment, point to the ellipsis Folded fragment that indicates that fragment.

Viewing the beginning of a folding region

To see the beginning of a folding region - if it's not currently visible - point to the folding toggle at the end of that region.

See also

Getting Started