Merge pull request #1220 from msebolt/windows-formatting-review-pr36

TrishaMc · web-flow · commit ac17c9bec913 · 2018-08-08T12:15:56.000-07:00
windows formatting review pr36
diff --git a/docs/windows/mutextraits-structure.md b/docs/windows/mutextraits-structure.md
@@ -17,7 +17,7 @@ Defines common characteristics of the [Mutex](../windows/mutex-class1.md) class.
   
 ## Syntax  
   
-```  
+```cpp  
 struct MutexTraits : HANDLENullTraits;  
 ```  
   
diff --git a/docs/windows/mutextraits-unlock-method.md b/docs/windows/mutextraits-unlock-method.md
@@ -17,7 +17,7 @@ Releases exclusive control of a shared resource.
   
 ## Syntax  
   
-```  
+```cpp  
 inline static void Unlock(  
    _In_ Type h  
 );  
diff --git a/docs/windows/new-custom-resource-dialog-box.md b/docs/windows/new-custom-resource-dialog-box.md
@@ -15,7 +15,7 @@ ms.workload: ["cplusplus", "uwp"]
 # New Custom Resource Dialog Box
 Enables you to create a new custom resource.  
   
- **Resource Type**  
+### Resource Type  
  Provides a text box for you to enter the name of a custom resource type. Visual C++ automatically capitalizes the name when you exit the **New Custom Resource** dialog box.  
   
 ## Remarks  
diff --git a/docs/windows/new-device-image-type-dialog-box-image-editor-for-icons.md b/docs/windows/new-device-image-type-dialog-box-image-editor-for-icons.md
@@ -15,7 +15,7 @@ ms.workload: ["cplusplus", "uwp"]
 # New &lt;Device&gt; Image Type Dialog Box (Image Editor for Icons)
 Enables you to create a new device image of a specified type. To open the **New \<Device> Image** dialog box, click **New Image Type** on the **Image** menu.  
   
- **Target Image Type**  
+### Target Image Type  
  Lists the available image types. Select the image type you want to open:  
   
 ||||  
@@ -30,7 +30,7 @@ Enables you to create a new device image of a specified type. To open the **New
 > [!NOTE]
 >  Any existing images will not be displayed in this list.  
   
- **Custom**  
+### Custom  
  Opens the [Custom Image dialog box](custom-image-dialog-box-image-editor-for-icons.md) in which you can create a new image with a custom size and number of colors.  
   
 ## Requirements  
@@ -39,4 +39,4 @@ Enables you to create a new device image of a specified type. To open the **New
 ## See Also  
  [Icons and Cursors: Image Resources for Display Devices](../windows/icons-and-cursors-image-resources-for-display-devices-image-editor-for-icons.md)   
  [Image Menu](../windows/image-menu-image-editor-for-icons.md)   
- [Image Editor for Icons](../windows/image-editor-for-icons.md)
+ [Image Editor for Icons](../windows/image-editor-for-icons.md)
diff --git a/docs/windows/new-new-slot-in-vtable-cpp-component-extensions.md b/docs/windows/new-new-slot-in-vtable-cpp-component-extensions.md
@@ -85,8 +85,6 @@ int main() {
 }  
 ```  
   
