Skip to content

Commit afccf87

Browse files
authored
Merge pull request #3144 from craigcaseyMSFT/vcraic1023
Text Editor Options - 10 files updated
2 parents da11070 + 5042c05 commit afccf87

12 files changed

+115
-68
lines changed

docs/ide/how-to-track-your-code-by-customizing-the-scrollbar.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,6 @@ ms.date: 09/25/2018
44
ms.prod: visual-studio-dev15
55
ms.technology: vs-ide-general
66
ms.topic: conceptual
7-
f1_keywords:
8-
- "VS.ToolsOptionsPages.Text_Editor.All_Languages.Scroll_Bars"
97
author: gewarren
108
ms.author: gewarren
119
manager: douge
Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
title: Options, Text Editor, All Languages, Scroll Bars
3+
ms.date: 10/25/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.All_Languages.Scroll_Bars"
9+
author: gewarren
10+
ms.author: gewarren
11+
manager: douge
12+
ms.workload:
13+
- "multiple"
14+
---
15+
# Options, Text Editor, All Languages, Scroll Bars
16+
This dialog box lets you change the default behavior of the code editor scroll bar. To display these options, select **Options** from the **Tools** menu. Within the **Text Editor** folder, expand the **All Languages** subfolder, and then choose **Scroll Bars**.
17+
18+
> [!CAUTION]
19+
> This page sets default options for all development languages. Resetting an option in this dialog will reset the Scroll Bars options in all languages to whatever choices are selected here. To change Text Editor options for just one language, expand the subfolder for that language and select its option pages.
20+
21+
## Show horizontal scroll bar
22+
23+
When selected, displays a horizontal scrollbar, which allows you to scroll from side-to-side to view elements that fall outside the viewing area of the Editor. If horizontal scrollbars are unavailable, you can use the cursor keys to scroll.
24+
25+
## Show vertical scroll bar
26+
27+
When selected, displays a vertical scrollbar, which allows you to scroll up and down to view elements that fall outside the viewing area of the Editor. If vertical scrollbars are not available, you can use the Page Up, Page Down and cursor keys to scroll.
28+
29+
## Display
30+
31+
### Show annotations over vertical scroll bar
32+
33+
Select whether the vertical scroll bar shows the following annotations:
34+
35+
- changes
36+
- marks
37+
- errors
38+
- caret position
39+
40+
> [!TIP]
41+
> The **Show marks** option includes breakpoints and bookmarks.
42+
43+
Try it out by opening a large code file and replacing some text that occurs in several places in the file. The scroll bar shows you the effect of the replacements, so you can back out your changes if you replaced something you shouldn't have.
44+
45+
## Behavior
46+
47+
The scroll bar has two modes: bar mode and map mode.
48+
49+
### Use bar mode for vertical scroll bar
50+
51+
*Bar mode* displays annotation indicators on the scroll bar. Clicking on the scroll bar scrolls the page up or down but does not jump to that location in the file.
52+
53+
### Use map mode for vertical scroll bar
54+
55+
In *map mode*, when you click a location on the scroll bar, the cursor jumps to that location in the file instead of just scrolling up or down a page. Lines of code are shown, in miniature, on the scroll bar. You can choose how wide the map column is by selecting a value in **Source overview**. To enable a larger preview of the code when you rest the pointer on the map, select the **Show Preview Tooltip** option. Collapsed regions are shaded differently and expand when you double-click them.
56+
57+
> [!TIP]
58+
> You can turn the miniature code view off in map mode by setting **Source overview** to **Off**. If **Show Preview Tooltip** is selected, you still see a preview of the code at that location when you hover your pointer on the scroll bar, and the cursor still jumps to that location in the file when you click.
59+
60+
## See also
61+
62+
- [How to: Customize the scroll bar](../how-to-track-your-code-by-customizing-the-scrollbar.md)

docs/ide/reference/options-text-editor-all-languages.md

