Merge pull request #1224 from msebolt/windows-formatting-review-pr39

GitHubber17 · web-flow · commit 7bddf530269d · 2018-08-08T13:44:24.000-07:00
windows formatting review pr39
diff --git a/docs/windows/specifying-the-location-and-size-of-a-dialog-box.md b/docs/windows/specifying-the-location-and-size-of-a-dialog-box.md
@@ -14,7 +14,7 @@ ms.workload: ["cplusplus", "uwp"]
 # Specifying the Location and Size of a Dialog Box
 The location and size of a dialog box, as well as the location and size of controls within it, are measured in dialog units. The values for individual controls and the dialog box appear in the lower right of the Visual Studio status bar when you select them.  
   
- There are three properties that you can set in the [Properties Window](/visualstudio/ide/reference/properties-window) to specify where a dialog box will appear onscreen. The Center property is Boolean; if you set the value to True, the dialog box will always appear in the center of the screen. If you set it to False, you can then set the XPos and YPos properties to explicitly define where onscreen the dialog box will appear. The position properties are offset values from the upper left-hand corner of the viewing area, which is defined as {X=0, Y=0}. The position is also based on the **Absolute Align** property: if True, the coordinates are relative to the screen; if False, the coordinates are relative to the dialog owner's window.  
+ There are three properties that you can set in the [Properties Window](/visualstudio/ide/reference/properties-window) to specify where a dialog box will appear onscreen. The **Center** property is Boolean; if you set the value to **True**, the dialog box will always appear in the center of the screen. If you set it to **False**, you can then set the **XPos** and **YPos** properties to explicitly define where onscreen the dialog box will appear. The position properties are offset values from the upper left-hand corner of the viewing area, which is defined as `{X=0, Y=0}`. The position is also based on the **Absolute Align** property: if **True**, the coordinates are relative to the screen; if **False**, the coordinates are relative to the dialog owner's window.  
   
  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/srwlock-class.md b/docs/windows/srwlock-class.md
@@ -17,7 +17,7 @@ Represents a slim reader/writer lock.
   
 ## Syntax  
   
-```  
+```cpp  
 class SRWLock;  
 ```  
   
diff --git a/docs/windows/srwlock-lockexclusive-method.md b/docs/windows/srwlock-lockexclusive-method.md
@@ -17,7 +17,7 @@ Acquires an **SRWLock** object in exclusive mode.
   
 ## Syntax  
   
-```  
+```cpp  
 SyncLockExclusive LockExclusive();  
   
 static SyncLockExclusive LockExclusive(  
diff --git a/docs/windows/srwlock-lockshared-method.md b/docs/windows/srwlock-lockshared-method.md
@@ -17,7 +17,7 @@ Acquires an **SRWLock** object in shared mode.
   
 ## Syntax  
   
-```  
+```cpp  
 SyncLockShared LockShared();  
   
 static SyncLockShared LockShared(  
diff --git a/docs/windows/srwlock-srwlock-constructor.md b/docs/windows/srwlock-srwlock-constructor.md
@@ -17,7 +17,7 @@ Initializes a new instance of the **SRWLock** class.
   
 ## Syntax  
   
-```  
+```cpp  
 SRWLock();  
 ```  
   
diff --git a/docs/windows/srwlock-srwlock-data-member.md b/docs/windows/srwlock-srwlock-data-member.md
@@ -17,7 +17,7 @@ Contains the underlying lock variable for the current **SRWLock** object.
   
 ## Syntax  
   
-```  
+```cpp  
 SRWLOCK SRWLock_;  
 ```  
   
diff --git a/docs/windows/srwlock-tilde-srwlock-destructor.md b/docs/windows/srwlock-tilde-srwlock-destructor.md
@@ -17,7 +17,7 @@ Deinitializes an instance of the **SRWLock** class.
   
 ## Syntax  
   
-```  
+```cpp  
 ~SRWLock();  
 ```  
   