- **Output**  
-  
 ```Output  
 C::f() called  
   
diff --git a/docs/windows/new-toolbar-resource-dialog-box.md b/docs/windows/new-toolbar-resource-dialog-box.md
@@ -13,14 +13,14 @@ ms.author: "mblome"
 ms.workload: ["cplusplus", "uwp"]
 ---
 # New Toolbar Resource Dialog Box
-The New Toolbar Resource dialog box allows you to specify the width and height of the buttons you are adding to a toolbar resource. The default is 16 × 15 pixels.  
+The **New Toolbar Resource** dialog box allows you to specify the width and height of the buttons you are adding to a toolbar resource. The default is 16 × 15 pixels.  
   
  A bitmap that is used to create a toolbar has a maximum width of 2048. So if you set the **Button Width** to 512, you can only have four buttons. If you set the width to 513, you can only have three buttons.  
   
- **Button Width**  
+### Button Width  
  Provides a space for you to enter the width for the toolbar buttons you are converting from a bitmap resource to a toolbar resource. The images are cropped to the width and height specified, and the colors are adjusted to use standard toolbar colors (16 colors).  
   
- **Button Height**  
+### Button Height  
  Provides a space for you to enter the height for the toolbar buttons you are converting from a bitmap resource to a toolbar resource. The images are cropped to the width and height specified, and the colors are adjusted to use standard toolbar colors (16 colors).  
   
  For information on adding resources to managed projects, please see [Resources in Desktop Apps](/dotnet/framework/resources/index) in the *.NET Framework Developer's Guide*. For information on manually adding resource files to managed projects, accessing resources, displaying static resources, and assigning resource strings to properties, see [Creating Resource Files for Desktop Apps](/dotnet/framework/resources/creating-resource-files-for-desktop-apps). For information on globalization and localization of resources in managed apps, see [Globalizing and Localizing .NET Framework Applications](/dotnet/standard/globalization-localization/index).  
diff --git a/docs/windows/nil-structure.md b/docs/windows/nil-structure.md
@@ -16,7 +16,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 struct Nil;  
 ```  
   
diff --git a/docs/windows/no-injected-text.md b/docs/windows/no-injected-text.md
@@ -17,13 +17,13 @@ Prevents the compiler from injecting code as a result of attribute use.
   
 ## Syntax  
   
-```  
+```cpp  
 [ no_injected_text(  
    boolean  
 ) ];  
 ```  
   
-#### Parameters  
+### Parameters  
  *boolean* (optional)  
  **true** if you want no code injected, **false** to allow code to be injected. **true** is the default.  
   
diff --git a/docs/windows/nonbrowsable.md b/docs/windows/nonbrowsable.md
@@ -17,7 +17,7 @@ Indicates that an interface member should not be displayed in a property browser
   
 ## Syntax  
   
-```  
+```cpp  
 [nonbrowsable]  
 ```  
   
diff --git a/docs/windows/noncreatable.md b/docs/windows/noncreatable.md
@@ -17,7 +17,7 @@ Defines an object that cannot be instantiated by itself.
   
 ## Syntax  
   
-```  
+```cpp  
 [noncreatable]  
 ```  
   
diff --git a/docs/windows/nonextensible.md b/docs/windows/nonextensible.md
@@ -17,7 +17,7 @@ Specifies that the `IDispatch` implementation includes only the properties and m
   
 ## Syntax  
   
-```  
+```cpp  
 [nonextensible]  
 ```  
   
diff --git a/docs/windows/nullptr-cpp-component-extensions.md b/docs/windows/nullptr-cpp-component-extensions.md
@@ -104,8 +104,6 @@ int main() {
 }  
 ```  
   
- **Output**  
-  
 ```Output  
 pMyClass == nullptr  
   
@@ -172,8 +170,6 @@ int main() {
 }  
 ```  
   
- **Output**  
-  
 ```Output  
 test  
 ```  
@@ -201,8 +197,6 @@ int main() {
 }  
 ```  
   
- **Output**  
-  
 ```Output  
 NULL  
 ```  
diff --git a/docs/windows/object-cpp.md b/docs/windows/object-cpp.md
@@ -17,7 +17,7 @@ Identifies a custom interface.
   
 ## Syntax  
   
-```  
+```cpp  
 [object]  
 ```  
   
diff --git a/docs/windows/odl.md b/docs/windows/odl.md
@@ -17,7 +17,7 @@ Identifies an interface as an Object Description Language (ODL) interface. The M
   
 ## Syntax  
   
-```  
+```cpp  
 [odl]  
 ```  
   
diff --git a/docs/windows/oleautomation.md b/docs/windows/oleautomation.md
@@ -17,7 +17,7 @@ Indicates that an interface is compatible with Automation.
   
 ## Syntax  
   
