IntelliJ IDEA 14.0.0 Web Help

Using Suggestion List

Any code completion or live template operation ends up with a suggestion list, from which you have to select the desired option. IntelliJ IDEA provides handy ways to make your selection, complete the source code, sort entries, and view reference information without leaving the suggestion list.

In this section, you will learn:

To navigate though the suggestion list and completed expression

  • Use the mouse cursor or the Up and Down arrow keys to navigate through the suggestion list.
  • Use the horizontal arrow keys in the completed expression to make the suggestion list wider (left arrow) or closer (right arrow):
    lookupListHorizArrows

To complete selection

  • Use Enter to insert the selected string at the insertion point.
  • Use Tab to replace the string next to the caret with the selected one.
  • Use Ctrl+Shift+Enter to make the current code construct syntactically correct (balance parentheses, add missing braces and semicolons, etc.)
  • It is possible to enter the desired element name manually when the input position is highlighted and the list of suggestions is open. As you type, the suggestion list shrinks so that only matching element names remain:
    itar7.gif

    If you enter a name that is not used in the scope, IntelliJ IDEA will inform you with a pop-up window as shown in the figure below:

    itar8.gif
  • 12.0+
    It is possible to type any part of a word, even the characters located somewhere in the middle of the word:
    codeCompletionWildcard.png

    That's why asterisk character doesn't get any special processing as a wildcard.

  • Use ! to negate a Boolean expression.

Please note the following:

  • If, invoking an action, you don’t get what you want immediately, invoke this action again by pressing the same shortcut.
  • Most suitable variants in the suggestion list are displayed on the green background on top of the list.
  • Entries in bold font on top of the list denote symbols defined in the current class. All the other symbols are shown below.

To view reference information in the suggestion list

  • Use the Quick Definition View. If you select an entry in a list and press Ctrl+Shift+I, IntelliJ IDEA displays the following quick information pop-up window:
    lookupListQuickDefView.png
  • Quick Information View works in a suggestion list. If you select an entry in a list, and press Ctrl+Q, IntelliJ IDEA displays the following quick information pop-up window:
    lookupListQuickDocView.png

To sort entries in the suggestion list

  • Click a_icon or pi_icon in the lower-right corner of the list to toggle between sorting in alphabetical order, or by relevance.

Please note the following:

  • The sorting icon appears in the list if it is long enough. For few entries only sorting icon is not displayed.
  • Use mouse only to click this icon.
  • IntelliJ IDEA memorizes the type of sorting.
  • Default behavior is defined in the Code Completion page of the Editor settings.

To view hierarchy in the completion pop-up

  1. Start typing the source code, and press Ctrl+Shift+Space orCtrl+Space. The suggestion list appears.
  2. While in the suggestion list, pressCtrl+H. The Hierarchy tool window shows the type hierarchy of the class, selected in the suggestion list.

    Same way, for the current selection in the suggestion list, you can view call hierarchy (Ctrl+Alt+H), or method hierarchy (Ctrl+Shift+H).

To close the suggestion list

  • Close the suggestion list with Escape, then enter your own code at the code completion position.

See Also

Last modified: 4 December 2014
comments powered by Disqus