diff --git a/docs/windows/srwlock-trylockexclusive-method.md b/docs/windows/srwlock-trylockexclusive-method.md
@@ -17,7 +17,7 @@ Attempts to acquire a **SRWLock** object in exclusive mode for the current or sp
   
 ## Syntax  
   
-```  
+```cpp  
 SyncLockExclusive TryLockExclusive();  
   
 static SyncLockExclusive TryLockExclusive(  
diff --git a/docs/windows/srwlock-trylockshared-method.md b/docs/windows/srwlock-trylockshared-method.md
@@ -17,7 +17,7 @@ Attempts to acquire a **SRWLock** object in shared mode for the current or speci
   
 ## Syntax  
   
-```  
+```cpp  
 WRL_NOTHROW SyncLockShared TryLockShared();  
 WRL_NOTHROW static SyncLockShared TryLockShared(  
    _In_ SRWLOCK* lock  
diff --git a/docs/windows/srwlockexclusivetraits-getinvalidvalue-method.md b/docs/windows/srwlockexclusivetraits-getinvalidvalue-method.md
@@ -17,7 +17,7 @@ Retrieves an **SRWLockExclusiveTraits** object that is always invalid.
   
 ## Syntax  
   
-```  
+```cpp  
 inline static Type GetInvalidValue();  
 ```  
   
diff --git a/docs/windows/srwlockexclusivetraits-structure.md b/docs/windows/srwlockexclusivetraits-structure.md
@@ -17,7 +17,7 @@ Describes common characteristics of the `SRWLock` class in exclusive lock mode.
   
 ## Syntax  
   
-```  
+```cpp  
 struct SRWLockExclusiveTraits;  
 ```  
   
diff --git a/docs/windows/srwlockexclusivetraits-unlock-method.md b/docs/windows/srwlockexclusivetraits-unlock-method.md
@@ -17,7 +17,7 @@ Releases exclusive control of the specified `SRWLock` object.
   
 ## Syntax  
   
-```  
+```cpp  
 inline static void Unlock(  
    _In_ Type srwlock  
 );  
diff --git a/docs/windows/srwlocksharedtraits-getinvalidvalue-method.md b/docs/windows/srwlocksharedtraits-getinvalidvalue-method.md
@@ -17,7 +17,7 @@ Retrieves an **SRWLockSharedTraits** object that is always invalid.
   
 ## Syntax  
   
-```  
+```cpp  
 inline static Type GetInvalidValue();  
 ```  
   
diff --git a/docs/windows/srwlocksharedtraits-structure.md b/docs/windows/srwlocksharedtraits-structure.md
@@ -17,7 +17,7 @@ Describes common characteristics of the `SRWLock` class in shared lock mode.
   
 ## Syntax  
   
-```  
+```cpp  
 struct SRWLockSharedTraits;  
 ```  
   
diff --git a/docs/windows/srwlocksharedtraits-unlock-method.md b/docs/windows/srwlocksharedtraits-unlock-method.md
@@ -17,7 +17,7 @@ Releases exclusive control of the specified `SRWLock` object.
   
 ## Syntax  
   
-```  
+```cpp  
 inline static void Unlock(  
    _In_ Type srwlock  
 );  
diff --git a/docs/windows/string-cpp-component-extensions.md b/docs/windows/string-cpp-component-extensions.md
@@ -123,8 +123,6 @@ int main() {
 }  
 ```  
   
- **Output**  
-  
 ```Output  
 abcdef  
   
@@ -201,8 +199,6 @@ int main() {
 }  
 ```  
   
- **Output**  
-  
 ```Output  
 overloaded +(String ^ a, String ^ b)   
   
@@ -254,8 +250,6 @@ int main() {
 }  
 ```  
   
- **Output**  
-  
 ```Output  
 char *  
   
diff --git a/docs/windows/string-cpp.md b/docs/windows/string-cpp.md
@@ -17,7 +17,7 @@ Indicates that the one-dimensional **char**, **wchar_t**, `byte` (or equivalent)
   
 ## Syntax  
   
-```  
+```cpp  
 [string]  
 ```  
   
diff --git a/docs/windows/support-error-info.md b/docs/windows/support-error-info.md
@@ -17,7 +17,7 @@ Implements support for returning detailed errors.
   
 ## Syntax  
   
-```  
+```cpp  
 [ support_error_info(  
    error_interface=uuid  
 ) ]  
diff --git a/docs/windows/swap-function-windows-runtime-cpp-template-library.md b/docs/windows/swap-function-windows-runtime-cpp-template-library.md
@@ -16,7 +16,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 WRL_NOTHROW inline void Swap(  
    _Inout_ T& left,  
    _Inout_ T& right  
diff --git a/docs/windows/switch-is.md b/docs/windows/switch-is.md
@@ -17,7 +17,7 @@ Specifies the expression or identifier acting as the union discriminant that sel
   
 ## Syntax  
   
-```  
+```cpp  
 [switch_is]  
 ```  
   
diff --git a/docs/windows/switch-type.md b/docs/windows/switch-type.md
@@ -17,7 +17,7 @@ Identifies the type of the variable used as the union discriminant.
   
 ## Syntax  
   
-```  
+```cpp  
 [switch_type(  
 type  
 }]  
diff --git a/docs/windows/symbol-name-restrictions.md b/docs/windows/symbol-name-restrictions.md
@@ -39,8 +39,6 @@ The restrictions on symbol names are as follows:
 |Strings|IDS_|String in the string table|  
 |MFC|AFX_|Reserved for predefined MFC symbols|  
   
-
-  
 ## Requirements  
  Win32  
   
diff --git a/docs/windows/symbol-value-restrictions.md b/docs/windows/symbol-value-restrictions.md
@@ -32,13 +32,13 @@ A symbol value can be any integer expressed in the normal manner for #define pre
   
 -   You cannot define a symbol value using other symbol strings. For example, the following symbol definition is not supported:  
   
-    ```  
+    ```cpp  
     #define IDC_MYEDIT  IDC_OTHEREDIT  //not supported  
     ```  
   
 -   You cannot use preprocessor macros with arguments as value definitions. For example:  
   
-    ```  
+    ```cpp  
     #define   IDD_ABOUT  ID(7) //not supported  
     ```  
   
@@ -48,8 +48,6 @@ A symbol value can be any integer expressed in the normal manner for #define pre
   
  For more information on number ranges, see [TN023: Standard MFC Resources](../mfc/tn023-standard-mfc-resources.md).  
   
-
-  
 ## Requirements  
  Win32  
   
diff --git a/docs/windows/synchronize.md b/docs/windows/synchronize.md
@@ -17,7 +17,7 @@ Synchronizes access to the target method.
   
 ## Syntax  
   
-```  
+```cpp  
 [synchronize]  
 ```  
   
diff --git a/docs/windows/synclockt-class.md b/docs/windows/synclockt-class.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 template <  
    typename SyncTraits  
 >  
diff --git a/docs/windows/synclockt-islocked-method.md b/docs/windows/synclockt-islocked-method.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 bool IsLocked() const;  
 ```  
   
diff --git a/docs/windows/synclockt-sync-data-member.md b/docs/windows/synclockt-sync-data-member.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 typename SyncTraits::Type sync_;  
 ```  
   
diff --git a/docs/windows/synclockt-synclockt-constructor.md b/docs/windows/synclockt-synclockt-constructor.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 SyncLockT(  
    _Inout_ SyncLockT&& other  
 );  
diff --git a/docs/windows/synclockt-tilde-synclockt-destructor.md b/docs/windows/synclockt-tilde-synclockt-destructor.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 ~SyncLockT();  
 ```  
   
diff --git a/docs/windows/synclockt-unlock-method.md b/docs/windows/synclockt-unlock-method.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 void Unlock();  
 ```  
   
diff --git a/docs/windows/synclockwithstatust-class.md b/docs/windows/synclockwithstatust-class.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 template <  
    typename SyncTraits  
 >  
diff --git a/docs/windows/synclockwithstatust-getstatus-method.md b/docs/windows/synclockwithstatust-getstatus-method.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 DWORD GetStatus() const;  
 ```  
   
diff --git a/docs/windows/synclockwithstatust-islocked-method.md b/docs/windows/synclockwithstatust-islocked-method.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 bool IsLocked() const;  
 ```  
   
diff --git a/docs/windows/synclockwithstatust-status-data-member.md b/docs/windows/synclockwithstatust-status-data-member.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 DWORD status_;  
 ```  
   
diff --git a/docs/windows/synclockwithstatust-synclockwithstatust-constructor.md b/docs/windows/synclockwithstatust-synclockwithstatust-constructor.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 SyncLockWithStatusT(  
    _Inout_ SyncLockWithStatusT&& other  
 );  
diff --git a/docs/windows/terminatemap-function.md b/docs/windows/terminatemap-function.md
@@ -17,7 +17,7 @@ Supports the WRL infrastructure and is not intended to be used directly from you
   
 ## Syntax  
   
-```  
+```cpp  
 inline bool TerminateMap(  
    _In_ ModuleBase *module,   
    _In_opt_z_ const wchar_t *serverName,   
diff --git a/docs/windows/testing-a-dialog-box.md b/docs/windows/testing-a-dialog-box.md
@@ -29,7 +29,7 @@ When you're designing a dialog box, you can simulate and test its run-time behav
   
 ### To test a dialog box  
   
-1.  When the Dialog editor is the active window, on the menu bar, choose **Format**, **Test Dialog**.  
+1.  When the **Dialog** editor is the active window, on the menu bar, choose **Format** > **Test Dialog**.  
   
 2.  To end the simulation, press **Esc**, or just choose the **Close** button in the dialog box you are testing.  
   
diff --git a/docs/windows/text-tool-dialog-box-image-editor-for-icons.md b/docs/windows/text-tool-dialog-box-image-editor-for-icons.md
@@ -17,10 +17,10 @@ Use the **Text Tool** dialog box to add text to a cursor, bitmap, or icon resour
   
  To access this dialog box, open the [Image Editor](../windows/window-panes-image-editor-for-icons.md). Select **Tools** from the **Image** menu, and then select the **Text Tool** command.  
   
- **Font button**  
- Opens the [Text Tool Font dialog box](../windows/text-tool-font-dialog-box-image-editor-for-icons.md), in which you can change the font, style, or size of the cursor font. Changes are applied to the text displayed in the Text area.  
+### Font button  
+ Opens the [Text Tool Font dialog box](../windows/text-tool-font-dialog-box-image-editor-for-icons.md), in which you can change the font, style, or size of the cursor font. Changes are applied to the text displayed in the **Text** area.  
   
- **Text area**  
+### Text area  
  Displays the text that appears as part of the resource. Initially this area is empty.  
   
 > [!NOTE]
@@ -32,5 +32,4 @@ Use the **Text Tool** dialog box to add text to a cursor, bitmap, or icon resour
  None  
   
 ## See Also  
- [Editing Graphical Resources](../windows/editing-graphical-resources-image-editor-for-icons.md)
-
+ [Editing Graphical Resources](../windows/editing-graphical-resources-image-editor-for-icons.md)
diff --git a/docs/windows/text-tool-font-dialog-box-image-editor-for-icons.md b/docs/windows/text-tool-font-dialog-box-image-editor-for-icons.md
diff --git a/docs/windows/threading-cpp.md b/docs/windows/threading-cpp.md