Lines changed: 22 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ ms.topic: reference
77
f1_keywords:
88
- "VS.ToolsOptionsPages.Text_Editor.JavaScript.General"
99
- "VS.ToolsOptionsPages.Text_Editor.ResJSON.General"
10-
- "vs.toolsoptionspages.text_editor.all_languages.scrollbars"
10+
- "VS.ToolsOptionsPages.Text_Editor.All_Languages.General"
1111
helpviewer_keywords:
1212
- "Text Editor Options dialog box"
1313
- "statement completion"
@@ -36,32 +36,32 @@ This dialog box allows you to change the default behavior of the Code Editor. Th
3636
3737

3838
## Statement Completion
39-
Auto list members
39+
**Auto list members**
4040

4141
When selected, pop-up lists of available members, properties, values, or methods are displayed by IntelliSense as you type in the editor. Choose any item from the pop-up list to insert the item into your code. Selecting this option enables the **Hide advanced members** option.
4242

43-
Hide advanced members
43+
**Hide advanced members**
4444

4545
When selected, shortens pop-up statement completion lists by displaying only those items most commonly used. Other items are filtered from the list.
4646

47-
Parameter information
47+
**Parameter information**
4848

4949
When selected, the complete syntax for the current declaration or procedure is displayed under the insertion point in the editor, with all of its available parameters. The next parameter you can assign is displayed in bold.
5050

5151
## Settings
52-
Enable virtual space
52+
**Enable virtual space**
5353

5454
When this option is selected and **Word wrap** is cleared, you can click anywhere beyond the end of a line in the Code Editor and type. This feature can be used to position comments at a consistent point next to your code.
5555

56-
Word wrap
56+
**Word wrap**
5757

5858
When selected, any portion of a line that extends horizontally beyond the viewable editor area is automatically displayed on the next line. Selecting this option enables the **Show visual glyphs for word wrap** option.
5959

6060
> [!NOTE]
6161
> The **Virtual Space** feature is turned off while **Word Wrap** is on.
6262
6363

64-
Show visual glyphs for word wrap
64+
**Show visual glyphs for word wrap**
6565

6666
When selected, a return-arrow indicator is displayed where a long line wraps onto a second line.
6767

@@ -73,36 +73,34 @@ This dialog box allows you to change the default behavior of the Code Editor. Th
7373
> These reminder arrows are not added to your code, and do not print. They are for reference only.
7474
7575

76-
Apply Cut or Copy commands to blank lines when there is no selection
76+
**Line numbers**
7777

78-
This option sets the behavior of the editor when you place the insertion point on a blank line, select nothing, and then Copy or Cut.
79-
80-
- When this option is selected, the blank line is copied or cut. If you then Paste, a new, blank line is inserted.
78+
When selected, a line number appears next to each line of code.
8179

82-
- When this option is cleared, the Cut command removes blank lines. However, the data on the Clipboard is preserved. Therefore, if you then use the Paste command, the content most recently copied onto the Clipboard is pasted. If nothing has been copied previously, nothing is pasted.
80+
> [!NOTE]
81+
> These line numbers are not added to your code, and do not print. They are for reference only.
8382
84-
This setting has no effect on Copy or Cut when a line is not blank. If nothing is selected, the entire line is copied or cut. If you then Paste, the text of the entire line and its endline character are pasted.
8583

86-
> [!TIP]
87-
> To display indicators for spaces, tabs, and line ends, and thus distinguish indented lines from lines that are entirely blank, select **Advanced** from the **Edit** menu and choose **View White Space**.
84+
**Enable single-click URL navigation**
8885

86+
When selected, the mouse cursor changes to a pointing hand as it passes over a URL in the editor. You can click the URL to display the indicated page in your web browser.
8987

90-
## Display
91-
Line numbers
88+
**Navigation bar**
9289

93-
When selected, a line number appears next to each line of code.
90+
When selected, displays the **Navigation bar** at the top of the code editor. Its dropdown **Objects** and **Members** lists allow you to choose a particular object in your code, select from its members, and navigates to the declaration of the selected member in the Code Editor.
9491

95-
> [!NOTE]
96-
> These line numbers are not added to your code, and do not print. They are for reference only.
92+
**Apply Cut or Copy commands to blank lines when there is no selection**
9793

94+
This option sets the behavior of the editor when you place the insertion point on a blank line, select nothing, and then Copy or Cut.
9895

99-
Enable single-click URL navigation
96+
- When this option is selected, the blank line is copied or cut. If you then Paste, a new, blank line is inserted.
10097

101-
When selected, the mouse cursor changes to a pointing hand as it passes over a URL in the editor. You can click the URL to display the indicated page in your web browser.
98+
- When this option is cleared, the Cut command removes blank lines. However, the data on the Clipboard is preserved. Therefore, if you then use the Paste command, the content most recently copied onto the Clipboard is pasted. If nothing has been copied previously, nothing is pasted.
10299

103-
Navigation bar
100+
This setting has no effect on Copy or Cut when a line is not blank. If nothing is selected, the entire line is copied or cut. If you then Paste, the text of the entire line and its endline character are pasted.
104101

105-
When selected, displays the **Navigation bar** at the top of the code editor. Its dropdown **Objects** and **Members** lists allow you to choose a particular object in your code, select from its members, and navigates to the declaration of the selected member in the Code Editor.
102+
> [!TIP]
103+
> To display indicators for spaces, tabs, and line ends, and thus distinguish indented lines from lines that are entirely blank, select **Advanced** from the **Edit** menu and choose **View White Space**.
106104
107105
## See Also
108106

docs/ide/reference/options-text-editor-basic-visual-basic.md

Lines changed: 0 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -67,16 +67,6 @@ The text editor indicates visual scope of procedures. A line is drawn in the *.v
6767

6868
When you commit an `Implements` statement or an `Inherits` statement for a class, the text editor inserts prototypes for the members that have to be implemented or overridden, respectively.
6969

70-
**Show procedure line separators**
71-
72-
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:
73-
74-
|Location in .vb Source File|Example of Line Location|
75-
| - | - |
76-
|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|
77-
|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|
78-
|After single line declarations (non-block level declarations)|- Following import statements, inherits statements, variable declarations, event declarations, delegate declarations, and DLL declare statements|
79-
8070
**Enable error correction suggestions**
8171

8272
The text editor can suggest solutions to common errors and allow you to select the appropriate correction, which is then applied to your code.

docs/ide/reference/options-text-editor-c-cpp-advanced.md

Lines changed: 20 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -128,6 +128,12 @@ By changing these options, you can change the behavior related to IntelliSense a
128128

129129
Disables IntelliSense error squiggles. The red "squiggles" don't show in the editor window, but the error will still appear in the Error List window.
130130

131+
**Auto Tune Max Cached Translation Units**
132+
133+
The maximum number of translation units that will be kept active at any one time for IntelliSense requests. You must specify a value between 2 and 15. This number directly relates to the maximum number of VCPkgSrv.exe processes that will run (for a given instance of Visual Studio). The default value is 2, but if you have available memory, you can increase this value and possibly achieve slightly better performance on IntelliSense.
134+
135+
For more information about translation units, see [Phases of Translation](/cpp/preprocessor/phases-of-translation).
136+
131137
**Disable #include Auto Complete**
132138

133139
Disables auto-completion of `#include` statements.
@@ -136,16 +142,6 @@ By changing these options, you can change the behavior related to IntelliSense a
136142

137143
Triggers auto-completion of `#include` statements when "/" is used. The default delimiter is backslash '\'. The compiler can accept either, so use this option to specify what your code base uses.
138144

139-
**Max Cached Translation Units**
140-
141-
The maximum number of translation units that will be kept active at any one time for IntelliSense requests. You must specify a value between 2 and 15. This number directly relates to the maximum number of VCPkgSrv.exe processes that will run (for a given instance of Visual Studio). The default value is 2, but if you have available memory, you can increase this value and possibly achieve slightly better performance on IntelliSense.
142-
143-
For more information about translation units, see [Phases of Translation](/cpp/preprocessor/phases-of-translation).
144-
145-
**Member List Dot-To-Arrow**
146-
147-
Replaces '.' with '->' when applicable for Member List.
148-
149145
**Disable Aggressive Member List**
150146

