IntelliJ IDEA 13.1 Web Help

File | Settings | Project Settings | Scopes

browseButton.png

A scope is a set of files to which various operations apply. Using this dialog, you can define scopes for the various IntelliJ IDEA actions, for example, Find Usages, or Code Inspection.

In this section:

Main toolbar

Item Tooltip Description
add Add scope
InsertInsertInsertInsertInsertInsertInsertInsertInsertInsertInsertInsert
Click this button to add a new local or shared scope.
delete Delete
DeleteDeleteDeleteDeleteDelete or Ctrl+DDeleteDeleteDeleteDeleteDelete or BackspaceDeleteDelete or Backspace
Click this button to delete the selected scope from the list.
copy Copy configuration
Ctrl+DCtrl+DCtrl+DCtrl+DMeta+DCtrl+DCtrl+DCtrl+D, Ctrl+Shift+Down or Ctrl+Shift+UpCtrl+DCommand DCommand DCommand D
Click this button to create a copy of the selected scope.
mainToolbarSave Save as Click this button to have the selected local scope saved as shared or a selected shared scope as local.
arrowUp arrowDown Move Up/Move Down Use these buttons to move the scopes up and down in the list.

If some file is included into several scopes, the order of the scopes becomes important: IntelliJ IDEA uses the color of the uppermost scope (shown in the Scopes settings page) to highlight such file. Of course, you can change the order of the scopes, and thus the resulted highlighting.

.

Scopes configuration controls

Item Description
Name In this text box, specify the scope name.
Pattern In this text box, specify the pattern to define the current scope using the script-like language described in the Scope Language Syntax Reference subsection. The following elements and structures are used:
  1. The file: modifier. The element is mandatory.
  2. The * asterisk to denote any symbol in a file name or file extension.
  3. Logical operators AND (&&), OR (||), and NOT (!).
Type or edit the pattern manually or choose the desired files in the Project Tree View - IntelliJ IDEA will generate the corresponding pattern.

Warning

Storing empty or incorrect patterns is not allowed. In such cases, you will be prompted with the Syntax Error warning.

Include Click this button to have the selected element included in the scope. The corresponding expression is automatically generated and added to the expression in the Pattern text box.

Tip

If the current element is a folder, the nested subfolders are ignored.

Include Recursively Click this button to have the selected folder included in the scope, together with the nested subfolders. The corresponding expression is automatically generated and added to the expression in the Pattern text box.
Exclude Click this button to have the selected element excluded from the scope. The corresponding expression is automatically added to the Pattern. If the current element is a folder, the nested subfolders are ignored.
Exclude Recursively Click this button to have the selected folder excluded from the scope, together with the nested subfolders. The corresponding expression is automatically added to the Pattern field.

Scope toolbar

Item Tooltip Description
Project tree view The tree view contains all the files available in your project. In the view, select the desired files to be included in the current scope and have the scope definition pattern generated automatically. The message on the toolbar shows the total number of available files and the number of files included in the scope. See also the color legend below. Use the toolbar buttons described below to change the view presentation.

The way of presentation of the project tree view, the available controls and scopes language syntax depend on the selection in project vs package drop-down list.

flattenPackages Flatten Packages When the button is pressed, all the packages are displayed as a single-level tree view. This enables you to find a package somewhere deep within the project by its name without going through the entire tree hierarchy.
groupByScoupType Group by Scopes Type When this button is pressed, the items in the tree-view are grouped below three nodes:
  • Library Classes
  • Production Classes
  • Test Classes

Note

This button is only available for the Package presentation of scopes.

showFiles Show Files If this button is pressed, source files are displayed explicitly in the tree view. When the files are shown, they can be selected for exclusion/inclusion into a pattern.

scope_pattern

If this button is not pressed, the files are hidden.

commonfilter Show Included Only When the button is pressed, the tree shows only the elements that are included in the scope.
scope_project_vs_package Use this drop-down box to define how you want the project files to be displayed in the tree view. The available options are:
  • Project
  • Packages

The project tree view presentation, scopes language syntax and the available toolbar buttons differ depending on the selection.

Legend of the project tree view

Item Description
Green Folders and files included in scope.
Black Folders and files excluded from scope.
Blue Folders that contain both excluded and included files and subfolders.

See Also

Concepts:

Reference:

Web Resources: