Skip to content

Commit c86ec17

Browse files
authored
Merge pull request #3174 from craigcaseyMSFT/vcraic1029
Text Editor Options - 10 more files updated
2 parents 77a08ea + 254ca06 commit c86ec17

11 files changed

+403
-86
lines changed
Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
---
2+
title: Options, Text Editor, C/C++, View
3+
ms.date: 10/29/2018
4+
ms.topic: reference
5+
f1_keywords:
6+
- "VS.ToolsOptionsPages.Text_Editor.C/C++.View"
7+
- "VS.ToolsOptionsPages.Text_Editor.C%2FC%2B%2B.View"
8+
- "VS.ToolsOptionsPages.Text_Editor.C\\C++.View"
9+
author: mikeblome
10+
ms.author: mblome
11+
manager: wpickett
12+
ms.prod: visual-studio-dev15
13+
ms.technology: vs-ide-general
14+
ms.workload:
15+
- "cplusplus"
16+
---
17+
# Options, Text Editor, C/C++, View
18+
19+
Use these property pages to change the default behavior of the code editor when you are programming in C or C++.
20+
21+
To access this property page, choose **Tools** > **Options** and expand **Text Editor**, then **C/C++**, and then choose **View**.
22+
23+
> [!NOTE]
24+
> Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. The Visual Studio edition that you have and the settings that you use determine these elements. See [Personalize the Visual Studio IDE](../../ide/personalizing-the-visual-studio-ide.md).
25+
26+
## Code Squiggles
27+
28+
You can enable or disable the following settings to manage the way in which text editor handles code squiggles for C and C++:
29+
30+
- **Macros in Skipped Browsing Regions** - Defines how to highlight macros that are inside skipped regions by the browsing database, such as macros whose definitions include braces.
31+
32+
- **Macros Convertible to constexpr** - Defines how to highlight macro definitions that can be converted to `constexpr` definitions.
33+
34+
## Inactive Code
35+
36+
- **Show Inactive Blocks** - Preprocessor inactive blocks are colorized differently.
37+
38+
- **Disable Inactive Code Opacity** - A solid color, instead of opacity, is used for inactive code blocks.
39+
40+
- **Inactive Code Opacity Percent** - The percentage of opacity for inactive code blocks.
41+
42+
## Miscellaneous
43+
44+
- **Enumerate Comment Tasks** - Scan open source files for VS tokens and report them in the Task List window.
45+
46+
- **Highlight Matching Tokens** - Highlight enclosing braces or syntax that match where the cursor is positioned.
47+
48+
## Outlining
49+
50+
- **Enable Outlining** - Enter outlining mode when a file opens.
51+
52+
- **Outline Pragma Regions** - Automatically outline `#pragma` region blocks.
53+
54+
- **Outline Statement Blocks** - Automatically outline statement blocks.
55+
56+
## See also
57+
58+
- [Setting Language-Specific Editor Options](../../ide/reference/setting-language-specific-editor-options.md)
59+
- [Refactoring in C++ (VC Blog)](http://blogs.msdn.com/b/vcblog/archive/2014/11/14/all-about-c-refactoring-in-visual-studio-2015-preview.aspx)

docs/ide/reference/options-text-editor-csharp-advanced.md

Lines changed: 15 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Options, Text Editor, C#, Advanced
3-
ms.date: 11/04/2016
3+
ms.date: 10/29/2018
44
ms.prod: visual-studio-dev15
55
ms.technology: vs-ide-general
66
ms.topic: reference
@@ -30,7 +30,7 @@ Use the **Advanced** options page to modify the settings for editor formatting,
3030

3131
- Place 'System' directives first when sorting usings
3232

33-
When selected, the **Remove and Sort Usings** command in the right-click menu sorts the `using` directives and places the 'System' namespaces at the top of the list
33+
When selected, the **Remove and Sort Usings** command in the right-click menu sorts the `using` directives and places the 'System' namespaces at the top of the list.
3434

3535
Before sorting:
3636

@@ -83,9 +83,10 @@ Use the **Advanced** options page to modify the settings for editor formatting,
8383
using System.Linq;
8484
```
8585

86-
- Add usings for types in reference assemblies and NuGet packages
86+
- Suggest usings for types in reference assemblies
87+
- Suggest usings for types in NuGet packages
8788

88-
When selected, a [Quick Action](../quick-actions.md) is available to install a NuGet package and add a `using` directive for unreferenced types.
89+
When these options are selected, a [Quick Action](../quick-actions.md) is available to install a NuGet package and add a `using` directive for unreferenced types.
8990

9091
![Quick Action to install NuGet package in Visual Studio](media/nuget-lightbulb.png)
9192

@@ -101,6 +102,16 @@ Use the **Advanced** options page to modify the settings for editor formatting,
101102

102103
When selected, automatically outlines the code file, which creates collapsible blocks of code. The first time a file is opened, #regions blocks and inactive code blocks collapse.
103104

105+
- Show procedure line separators
106+
107+
The text editor indicates visual scope of procedures. A line is drawn in the *.vb* source files of your project at locations listed in the following table:
108+
109+
|Location in .vb Source File|Example of Line Location|
110+
|---------------------------------|------------------------------|
111+
|After the close of a block declaration construct|- At the end of a class, structure, module, interface, or enum<br />- After a property, function, or sub<br />- Not between the get and set clauses in a property|
112+
|After a set of single line constructs|- After the import statements, before a type definition in a class file<br />- After variables declared in a class, before any procedures|
113+
|After single line declarations (non-block level declarations)|- Following import statements, inherits statements, variable declarations, event declarations, delegate declarations, and DLL declare statements|
114+
104115
## Editor Help
105116

106117
- Generate XML documentation comments for ///

docs/ide/reference/options-text-editor-csharp-intellisense.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -38,11 +38,9 @@ The **IntelliSense** options page contains the following options:
3838

3939
- Highlight matching portions of completion list items
4040

41-
- Show completion list filters
41+
- Show completion item filters
4242

43-
- Show name suggestions
44-
45-
### Snippets behavior
43+
## Snippets behavior
4644

4745
- Never include snippets
4846

@@ -56,7 +54,7 @@ The **IntelliSense** options page contains the following options:
5654

5755
When this option is selected, IntelliSense adds aliases for C# code snippets to the completion list when **?**+**Tab** is pressed after an identifier
5856

59-
### Enter key behavior
57+
## Enter key behavior
6058

6159
- Never add new line on enter
6260

@@ -80,6 +78,10 @@ The **IntelliSense** options page contains the following options:
8078

8179
Specifies that if you type *any* of the characters for an entry in the completion list and then press **Enter**, a new line is added automatically and the cursor moves to the new line.
8280

81+
## Show name suggestions
82+
83+
Performs automatic object name completion for the members that you have recently selected.
84+
8385
## See also
8486

8587
- [General, Environment, Options Dialog Box](../../ide/reference/general-environment-options-dialog-box.md)
Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
title: Options, Text Editor, JavaScript, Code Validation
3+
ms.date: 10/29/2018
4+
ms.prod: visual-studio-dev15
5+
ms.technology: vs-ide-general
6+
ms.topic: reference
7+
f1_keywords:
8+
- "VS.ToolsOptionsPages.Text_Editor.TypeScript.Code_Validation.JavaScript_Errors"
9+
author: gewarren
10+
ms.author: gewarren
11+
manager: douge
12+
ms.workload:
13+
- "multiple"
14+
---
15+
# Options, Text Editor, JavaScript, Code Validation
16+
Use the **Code Validation** page of the **Options** dialog box to modify settings that affect the way that JavaScript handles errors. You can access the **Code Validation** page by choosing **Tools** > **Options** on the menu bar, and then expanding **Text Editor** > **JavaScript** > **Code Validation.**
17+
18+
[!INCLUDE[note_settings_general](../../data-tools/includes/note_settings_general_md.md)]
19+
20+
The **Code Validation** page contains the following sections:
21+
22+
## JavaScript Errors
23+
You can use these options to set preferences for how the JavaScript editor validates syntax in your document.
24+
25+
### UIElement List
26+
**Enable JavaScript errors**
27+
28+
When set to **True**, the JavaScript code editor shows errors for JavaScript and JSX files. Errors appear in the **Error List** with a (JS) prefix. Viewing these errors is useful if you're working with code that you didn't write and you don't intend to fix syntax errors.
29+
30+
**Show errors as warnings**
31+
32+
When set to **True**, JavaScript errors are shown as warnings instead of errors in the **Error List**.
33+
34+
## See Also
35+
36+
- [JavaScript IntelliSense](../../ide/javascript-intellisense.md)

docs/ide/reference/options-text-editor-javascript-formatting.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Options, Text Editor, JavaScript, Formatting
3-
ms.date: 11/04/2016
3+
ms.date: 10/29/2018
44
ms.prod: visual-studio-dev15
55
ms.technology: vs-ide-general
66
ms.topic: reference
@@ -26,19 +26,20 @@ Use the **Formatting** page of the **Options** dialog box to set options for for
2626
## Automatic Formatting
2727
These options determine when formatting occurs in **Source** view.
2828

29-
## UIElement List
29+
### UIElement List
3030

3131
|Option|Description|
3232
|------------|-----------------|
3333
|**Format completed line on Enter**|When this option is selected, the Code Editor automatically formats the line when you choose the Enter key.|
3434
|**Format completed statement on ;**|When this option is selected, the Code Editor automatically formats the line when you choose the semicolon key.|
35+
|**Format opened block on {**|When this option is selected, the Code Editor automatically formats the line when you choose the opening brace key.|
3536
|**Format completed block on }**|When this option is selected, the Code Editor automatically formats the line when you choose the closing brace key.|
3637
|**Format on paste**|When this option is selected, the Code Editor reformats code when you paste it into the editor. The editor uses the currently defined formatting rules. If this option is not selected, the editor uses the original formatting of the pasted-in code.|
3738

3839
## New Lines
3940
These options determine whether the Code Editor puts an open brace for functions and control blocks on a new line.
4041

41-
## UIElement List
42+
### UIElement List
4243

4344
|Option|Description|
4445
|------------|-----------------|
@@ -48,15 +49,15 @@ Use the **Formatting** page of the **Options** dialog box to set options for for
4849
## Spacing
4950
These options determine how spaces are inserted in **Source** view.
5051

51-
## UIElement List
52+
### UIElement List
5253

5354
|Option|Description|
5455
|------------|-----------------|
5556
|**Insert space after comma delimiter**|When this option is selected, the Code Editor adds a space after comma delimiters.|
56-
|**Insert space after semicolon in 'for' statement**|When this option is selected, the Code Editor adds a space after each semicolon in the first line of a `for` loop.|
57+
|**Insert space after semicolon in 'for' statements**|When this option is selected, the Code Editor adds a space after each semicolon in the first line of a `for` loop.|
5758
|**Insert space before and after binary operators**|When this option is selected, the Code Editor adds a space before and after binary operators (for example, +, -, &&, &#124;&#124;).|
5859
|**Insert space after keywords in control flow statements**|When this option is selected, the Code Editor adds a space after JavaScript keywords in control flow statements.|
59-
|**Insert space after function keyword for anonymous functions.**|When this option is selected, the Code Editor adds a space after the `function` keyword for anonymous functions.|
60+
|**Insert space after function keyword for anonymous functions**|When this option is selected, the Code Editor adds a space after the `function` keyword for anonymous functions.|
6061
|**Insert space after opening and before closing non-empty parenthesis**|When this option is selected, the Code Editor adds a space after the opening parenthesis and before the closing parenthesis if non-empty characters are present within the parentheses.|
6162

6263
## See Also
Lines changed: 15 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Options, Text Editor, JavaScript, IntelliSense
3-
ms.date: 11/04/2016
3+
ms.date: 10/29/2018
44
ms.prod: visual-studio-dev15
55
ms.technology: vs-ide-general
66
ms.topic: reference
@@ -16,46 +16,24 @@ ms.workload:
1616
- "multiple"
1717
---
1818
# Options, Text Editor, JavaScript, IntelliSense
19-
Use the **IntelliSense** page of the **Options** dialog box to modify settings that affect the behavior of IntelliSense for JavaScript. You can access the **IntelliSense** page by choosing **Tools**, **Options** on the menu bar, and then expanding **Text Editor**, **JavaScript**, **IntelliSense.**
19+
Use the **IntelliSense** page of the **Options** dialog box to modify settings that affect the behavior of IntelliSense for JavaScript. You can access the **IntelliSense** page by choosing **Tools** > **Options** on the menu bar, and then expanding **Text Editor** > **JavaScript** > **IntelliSense.**
2020

2121
[!INCLUDE[note_settings_general](../../data-tools/includes/note_settings_general_md.md)]
2222

2323
The **IntelliSense** page contains the following sections:
2424

25-
## Validation
26-
You can use these options to set preferences for how the JavaScript editor validates syntax in your document.
27-
28-
## UIElement List
29-
**Show syntax errors**
30-
31-
When this check box is not selected, the JavaScript code editor does not show syntax errors. This is useful if you are working with code that you didn't write and you don't intend to fix syntax errors.
32-
33-
When this check box is selected, you have the option to select the **Show errors as warning** check box.
34-
35-
**Show errors as warnings**
36-
37-
When this check box is selected, JavaScript errors are shown as warnings instead of errors in the error list.
38-
39-
**Download remote references (e.g. http://) for files in the miscellaneous files project**
40-
41-
When this check box is selected, and if you have a JavaScript file opened outside the context of a project, Visual Studio will download remote JavaScript files referenced in the file for the purpose of providing IntelliSense information. If this option is selected, files will download when you include them as a reference in your JavaScript file.
42-
43-
> [!NOTE]
44-
> For web projects, remote files referenced in your project are downloaded by default.
45-
46-
4725
## Statement Completion
4826
You can use these options to change the behavior of IntelliSense statement completion.
4927

50-
## UIElement List
51-
**Only use tab or enter to commit**
28+
### UIElement List
29+
**Only use Tab or Enter to commit**
5230

53-
When this check box is selected, the JavaScript code editor appends statements with items selected in the completion list only after you choose the Tab or Enter key. When this check box is not selected, other characters, such as a period, comma, colon, open parenthesis, and open brace ({), can also append statements with the selected items.
31+
When you select this check box, the JavaScript code editor appends statements with items selected in the completion list only after you choose the **Tab** or **Enter** key. When you deselect this check box, other characterssuch as a period, comma, colon, open parenthesis, and open brace ({) can also append statements with the selected items.
5432

5533
## References
5634
You can use these options to specify the types of IntelliSense .js files that are in scope for different JavaScript project types. The IntelliSense references are typically used to provide IntelliSense support for global objects. You can also use this page to set the loading order for scripts that must be loaded at run time, and to add IntelliSense extension files.
5735

58-
## UIElement List
36+
### UIElement List
5937
**Reference groups**
6038

6139
This option specifies the reference group type. Three reference groups are supported:
@@ -82,6 +60,15 @@ This option specifies the order in which files are loaded into the context of th
8260

8361
This option provides a way to add additional IntelliSense .js files by browsing to the appropriate files.
8462

63+
**Download remote references (e.g. http://) for files in the miscellaneous files project**
64+
65+
When this check box is selected, and if you have a JavaScript file opened outside the context of a project, Visual Studio downloads remote JavaScript files referenced in the file for the purpose of providing IntelliSense information. If this option is selected, files are downloaded when you include them as a reference in your JavaScript file.
66+
67+
> [!NOTE]
68+
> For web projects, remote files referenced in your project are downloaded by default.
69+
70+
71+
8572
## See Also
8673

8774
- [JavaScript IntelliSense](../../ide/javascript-intellisense.md)

0 commit comments

Comments
 (0)