151147
The member list doesn't appear while you type the name of a type or variable. The list appears only after you type one of the commit characters, as defined in the **Member List Commit Characters** option.
@@ -158,21 +154,25 @@ By changing these options, you can change the behavior related to IntelliSense a
158154

159155
Code snippets don't appear in member list suggestions.
160156

157+
**Member List Filter Mode**
158+
159+
Sets the type of matching algorithm. **Fuzzy** finds the most possible matches because it uses an algorithm that's similar to a spell-checker to find matches that are similar but not identical. **Smart filtering** matches substrings even if they're not at the start of a word. **Prefix** only matches on identical substrings that start at the beginning of the word.
160+
161161
**Disable Semantic Colorization**
162162

163163
Turns off all code colorization except for language keywords, strings, and comments.
164164

165-
**Smart Member List Commit**
165+
**Member List Commit Characters**
166166

167-
Adds a line when you choose the Enter key at the end of a fully typed word.
167+
Specifies the characters that cause the currently highlighted Member List suggestion to be committed. You can add or remove characters from this list.
168168

169-
**Member List Filter Mode**
169+
**Smart Member List Commit**
170170

171-
Sets the type of matching algorithm. **Fuzzy** finds the most possible matches because it uses an algorithm that's similar to a spell-checker to find matches that are similar but not identical. **Smart filtering** matches substrings even if they're not at the start of a word. **Prefix** only matches on identical substrings that start at the beginning of the word.
171+
Adds a line when you choose the Enter key at the end of a fully typed word.
172172

173-
**Member List Commit Characters**
173+
**Enable Member List Dot-To-Arrow**
174174

175-
Specifies the characters that cause the currently highlighted Member List suggestion to be committed. You can add or remove characters from this list.
175+
Replaces '.' with '->' when applicable for Member List.
176176

177177
## References
178178
**Disable Resolving**
@@ -185,12 +185,14 @@ By changing these options, you can change the behavior related to IntelliSense a
185185

186186
**Disable Reference Highlighting**
187187

188+
By default, when you select some text, all instances of the same text are automatically highlighted in the current document. You can disable this feature by setting **Disable Reference Highlighting** to **True**.
189+
188190
## Text Editor
189-
**Enable Expand Scopes**
191+
**Enable Surround with Braces**
190192

191193
If enabled, you can surround selected text with curly braces by typing '{' into the text editor.
192194

193-
**Enable Expand Precedence**
195+
**Enable Surround with Parentheses**
194196

195197
If enabled, you can surround selected text with parentheses by typing '(' into the text editor.
196198

docs/ide/reference/options-text-editor-c-cpp-experimental.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,12 +29,12 @@ These features are available in a Visual Studio 2017 installation.
2929

3030
Predictive IntelliSense limits the number of results displayed in the IntelliSense dropdown list so that you see only results that are relevant in the context. For example, if you type <code>int x =</code> and invoke the IntelliSense dropdown, you will see only integers or functions that return integers. Predictive IntelliSense is turned off by default.
3131

32-
## Enable Faster Project Load
32+
## Enable faster project load
3333

3434
**Visual Studio 2017 version 15.3 and later**: This feature is now called **Enable Project Caching** and has moved to the [VC++ Project Settings](vcpp-project-settings-projects-and-solutions-options-dialog-box.md) property page.
3535
This option enables Visual Studio to cache project data so that when you open the project the next time, it can load that cached data rather than re-computing it from the project files. Using cached data can speed up the project load time significantly.
3636

37-
## Additional Features in the Visual Studio Marketplace
37+
## Additional features in the Visual Studio Marketplace
3838