-```  
+```cpp  
 [oleautomation]  
 ```  
   
diff --git a/docs/windows/open-device-image-dialog-box-image-editor-for-icons.md b/docs/windows/open-device-image-dialog-box-image-editor-for-icons.md
@@ -15,13 +15,12 @@ ms.workload: ["cplusplus", "uwp"]
 # Open &lt;Device&gt; Image Dialog Box (Image Editor for Icons)
 Use this dialog box to open device images. It lists existing device images in the current resource (images that are part of the current resource).  
   
- **Current Images**  
+### Current Images  
  Lists the images included in the resource. Select the image type you want to open.  
   
 ## Requirements  
  None  
   
 ## See Also  
  [Image Menu](../windows/image-menu-image-editor-for-icons.md)   
- [Image Editor for Icons](../windows/image-editor-for-icons.md)
-
+ [Image Editor for Icons](../windows/image-editor-for-icons.md)
diff --git a/docs/windows/opening-a-resource-for-binary-editing.md b/docs/windows/opening-a-resource-for-binary-editing.md
@@ -23,7 +23,7 @@ ms.workload: ["cplusplus", "uwp"]
 2.  Right-click the resource and click **Open Binary Data** from the shortcut menu.  
   
     > [!NOTE]
-    >  If you use the [Resource View](../windows/resource-view-window.md) window to open a resource with a format that Visual Studio does not recognize (such as RCDATA or a custom resource), the resource is automatically opened in the Binary editor.  
+    >  If you use the [Resource View](../windows/resource-view-window.md) window to open a resource with a format that Visual Studio does not recognize (such as RCDATA or a custom resource), the resource is automatically opened in the **Binary** editor.  
   
 ### To open a managed resource for binary editing  
   
@@ -45,10 +45,9 @@ Binary Data for a Dialog Box Displayed in the Binary Editor
  Only certain ASCII values are represented in the Binary editor (0x20 through 0x7E). Extended characters are displayed as periods in the ASCII Value section of the Binary editor (the right panel). The "printable" characters are ASCII values 32 through 126.  
   
 > [!NOTE]
->  If you want to use the Binary editor on a resource already being edited in another editor window, close the other editor window first.  
+>  If you want to use the **Binary** editor on a resource already being edited in another editor window, close the other editor window first.  
   
 ## Requirements  
-  
  None  
   
 ## See Also  
diff --git a/docs/windows/opening-the-resource-editor-for-a-given-symbol.md b/docs/windows/opening-the-resource-editor-for-a-given-symbol.md
@@ -28,7 +28,6 @@ When you are browsing symbols in the [Resource Symbols dialog box](../windows/re
  For information on adding resources to managed projects, please see [Resources in Desktop Apps](/dotnet/framework/resources/index) in the *.NET Framework Developer's Guide*.  
   
 ## Requirements  
-  
  Win32  
   
 ## See Also  
diff --git a/docs/windows/operator-equality-operator-microsoft-wrl.md b/docs/windows/operator-equality-operator-microsoft-wrl.md
@@ -16,7 +16,7 @@ Equality operator for [ComPtr](../windows/comptr-class.md) and [ComPtrRef](../wi
   
 ## Syntax  
   
-```  
+```cpp  
 WRL_NOTHROW bool operator==(  
    const ComPtr<T>& a,  
    const ComPtr<U>& b  
diff --git a/docs/windows/operator-inequality-operator-microsoft-wrl.md b/docs/windows/operator-inequality-operator-microsoft-wrl.md
@@ -16,7 +16,7 @@ Inequality operator for [ComPtr](../windows/comptr-class.md) and [ComPtrRef](../
   
 ## Syntax  
   
-```  
+```cpp  
 WRL_NOTHROW bool operator!=(  
    const ComPtr<T>& a,  
    const ComPtr<U>& b  
diff --git a/docs/windows/optional-cpp.md b/docs/windows/optional-cpp.md
@@ -17,7 +17,7 @@ Specifies an optional parameter for a member function.
   
 ## Syntax  
   
-```  
+```cpp  
 [optional]  
 ```  
   
diff --git a/docs/windows/out-cpp.md b/docs/windows/out-cpp.md
@@ -17,7 +17,7 @@ Identifies pointer parameters that are returned from the called procedure to the
   
 ## Syntax  
   
