Skip to content

Commit c6c8f64

Browse files
author
Colin Robertson
authored
Merge pull request MicrosoftDocs#1604 from MicrosoftDocs/master637056427719417156
Fix git push error for protected CLA branch
2 parents 7cd4fdd + 4517932 commit c6c8f64

13 files changed

+46
-36
lines changed

docs/build/reference/analyze-code-analysis.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "/analyze (Code Analysis)"
3-
ms.date: "04/26/2018"
3+
ms.date: "10/01/2019"
44
f1_keywords: ["VC.Project.VCCLCompilerTool.EnablePREfast", "/analyze", "VC.Project.VCCLCompilerTool.PREfastAdditionalOptions", "VC.Project.VCCLCompilerTool.PREfastAdditionalPlugins"]
55
helpviewer_keywords: ["/analyze compiler option [C++]", "-analyze compiler option [C++]", "analyze compiler option [C++]"]
66
ms.assetid: 81da536a-e030-4bd4-be18-383927597d08
@@ -30,7 +30,7 @@ Detailed analyzer results are written as XML to the file that is specified by `f
3030
Turns off analyzer output to the **Output** window.
3131

3232
/analyze:stacksize `number`
33-
The `number` parameter that is used with this option specifies the size, in bytes, of the stack frame for which warning [C6262](/visualstudio/code-quality/c6262) is generated. If this parameter is not specified, the stack frame size is 16KB by default.
33+
The `number` parameter that is used with this option specifies the size, in bytes, of the stack frame for which warning [C6262](/visualstudio/code-quality/c6262) is generated. The space before `number` is optional. If this parameter is not specified, the stack frame size is 16KB by default.
3434

3535
/analyze:max_paths `number`
3636
The `number` parameter that is used with this option specifies the maximum number of code paths to be analyzed. If this parameter is not specified, the number is 256 by default. Larger values perform more thorough checking, but the analysis might take longer.

docs/cppcx/platform-collections-map-class.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -280,6 +280,6 @@ The number of elements in the Map.
280280

281281
## See also
282282

283-
[Collections (C++/CX)](collections-c-cx)<br/>
283+
[Collections (C++/CX)](collections-c-cx.md)<br/>
284284
[Platform Namespace](platform-namespace-c-cx.md)<br/>
285285
[Creating Windows Runtime Components in C++](/windows/uwp/winrt-components/creating-windows-runtime-components-in-cpp)

docs/cppcx/platform-collections-vector-class.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -370,6 +370,6 @@ The last element in a sequence of objects that are used to initialize the curren
370370
371371
## See also
372372
373-
[Collections (C++/CX)](collections-c-cx)<br/>
373+
[Collections (C++/CX)](collections-c-cx.md)<br/>
374374
[Platform Namespace](platform-namespace-c-cx.md)<br/>
375375
[Creating Windows Runtime Components in C++](/windows/uwp/winrt-components/creating-windows-runtime-components-in-cpp)

docs/cppcx/platform-guid-value-class.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.assetid: 25c0bfb2-7f93-44d8-bdf4-ef4fbac3424a
88
---
99
# Platform::Guid value class
1010

11-
Represents a [GUID](/previous-versions/aa373931\(v=vs.80\)) type in the Windows Runtime type system.
11+
Represents a [GUID](/previous-versions/cc317743(v%3dmsdn.10)) type in the Windows Runtime type system.
1212

1313
## Syntax
1414

@@ -107,7 +107,7 @@ The next byte of the `GUID`.
107107
The next byte of the `GUID`.
108108

109109
*m*<br/>
110-
A `GUID` in the form a [GUID structure](/previous-versions/aa373931\(v=vs.80\)).
110+
A `GUID` in the form a [GUID structure](/previous-versions/cc317743(v%3dmsdn.10)).
111111

112112
*n*<br/>
113113
The remaining 8 bytes of the `GUID`.
@@ -187,7 +187,7 @@ This operator is provided so that `Guid` objects can be more easily consumed by
187187

188188
## <a name="operator-call"></a> Guid::operator() Operator
189189

190-
Implicitly converts a `Platform::Guid` to a [GUID structure](/previous-versions/aa373931\(v=vs.80\)).
190+
Implicitly converts a `Platform::Guid` to a [GUID structure](/previous-versions/cc317743(v%3dmsdn.10)).
191191

192192
### Syntax
193193

@@ -197,7 +197,7 @@ const GUID& Platform::Guid::operator();
197197

198198
### Return Value
199199

200-
A [GUID structure](/previous-versions/aa373931\(v=vs.80\)).
200+
A [GUID structure](/previous-versions/cc317743(v%3dmsdn.10)).
201201

202202
## See also
203203

docs/ide/how-to-set-preferences.md

Lines changed: 35 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,78 +1,88 @@
11
---
22
title: "Set your C++ coding preferences in Visual Studio"
3-
ms.description: "Customize C++ formatting, colors, layout, line numbers, menus and more in the Visual Studio IDE."
3+
ms.description: "Customize C++ formatting, colors, layout, line numbers, and menus in the Visual Studio IDE."
44
ms.topic: "overview"
55
ms.date: "09/27/2019"
66
---
77

88
# Set your C++ coding preferences in Visual Studio
99

10-
You can make your C++ coding experience more convenient, productive and pleasurable by personalizing Visual Studio. You can customize the menus and toolbars, arrange the window layout, set color themes, specify C++ formatting rules, including several flavors of ClangFormat, and create custom keyboard shortcuts. You can synchronize your preferences across multiple machines, and create and store multiple sets of preferences and share them with teammates. You can install extensions from the Visual Studio Marketplace which provide additional custom behavior. Many of these options are documented under [Personalize the Visual Studio IDE](/visualstudio/ide/personalizing-the-visual-studio-ide).
10+
You can make your C++ coding experience more convenient, productive, and pleasurable by personalizing Visual Studio. You can:
11+
12+
- Customize the menus and toolbars.
13+
- Arrange the window layout.
14+
- Set color themes.
15+
- Specify C++ formatting rules, including several styles of ClangFormat.
16+
- Create custom keyboard shortcuts.
17+
18+
You can synchronize your preferences across multiple machines, and create and store multiple sets of preferences and share them with teammates. You can install extensions from the Visual Studio Marketplace, giving you additional options for customizing behavior. For more information, see [Personalize the Visual Studio IDE](/visualstudio/ide/personalizing-the-visual-studio-ide).
1119

1220
## Arrange window layout
1321

14-
Within the Visual Studio window, the space is divided into the main menu, the toolbar, the code editor (or document window), and tool windows (**Solution Explorer**, **Error List**, and so on). Some windows overlap each other in the same position. For example, **Solution Explorer**, **Class View**, **Resource View**, and **Source Control Explorer** all share the same default position. You switch between them by clicking on the tabs at the bottom of the frame. To make two or more of these windows visible at the same time, just drag one of them by its title bar to a new position. You can dock it against one of the Visual Studio main window borders, or you can float it. The following illustration shows the **Team Explorer** window in the process of being dragged from its default position to a new docked position on the left side of the code editor. The blue shaded area shows where the window will be placed when the mouse button is released.
22+
Within the Visual Studio window, the space is divided into the main menu, the toolbar, the code editor (or document window), and tool windows (such as Solution Explorer and Error List). Some windows overlap each other in the same position. For example, Solution Explorer, Class View, Resource View, and Source Control Explorer all share the same default position. You switch among them by selecting the tabs at the bottom of the frame. To make two or more of these windows visible at the same time, just drag one of them by its title bar to a new position. You can dock it against one of the Visual Studio main window borders, or you can float it.
23+
24+
The following screenshot shows the **Team Explorer** window being dragged from its default position to a new, docked position on the left side of the code editor. The blue shaded area shows where the window will be placed when the mouse button is released.
1525

16-
![Modifying window layout](media/window-layout-move-team-explorer.png)
26+
![Screenshot of Visual Studio Team Explorer window, with layout change highlighted](media/window-layout-move-team-explorer.png)
1727

18-
In the document window, each open file is contained in a tabbed frame. You can float or lock these tabs just like tool windows. For more information, see [Customize window layouts in Visual Studio](/visualstudio/ide/customizing-window-layouts-in-visual-studio).
28+
In the document window, each open file is contained in a tabbed frame. You can float or lock these tabs, just like tool windows. For more information, see [Customize window layouts in Visual Studio](/visualstudio/ide/customizing-window-layouts-in-visual-studio).
1929

2030
To hide all the tool windows and maximize the Code Editor window, press **Alt** + **Shift** + **Enter** to toggle *full-screen mode*.
2131

2232
## Set C++ coding styles and formatting
2333

24-
You can specify many individual code formatting options such as indentation and brace positions by navigating to **Tools** > **Options** > **Text Editor** > **C/C++** > **Formatting** (or type **Ctrl + Q** and search for "Formatting"). Alternatively, you can specify one of the [ClangFormat](https://clang.llvm.org/docs/ClangFormat.html) styles (or your own custom ClangFormat style):
34+
You can specify many individual code formatting options, such as indentation and brace positions. To do so, go to **Tools** > **Options** > **Text Editor** > **C/C++** > **Formatting** (or type **Ctrl + Q** and search for "Formatting"). Alternatively, you can specify one of the [ClangFormat](https://clang.llvm.org/docs/ClangFormat.html) styles (or your own custom ClangFormat style).
2535

26-
![ClangFormat options](media/clang-format-ide.png)
36+
![Screenshot of ClangFormat options](media/clang-format-ide.png)
2737

2838
For more information about all the formatting options, see [Options, Text Editor, C/C++, Formatting](/visualstudio/ide/reference/options-text-editor-c-cpp-formatting).
2939

3040
## Set the color theme
3141

32-
To set a light or dark background, type **Ctrl + Q** and search for "Color Theme". You can also get there via **Tools** > **Options** > **Environment** and choose **Color Theme**:
42+
To set a light or dark background, type **Ctrl + Q** and search for "Color Theme". You can also find these by going to **Tools** > **Options** > **Environment**, and choosing **Color Theme**.
3343

34-
![Color themes](media/tools-options-color-theme.png)
44+
![Screenshot of color themes](media/tools-options-color-theme.png)
3545

36-
The following image shows the dark theme:
46+
For example, here's the dark theme:
3747

38-
![Dark theme](media/tools-options-dark-theme.png)
48+
![Screenshot of Visual Studio with dark color theme](media/tools-options-dark-theme.png)
3949

4050
## Customize code colorization
4151

42-
In Visual Studio 2019 you can choose from three predefined *color schemes* which specify how code elements are colorized in the editor. To choose a theme, navigate to **Tools** > **Options** > **Text Editor** > **C/C++** > **View** and choose **Color Scheme**:
52+
In Visual Studio 2019, you can choose from three predefined *color schemes*. These specify how code elements are colorized in the editor. To choose a theme, go to **Tools** > **Options** > **Text Editor** > **C/C++** > **View**, and choose **Color Scheme**:
4353

44-
![C++ Color Schemes](media/color-schemes.png)
54+
![Screenshot of C++ Color Scheme options, with Enhanced highlighted](media/color-schemes.png)
4555

46-
In the **Visual Studio 2017** color scheme, most code elements are simply black. In the **Enhanced** color scheme, functions, local variables, macros, and other elements are colorized. In the **Enhanced (Globals vs. Members)** scheme, global functions and variables are colorized to contrast with class members. The default mode is **Enhanced** and it looks like this:
56+
In the color scheme called **Visual Studio 2017**, most code elements are simply black. In the **Enhanced** color scheme, functions, local variables, macros, and other elements are colorized. In the **Enhanced (Globals vs. Members)** scheme, global functions and variables are colorized to contrast with class members. The default mode is **Enhanced**, and it looks like this:
4757

48-
![Enhanced Color Scheme](media/color-scheme-enhanced.png)
58+
![Screenshot of enhanced color scheme](media/color-scheme-enhanced.png)
4959

50-
Regardless of which theme or color scheme is active, you can customize the font and colors for individual code elements by navigating to **Tools** > **Options** > **Environment** > **Fonts and Colors** (or type **Ctrl + Q** and search for "Fonts"). Scroll down the list of display items until you see the C++ options:
60+
Regardless of which theme or color scheme is active, you can customize the font and colors for individual code elements. To do this, go to **Tools** > **Options** > **Environment** > **Fonts and Colors** (or type **Ctrl + Q** and search for "Fonts"). Scroll down the list of display items until you see the C++ options.
5161

52-
![C++ font and color options](media/tools-options-cpp-colors.png)
62+
![Screenshot of C++ font and color options](media/tools-options-cpp-colors.png)
5363

54-
Colors that you set here override the values defined for the color schemes. You have to set a color back to **Default** if you have changed it but want to use the default colors for the color scheme.
64+
Colors that you set here override the values defined for the color schemes. If you want to go back to the default colors for the color scheme, set a color back to **Default**.
5565

5666
## Customize the toolbars
5767

58-
The toolbars provide a convenient way to issue commands with a single mouse-click, rather than using the menus or keyboard shortcuts. Visual Studio includes a standard set of toolbars. For standard C++ development, the most useful toolbars are probably Standard, Text Editor, Build, Debug, Source Control, and possibly Compare Files. For Windows development, the Dialog Editor and Image Editor are useful for laying out dialogs and editing icons.
68+
The toolbars provide a convenient way to issue commands with a single click, rather than by using the menus or keyboard shortcuts. Visual Studio includes a standard set of toolbars. For standard C++ development, the most useful toolbars are probably Standard, Text Editor, Build, Debug, Source Control, and Compare Files. For Windows development, the Dialog Editor and Image Editor are useful for laying out dialog boxes and editing icons.
5969

6070
Hover over the icons in the toolbar to see which command it represents:
6171

62-
![Toolbar QuickInfo](media/toolbar-mouse-hover.png)
72+
![Screenshot of toolbar icons, with example of command information available on hover](media/toolbar-mouse-hover.png)
6373

64-
You can add or remove commands or create a custom toolbar by clicking the down-arrow. To move the toolbar to a new location, drag it by the dotted bar on the left:
74+
You can add or remove commands, or create a custom toolbar, by selecting the down-arrow. To move the toolbar to a new location, drag it by the dotted bar on the left.
6575

66-
![Customize or move a toolbar](media/toolbar-move-edit.png).
76+
![Screenshot of toolbar, with down-arrow and dotted bar highlighted](media/toolbar-move-edit.png).
6777

6878
For more information, see [How to: Customize menus and toolbars in Visual Studio](/visualstudio/ide/how-to-customize-menus-and-toolbars-in-visual-studio).
6979

7080
## Show or hide line numbers
7181

72-
To specify whether line numbers show on the left of the editor windows, navigate to and check or un-check **Line Numbers**:
82+
You can specify whether line numbers show on the left of the editor windows. In **Options**, under **C/C++**, select **General**. In the **Settings** section, select or clear **Line numbers**, depending on your preference.
7383

74-
![Line numbers](media/tools-options-line-numbers.png)
84+
![Screenshot of General options, with Line numbers highlighted](media/tools-options-line-numbers.png)
7585

7686
## Create keyboard shortcuts
7787

78-
All commands in Visual Studio can be made with keyboard shortcuts using various combinations of keys with the Ctrl, Alt and Shift keys. You can create your own shortcuts by navigating to **Tools** > **Options** > **Environment** > **Keyboard** (or type **Ctrl + Q** and search for "shortcuts"). For more information, see [Identify and customize keyboard shortcuts in Visual Studio](/visualstudio/ide/identifying-and-customizing-keyboard-shortcuts-in-visual-studio).
88+
Many commands in Visual Studio have *keyboard shortcuts*, key combinations with the Ctrl, Alt, and Shift keys. You can modify these keyboard shortcuts or create new ones of your own in Visual Studio. Go to **Tools** > **Options** > **Environment** > **Keyboard** (or type **Ctrl + Q** and search for "shortcuts"). For more information, see [Identify and customize keyboard shortcuts in Visual Studio](/visualstudio/ide/identifying-and-customizing-keyboard-shortcuts-in-visual-studio).
10.4 KB
Loading

docs/ide/media/color-schemes.png

12.6 KB
Loading
-826 Bytes
Loading
407 Bytes
Loading
15.3 KB
Loading

0 commit comments

Comments
 (0)