3939
You can browse additional text editor features in the [Visual Studio Marketplace](https://marketplace.visualstudio.com/search?target=VS&category=Tools&vsVersion=&subCategory=All&sortBy=Downloads). An example is [C++ Quick Fixes](https://marketplace.visualstudio.com/items?itemName=VisualCppDevLabs.CQuickFixes2017), which supports the following:
4040

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

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ f1_keywords:
1111
- "VS.ToolsOptionsPages.Text_Editor.CSharp.Formatting.Wrapping"
1212
- "VS.ToolsOptionsPages.Text_Editor.CSharp.Formatting"
1313
- "VS.ToolsOptionsPages.Text_Editor.CSharp.Formatting.General"
14+
- "VS.ToolsOptionsPages.Text_Editor.CSharp.Code_Style.Formatting.General"
1415
helpviewer_keywords:
1516
- "formatting options [C#]"
1617
- "Text editor Options dialog box, formatting"
@@ -20,7 +21,7 @@ manager: douge
2021
ms.workload:
2122
- "dotnet"
2223
---
23-
# Options, Text Editor, C#, Formatting
24+
# Options, Text Editor, C#, Code Style, Formatting
2425

2526
Use the **Formatting** options page to set options for formatting code in the code editor. To access this options page, choose **Tools** > **Options**. In the **Options** dialog box, choose **Text Editor** > **C#** > **Code Style** > **Formatting**.
2627

docs/ide/reference/options-text-editor-file-extension.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ ms.prod: visual-studio-dev15
55
ms.technology: vs-ide-general
66
ms.topic: reference
77
f1_keywords:
8-
- "vs.toolsoptionspages.text_editor.file_extension"
8+
- "VS.ToolsOptionsPages.Text_Editor.File_Extension"
99
helpviewer_keywords:
1010
- "file extensions, associating to editor"
1111
- "Editing Experience"

docs/ide/reference/options-text-editor-general.md

Lines changed: 0 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -89,14 +89,6 @@ When selected, displays a vertical margin along the left edge of the editor's te
8989

9090
When selected, displays a vertical margin outside the left edge of the editor's text area. When you click in this margin, an icon and ToolTip that are related to the text appear. For example, breakpoint or task list shortcuts appear in the indicator margin. Indicator Margin information does not print.
9191

92-
### Vertical scroll bar
93-
94-
When selected, displays a vertical scrollbar which allows you to scroll up and down to view elements that fall outside the viewing area of the Editor. If vertical scrollbars are not available, you can use the Page Up, Page Down and cursor keys to scroll.
95-
96-
### Horizontal scroll bar
97-
98-
When selected, displays a horizontal scrollbar which allows you to scroll from side-to-side to view elements that fall outside the viewing area of the Editor. If horizontal scrollbars are unavailable, you can use the cursor keys to scroll.
99-
10092
### Highlight current line
10193

10294
When selected, displays a gray box around the line of code in which the cursor is located.

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

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,9 @@ f1_keywords:
88
- "VS.ToolsOptionsPages.Text_Editor.JavaScript.Formatting.Spacing"
99
- "VS.ToolsOptionsPages.Text_Editor.JavaScript.Formatting.General"
1010
- "VS.ToolsOptionsPages.Text_Editor.JavaScript.Formatting.New_Lines"
11+
- "VS.ToolsOptionsPages.Text_Editor.TypeScript.Formatting.Spacing"
12+
- "VS.ToolsOptionsPages.Text_Editor.TypeScript.Formatting.General"
13+
- "VS.ToolsOptionsPages.Text_Editor.TypeScript.Formatting.New_Lines"
1114
ms.assetid: 28a0aef1-9353-4d94-95a5-54b42e15c0dc
1215
author: gewarren
1316
ms.author: gewarren

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

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ ms.topic: reference
77
f1_keywords:
88
- "VS.ToolsOptionsPages.Text_Editor.JavaScript.Intellisense.References"
99
- "VS.ToolsOptionsPages.Text_Editor.JavaScript.Intellisense.General"
10+
- "VS.ToolsOptionsPages.Text_Editor.TypeScript.IntelliSense.General"
1011
ms.assetid: b4a9816d-cf87-4dc6-a8d4-1591d6a48103
1112
author: gewarren
1213
ms.author: gewarren

0 commit comments

Comments
 (0)