-```  
+```cpp  
 [out]  
 ```  
   
diff --git a/docs/windows/overview-of-windows-programming-in-cpp.md b/docs/windows/overview-of-windows-programming-in-cpp.md
@@ -29,7 +29,7 @@ You can write UWP apps in C++/CX, a dialect of C++, you can use the [C++/WinRT l
 
    This category also includes using C++ for core components and computational code in the context of server and cloud programming. Sometimes the performance-intensive code at the core of a server or cloud application is written in C++ to maximize performance. You can compile such code into a DLL and use it from C# or Visual Basic.
 
-- **.NET Framework applications**. Most .NET Framework applications are written in C# or Visual Basic, but you can also C++/CLI (the /clr compiler option in Visual C++). We recommend using C++/CLI for a minimal interop layer in a larger application that includes managed and native code.
+- **.NET Framework applications**. Most .NET Framework applications are written in C# or Visual Basic, but you can also C++/CLI (the `/clr` compiler option in Visual C++). We recommend using C++/CLI for a minimal interop layer in a larger application that includes managed and native code.
 
 ##  <a name="BK_WindowsUniversal"></a> Windows Universal Apps
 
diff --git a/docs/windows/picking-up-a-color-from-an-image-to-use-elsewhere-image-editor-for-icons.md b/docs/windows/picking-up-a-color-from-an-image-to-use-elsewhere-image-editor-for-icons.md
@@ -25,14 +25,13 @@ The **Select Color**, or color-pickup, tool makes any color on the image the cur
 2.  Select the color you want to pick up from the image.  
   
     > [!NOTE]
-    >  After you pick up a color, the Image editor reactivates the most recently used tool.  
+    >  After you pick up a color, the **Image** editor reactivates the most recently used tool.  
   
 3.  Draw using the left mouse button for the foreground color, or the right mouse button for the background color.  
   
  For information on adding resources to managed projects, please see [Resources in Desktop Apps](/dotnet/framework/resources/index) in the *.NET Framework Developer's Guide*. For information on manually adding resource files to managed projects, accessing resources, displaying static resources, and assigning resource strings to properties, see [Creating Resource Files for Desktop Apps](/dotnet/framework/resources/creating-resource-files-for-desktop-apps). For information on globalization and localization of resources in managed apps, see [Globalizing and Localizing .NET Framework Applications](/dotnet/standard/globalization-localization/index).  
   
 ## Requirements  
-  
  None  
   
 ## See Also  
diff --git a/docs/windows/pin-ptr-cpp-cli.md b/docs/windows/pin-ptr-cpp-cli.md
@@ -131,8 +131,6 @@ int main() {
 }  
 ```  
   
- **Output**  
-  
 ```Output  
 45  
 ```  
@@ -167,8 +165,6 @@ int main() {
 };  
 ```  
   
- **Output**  
-  
 ```Output  
 1  
 ```  
@@ -197,8 +193,6 @@ int main() {
 }  
 ```  
   
- **Output**  
-  
 ```Output  
 8  
 255  
diff --git a/docs/windows/platform-default-and-cli-namespaces-cpp-component-extensions.md b/docs/windows/platform-default-and-cli-namespaces-cpp-component-extensions.md
@@ -27,7 +27,7 @@ A namespace qualifies the names of language elements so the names do not conflic
 ## Common Language Runtime 
 ### Syntax  
   
-```  
+```cpp  
 using namespace cli;  
 ```  
   
diff --git a/docs/windows/pointer-default.md b/docs/windows/pointer-default.md
@@ -17,13 +17,13 @@ Specifies the default pointer attribute for all pointers, except top-level point
   
 ## Syntax  
   
-```  
+```cpp  
 [ pointer_default(  
    value  
 ) ]  
 ```  
   
-#### Parameters  
+### Parameters  
  *value*  
  A value that describes the pointer type: **ptr**, **ref**, or **unique**.  
   
diff --git a/docs/windows/pragma.md b/docs/windows/pragma.md
@@ -17,13 +17,13 @@ Emits the specified string into the generated .idl file without the use of quota
   
 ## Syntax  
   
-```  
+```cpp  
 [ pragma(  
    pragma_statement  
 ) ];  
 ```  
   
-#### Parameters  
+### Parameters  
  *pragma_statement*  
  The pragma that you want to go into the generated .idl file.  
   
diff --git a/docs/windows/predefined-symbol-ids.md b/docs/windows/predefined-symbol-ids.md
@@ -27,8 +27,6 @@ When you begin a new project, depending on the project type, some symbol IDs are
     > [!NOTE]
     >  Predefined symbols are always read-only.  
   
-
-  
 ## Requirements  
  Win32, MFC, or ATL  
   
diff --git a/docs/windows/previewing-resources.md b/docs/windows/previewing-resources.md
@@ -33,22 +33,22 @@ Previewing your resources allows you to view graphical resource without opening
   
 ### To preview resources  
   
-1.  In [Resource View](../windows/resource-view-window.md) or a document window, select your resource, for example, IDD_ABOUTBOX.  
+1.  In [Resource View](../windows/resource-view-window.md) or a document window, select your resource, for example, **IDD_ABOUTBOX**.  
   
-     **Note** If your project doesn't already contain an .rc file, please see [Creating a New Resource Script File](../windows/how-to-create-a-resource-script-file.md).  
+     > [!NOTE]
+     > If your project doesn't already contain an .rc file, please see [Creating a New Resource Script File](../windows/how-to-create-a-resource-script-file.md).  
   
 2.  In the [Properties window](/visualstudio/ide/reference/properties-window), click the **Property Pages** button.  
   
      \- or -  
   
 3.  On the **View** menu, click **Property Pages**.  
   
-     The Property Page for the resource opens displaying a preview of that resource. You can then use the Up and Down arrow keys to navigate the tree control in Resource View or the document window. The Property Page will stay open and show any resource that has focus and is able to be previewed.  
+     The **Property Page** for the resource opens displaying a preview of that resource. You can then use the **Up** and **Down** arrow keys to navigate the tree control in **Resource View** or the document window. The **Property Page** will stay open and show any resource that has focus and is able to be previewed.  
   
  For information on adding resources to managed projects, please see [Resources in Desktop Apps](/dotnet/framework/resources/index) in the *.NET Framework Developer's Guide*. For information on manually adding resource files to managed projects, accessing resources, displaying static resources, and assigning resource strings to properties, see [Creating Resource Files for Desktop Apps](/dotnet/framework/resources/creating-resource-files-for-desktop-apps). For information on globalization and localization of resources in managed apps, see [Globalizing and Localizing .NET Framework Applications](/dotnet/standard/globalization-localization/index).  
   
 ## Requirements 
-  
  Win32  
   
 ## See Also  
diff --git a/docs/windows/progid.md b/docs/windows/progid.md
diff --git a/docs/windows/property-cpp-component-extensions.md b/docs/windows/property-cpp-component-extensions.md
diff --git a/docs/windows/propget.md b/docs/windows/propget.md
diff --git a/docs/windows/propput.md b/docs/windows/propput.md
diff --git a/docs/windows/propputref.md b/docs/windows/propputref.md
diff --git a/docs/windows/ptr.md b/docs/windows/ptr.md
diff --git a/docs/windows/public-cpp-attributes.md b/docs/windows/public-cpp-attributes.md
diff --git a/docs/windows/purpose-of-attributes.md b/docs/windows/purpose-of-attributes.md
diff --git a/docs/windows/raiseexception-function.md b/docs/windows/raiseexception-function.md
diff --git a/docs/windows/range-cpp.md b/docs/windows/range-cpp.md

Original file line number	Diff line number	Diff line change
`@@ -85,8 +85,6 @@ int main() {`
`85`	`85`	`}`
`86`	`86`	```
`87`	`87`
`88`		`- Output`
`89`		`-`
`90`	`88`	```Output
`91`	`89`	`C::f() called`
`92`	`90`