Merge pull request #1010 from msebolt/format-mfc-reference-pr17

format-mfc-reference-pr17

Author: TrishaMc

docs/mfc/reference/event-sink-maps.md

@@ -27,12 +27,12 @@ ms.workload: ["cplusplus"]
 
 
 ## <a name="afx_ext_class"></a>  AFX_EXT_CLASS
-[MFC extension DLLs](../../build/extension-dlls.md) use the macro **AFX_EXT_CLASS** to export classes; the executables that link to the MFC extension DLL use the macro to import classes.  
+[MFC extension DLLs](../../build/extension-dlls.md) use the macro AFX_EXT_CLASS to export classes; the executables that link to the MFC extension DLL use the macro to import classes.  
 
 ### Remarks  
- With the **AFX_EXT_CLASS** macro, the same header file(s) used to build the MFC extension DLL can be used with the executables that link to the DLL.  
+ With the AFX_EXT_CLASS macro, the same header file(s) used to build the MFC extension DLL can be used with the executables that link to the DLL.  
 
- In the header file for your DLL, add the **AFX_EXT_CLASS** keyword to the declaration of your class as follows:  
+ In the header file for your DLL, add the AFX_EXT_CLASS keyword to the declaration of your class as follows:  
 
 ```cpp
 class AFX_EXT_CLASS CMyClass : public CDocument
@@ -54,11 +54,11 @@ Call this macro to protect an exported function in a DLL.
 AFX_MANAGE_STATE(AFX_MODULE_STATE* pModuleState )  
 ```
 ### Parameters  
- `pModuleState`  
+ *pModuleState*  
  A pointer to an `AFX_MODULE_STATE` structure.  
 
 ### Remarks  
- When this macro is invoked, `pModuleState` is the effective module state for the remainder of the immediate containing scope. Upon leaving the scope, the previous effective module state will be automatically restored.    
+ When this macro is invoked, *pModuleState* is the effective module state for the remainder of the immediate containing scope. Upon leaving the scope, the previous effective module state will be automatically restored.    
  The `AFX_MODULE_STATE` structure contains global data for the module, that is, the portion of the module state that is pushed or popped.    
  By default, MFC uses the resource handle of the main application to load the resource template. If you have an exported function in a DLL, such as one that launches a dialog box in the DLL, this template is actually stored in the DLL module. You need to switch the module state for the correct handle to be used. You can do this by adding the following code to the beginning of the function:    
 ```cpp
@@ -84,9 +84,9 @@ void AFXAPI AfxOleInitModule( );
 ```  
    
 ### Remarks  
- The MFC OLE DLL is an MFC extension DLL; in order for an MFC extension DLL to get wired into a **CDynLinkLibrary** chain, it must create a **CDynLinkLibrary** object in the context of every module that will be using it. `AfxOleInitModule` creates the **CDynLinkLibrary** object in your regular MFC DLL's context so that it gets wired into the **CDynLinkLibrary** object chain of the regular MFC DLL.  
+ The MFC OLE DLL is an MFC extension DLL; in order for an MFC extension DLL to get wired into a `CDynLinkLibrary` chain, it must create a `CDynLinkLibrary` object in the context of every module that will be using it. `AfxOleInitModule` creates the `CDynLinkLibrary` object in your regular MFC DLL's context so that it gets wired into the `CDynLinkLibrary` object chain of the regular MFC DLL.  
   
- If you are building an OLE control and are using `COleControlModule`, you should not call **AfxOleInitModule** because the `InitInstance` member function for `COleControlModule` calls `AfxOleInitModule`.  
+ If you are building an OLE control and are using `COleControlModule`, you should not call `AfxOleInitModule` because the `InitInstance` member function for `COleControlModule` calls `AfxOleInitModule`.  
    
 ### Requirements  
  **Header**: <afxdll_.h>  
@@ -96,15 +96,15 @@ void AFXAPI AfxOleInitModule( );
  [AfxMessageBox](cstring-formatting-and-message-box-display.md#afxmessagebox)
 
 ## <a name="afxnetinitmodule"></a>  AfxNetInitModule
-For MFC Sockets support from a regular MFC DLL that is dynamically linked to MFC, add a call to this function in your regular MFC DLL's **CWinApp::InitInstance** function to initialize the MFC Sockets DLL.  
+For MFC Sockets support from a regular MFC DLL that is dynamically linked to MFC, add a call to this function in your regular MFC DLL's `CWinApp::InitInstance` function to initialize the MFC Sockets DLL.  
    
 ### Syntax    
 ```
 void AFXAPI AfxNetInitModule( );  
 ```  
    
 ### Remarks  
- The MFC Sockets DLL is an MFC extension DLL; in order for an MFC extension DLL to get wired into a **CDynLinkLibrary** chain, it must create a **CDynLinkLibrary** object in the context of every module that will be using it. `AfxNetInitModule` creates the **CDynLinkLibrary** object in your regular MFC DLL's context so that it gets wired into the **CDynLinkLibrary** object chain of the regular MFC DLL.  
+ The MFC Sockets DLL is an MFC extension DLL; in order for an MFC extension DLL to get wired into a `CDynLinkLibrary` chain, it must create a `CDynLinkLibrary` object in the context of every module that will be using it. `AfxNetInitModule` creates the `CDynLinkLibrary` object in your regular MFC DLL's context so that it gets wired into the `CDynLinkLibrary` object chain of the regular MFC DLL.  
    
 ### Requirements  
  **Header:** <afxdll_.h>  
@@ -177,14 +177,14 @@ Call this function in an MFC extension DLL's `DllMain` to initialize the DLL.
 BOOL AFXAPI AfxInitExtensionModule( AFX_EXTENSION_MODULE& state,  HMODULE hModule );  
 ```
 ### Parameters  
- `state`  
+ *state*  
  A reference to the [AFX_EXTENSION_MODULE Structure](afx-extension-module-structure.md) structure that will contain the state of the MFC extension DLL module after the initialization. The state includes a copy of the runtime class objects that have been initialized by the MFC extension DLL as part of normal static object construction executed before `DllMain` is entered.  
 
- `hModule`  
+ *hModule*  
  A handle of the MFC extension DLL module.  
 
 ### Return Value  
- **TRUE** if the MFC extension DLL is successfully initialized; otherwise, **FALSE**.  
+ TRUE if the MFC extension DLL is successfully initialized; otherwise, FALSE.  
 
 ### Remarks  
  For example:  
@@ -207,10 +207,10 @@ DllMain(HINSTANCE hInstance, DWORD dwReason, LPVOID lpReserved)
 
 ```
   
- `AfxInitExtensionModule` makes a copy of the DLL's **HMODULE** and captures the DLL's runtime-classes (`CRuntimeClass` structures) as well as its object factories (`COleObjectFactory` objects) for use later when the **CDynLinkLibrary** object is created.    
+ `AfxInitExtensionModule` makes a copy of the DLL's HMODULE and captures the DLL's runtime-classes (`CRuntimeClass` structures) as well as its object factories (`COleObjectFactory` objects) for use later when the `CDynLinkLibrary` object is created.    
  MFC extension DLLs need to do two things in their `DllMain` function:    
 -   Call [AfxInitExtensionModule](#_mfc_afxinitextensionmodule) and check the return value.   
--   Create a **CDynLinkLibrary** object if the DLL will be exporting [CRuntimeClass Structure](cruntimeclass-structure.md) objects or has its own custom resources.    
+-   Create a `CDynLinkLibrary` object if the DLL will be exporting [CRuntimeClass Structure](cruntimeclass-structure.md) objects or has its own custom resources.    
  You can call `AfxTermExtensionModule` to clean up the MFC extension DLL when each process detaches from the MFC extension DLL (which happens when the process exits, or when the DLL is unloaded as a result of an `AfxFreeLibrary` call).     
 
 ### Requirements  
@@ -229,7 +229,7 @@ Use this function to set the per-module state flag, which affects the WinSxS beh
 );  
 ```
 ### Parameters  
- `bSet`  
+ *bSet*  
  New value of the module state flag.  
    
 ### Remarks  
@@ -263,11 +263,11 @@ Call this function to allow MFC to cleanup the MFC extension DLL when each proce
 void AFXAPI AfxTermExtensionModule(  AFX_EXTENSION_MODULE& state,  BOOL bAll  = FALSE );  
 ```
 ### Parameters  
- `state`  
+ *state*  
  A reference to the [AFX_EXTENSION_MODULE](afx-extension-module-structure.md) structure that contains the state of MFC extension DLL module.  
 
  *bAll*  
- If **TRUE**, cleanup all MFC extension DLL modules. Otherwise, cleanup only the current DLL module.  
+ If TRUE, cleanup all MFC extension DLL modules. Otherwise, cleanup only the current DLL module.  
 
 ### Remarks  
  `AfxTermExtensionModule` will delete any local storage attached to the module and remove any entries from the message map cache. For example:  
@@ -305,7 +305,7 @@ DllMain(HINSTANCE hInstance, DWORD dwReason, LPVOID lpReserved)
   
  If your application loads and frees MFC extension DLLs dynamically, be sure to call `AfxTermExtensionModule`. Since most MFC extension DLLs are not dynamically loaded (usually, they are linked via their import libraries), the call to `AfxTermExtensionModule` is usually not necessary.  
   
- MFC extension DLLs need to call [AfxInitExtensionModule](#afxinitextensionmodule) in their `DllMain`. If the DLL will be exporting [CRuntimeClass](cruntimeclass-structure.md) objects or has its own custom resources, you also need to create a **CDynLinkLibrary** object in `DllMain`.  
+ MFC extension DLLs need to call [AfxInitExtensionModule](#afxinitextensionmodule) in their `DllMain`. If the DLL will be exporting [CRuntimeClass](cruntimeclass-structure.md) objects or has its own custom resources, you also need to create a `CDynLinkLibrary` object in `DllMain`.  
    
 ### Requirements  
  **Header:** afxdll_.h  

docs/mfc/reference/exception-processing.md

@@ -48,7 +48,7 @@ void AFXAPI AfxDrawGrayBitmap(
 ```  
 
 ### Parameters  
- `pDC`  
+ *pDC*  
  Points to the destination DC.  
 
  *x*  
@@ -57,10 +57,10 @@ void AFXAPI AfxDrawGrayBitmap(
  *y*  
  The destination y-coordinate.  
 
- `rSrc`  
+ *rSrc*  
  The source bitmap.  
 
- `crBackground`  
+ *crBackground*  
  The new background color (typically gray, such as COLOR_MENU).  
 
 ### Remarks  
@@ -85,13 +85,13 @@ void AFXAPI AfxGetGrayBitmap(
 ```  
 
 ### Parameters  
- `rSrc`  
+ *rSrc*  
  The source bitmap.  
 
- `pDest`  
+ *pDest*  
  The destination bitmap.  
 
- `crBackground`  
+ *crBackground*  
  The new background color (typically gray, such as COLOR_MENU).  
 
 ### Remarks  
@@ -119,7 +119,7 @@ void AFXAPI AfxDrawDitheredBitmap(
 ```  
 
 ### Parameters  
- `pDC`  
+ *pDC*  
  Points to the destination DC.  
 
  *x*  
@@ -128,17 +128,17 @@ void AFXAPI AfxDrawDitheredBitmap(
  *y*  
  The destination y-coordinate.  
 
- `rSrc`  
+ *rSrc*  
  The source bitmap.  
 
- `cr1`  
+ *cr1*  
  One of the two dither colors, typically white.  
 
- `cr2`  
+ *cr2*  
  The other dither color, typically light gray (COLOR_MENU).  
 
 ### Remarks  
- The source bitmap is drawn on the destination DC with a two-color ( `cr1` and `cr2`) checkered pattern replacing the bitmap's background. The background of the source bitmap is defined as its white pixels and all pixels matching the color of the pixel in the upper-left corner of the bitmap.  
+ The source bitmap is drawn on the destination DC with a two-color (*cr1* and *cr2*) checkered pattern replacing the bitmap's background. The background of the source bitmap is defined as its white pixels and all pixels matching the color of the pixel in the upper-left corner of the bitmap.  
 
  ![Comparison of dithered and original icon versions](../../mfc/reference/media/vcditheredbitmap.gif "vcditheredbitmap")  
 
@@ -161,20 +161,20 @@ void AFXAPI AfxGetDitheredBitmap(
 ```  
 
 ### Parameters  
- `rSrc`  
+ *rSrc*  
  The source bitmap.  
 
- `pDest`  
+ *pDest*  
  The destination bitmap.  
 
- `cr1`  
+ *cr1*  
  One of the two dither colors, typically white.  
 
- `cr2`  
+ *cr2*  
  The other dither color, typically light gray (COLOR_MENU).  
 
 ### Remarks  
- The source bitmap is copied to the destination bitmap with a two-color ( `cr1` and `cr2`) checkered pattern replacing the source bitmap's background. The background of the source bitmap is defined as its white pixels and all pixels matching the color of the pixel in the upper-left corner of the bitmap.  
+ The source bitmap is copied to the destination bitmap with a two-color (*cr1* and *cr2*) checkered pattern replacing the source bitmap's background. The background of the source bitmap is defined as its white pixels and all pixels matching the color of the pixel in the upper-left corner of the bitmap.  
 
  ![Comparison of dithered and original icon versions](../../mfc/reference/media/vcditheredbitmap.gif "vcditheredbitmap")  
 

docs/mfc/reference/extension-dll-macros.md

@@ -17,14 +17,14 @@ The following topics correspond to the map entries.
 
 |Topic|Map entries|  
 |-----------|-----------------|  
-|[A - C](../../mfc/reference/wm-message-handlers-a-c.md)|**ON_WM_ACTIVATE** through **ON_WM_CTLCOLOR**|  
-|[D - E](../../mfc/reference/wm-message-handlers-d-e.md)|**ON_WM_DEADCHAR** through **ON_WM_ERASEBKGND**|  
-|[F - K](../../mfc/reference/wm-message-handlers-f-k.md)|**ON_WM_FONTCHANGE** through **ON_WM_KILLFOCUS**|  
-|[L - M](../../mfc/reference/wm-message-handlers-l-m.md)|**ON_WM_LBUTTONDBLCLK** through **ON_WM_MOVING**|  
-|[N - O](../../mfc/reference/wm-message-handlers-n-o.md)|**ON_WM_NCACTIVATE** through **ON_WM_NCRBUTTONUP**|  
-|[P - R](../../mfc/reference/wm-messages-p-r.md)|**ON_WM_PAINT** through **ON_WM_RENDERFORMAT**|  
-|[S](../../mfc/reference/wm-messages-s.md)|**ON_WM_SETCURSOR** through **ON_WM_SYSKEYUP**|  
-|[T - Z](../../mfc/reference/wm-messages-t-z.md)|**ON_WM_TIMECHANGE** through **ON_WM_WININICHANGE**|  
+|[A - C](../../mfc/reference/wm-message-handlers-a-c.md)|ON_WM_ACTIVATE through ON_WM_CTLCOLOR|  
+|[D - E](../../mfc/reference/wm-message-handlers-d-e.md)|ON_WM_DEADCHAR through ON_WM_ERASEBKGND|  
+|[F - K](../../mfc/reference/wm-message-handlers-f-k.md)|ON_WM_FONTCHANGE through ON_WM_KILLFOCUS|  
+|[L - M](../../mfc/reference/wm-message-handlers-l-m.md)|ON_WM_LBUTTONDBLCLK through ON_WM_MOVING|  
+|[N - O](../../mfc/reference/wm-message-handlers-n-o.md)|ON_WM_NCACTIVATE through ON_WM_NCRBUTTONUP|  
+|[P - R](../../mfc/reference/wm-messages-p-r.md)|ON_WM_PAINT through ON_WM_RENDERFORMAT|  
+|[S](../../mfc/reference/wm-messages-s.md)|ON_WM_SETCURSOR through ON_WM_SYSKEYUP|  
+|[T - Z](../../mfc/reference/wm-messages-t-z.md)|ON_WM_TIMECHANGE through ON_WM_WININICHANGE|  
 
 ## See Also  
  [Message Maps](../../mfc/reference/message-maps-mfc.md)

docs/mfc/reference/gray-and-dithered-bitmap-functions.md

@@ -21,9 +21,9 @@ In entries labeled \<memberFxn>, write your own member function for a derived [C
 
 |Term|Definition|  
 |----------|----------------|  
-|id|Any user-defined menu item ID (**WM_COMMAND** messages) or control ID (child window notification messages).|  
+|id|Any user-defined menu item ID (WM_COMMAND messages) or control ID (child window notification messages).|  
 |"message" and "wNotifyCode"|Windows message IDs as defined in WINDOWS.H.|  
-|nMessageVariable|Name of a variable that contains the return value from the **RegisterWindowMessage** Windows function.|  
+|nMessageVariable|Name of a variable that contains the return value from the `RegisterWindowMessage` Windows function.|  
 
 ## See Also  
  [Message Maps](../../mfc/reference/message-maps-mfc.md)

docs/mfc/reference/handlers-for-wm-messages.md

@@ -13,7 +13,7 @@ ms.author: "mblome"
 ms.workload: ["cplusplus"]
 ---
 # HSE_VERSION_INFO Structure
-This structure is pointed to by the `pVer` parameter in the `CHttpServer::GetExtensionVersion` member function. It provides the ISA version number and a text description of the ISA.  
+This structure is pointed to by the *pVer* parameter in the `CHttpServer::GetExtensionVersion` member function. It provides the ISA version number and a text description of the ISA.  
 
 ## Syntax  
 

docs/mfc/reference/how-to-use-the-message-map-cross-reference.md

@@ -57,9 +57,9 @@ void AddCommandHandler(
 ```
 
 ### Parameters  
-`cmdID`  
+*cmdID*  
 The command ID.  
-`cmdHandler`  
+*cmdHandler*  
 A handle to the command handler method.
 
 ### Remarks
@@ -76,11 +76,11 @@ void AddCommandRangeHandler(
     CommandHandler^ cmdHandler);
 ```
 ### Parameters  
-`cmdIDMin`  
+*cmdIDMin*  
 The beginning index of the command ID range.
-`cmdIDMax`  
+*cmdIDMax*  
 The ending index of the command ID range.
-`cmdHandler`  
+*cmdHandler*  
 A handle to the message handler method to which the commands are mapped.
 ### Remarks
 This method maps a contiguous range of command IDs to a single message handler and adds it to the command source object. This is used for handling a group of related buttons with one method.
@@ -94,11 +94,11 @@ void AddCommandRangeUIHandler(
     CommandUIHandler^ cmdUIHandler);
 ```
 ### Parameters  
-`cmdIDMin`  
+*cmdIDMin*  
 The beginning index of the command ID range.
-`cmdIDMax`  
+*cmdIDMax*  
 The ending index of the command ID range.
-`cmdHandler`  
+*cmdHandler*  
 A handle to the message handler method to which the commands are mapped.
 
 ### Remarks
@@ -112,9 +112,9 @@ void AddCommandUIHandler(
     CommandUIHandler^ cmdUIHandler);
 ```
 ### Parameters
-`cmdID`  
+*cmdID*  
 The command ID.  
-`cmdUIHandler`  
+*cmdUIHandler*  
 A handle to the user interface command message handler method.
 
 ### Remarks
@@ -126,7 +126,7 @@ Posts a message without waiting for it to be processed.
 void PostCommand(unsigned int command);
 ```
 ### Parameters
-`command`  
+*command*  
 The command ID of the message to be posted.
 ### Remarks
 This method asynchronously posts the message mapped to the ID specified by command. It calls CWnd::PostMessage to place the message in the window's message queue and then returns without waiting for the corresponding window to process the message.
@@ -138,7 +138,7 @@ Removes a command handler from a command source object.
 void RemoveCommandHandler(unsigned int cmdID);
 ```
 ### Parameters
-`cmdID`  
+*cmdID*  
 The command ID.
 ### Remarks
 This method removes the command handler mapped to cmdID from the command source object.
@@ -152,9 +152,9 @@ void RemoveCommandRangeUIHandler(
     unsigned int cmdIDMax);
 ```
 ### Parameters
-`cmdIDMin`  
+*cmdIDMin*  
 The beginning index of the command ID range.
-`cmdIDMax`  
+*cmdIDMax*  
 The ending index of the command ID range.
 ### Remarks
 This method removes a group of message handlers, mapped to the command IDs specifed by cmdIDMin and cmdIDMax, from the command source object.
@@ -167,9 +167,9 @@ void RemoveCommandRangeUIHandler(
     unsigned int cmdIDMax);
 ```
 ### Parameters
-`cmdIDMin`  
+*cmdIDMin*  
 The beginning index of the command ID range.
-`cmdIDMax`  
+*cmdIDMax*  
 The ending index of the command ID range.
 ### Remarks
 This method removes a group of user interface command message handlers, mapped to the command IDs specifed by cmdIDMin and cmdIDMax, from the command source object.
@@ -180,7 +180,7 @@ Removes a user interface command message handler from a command source object.
 void RemoveCommandUIHandler(unsigned int cmdID);
 ```
 ### Parameters
-`cmdID`  
+*cmdID*  
 The command ID.
 ### Remarks
 This method removes the user interface command message handler mapped to cmdID from the command source object.
@@ -191,7 +191,7 @@ Sends a message and waits for it to be processed before returning.
 void SendCommand(unsigned int command);
 ```
 ### Parameters
-`command`  
+*command*  
 The command ID of the message to be sent.
 ### Remarks
 This method synchronously sends the message mapped to the ID specified by command. It calls CWnd::SendMessage to place the message in the window's message queue and waits until that window procedure has processed the message before returning.

docs/mfc/reference/hse-version-info-structure.md

@@ -47,7 +47,7 @@ void Initialize(ICommandSource^ cmdSource);
 ```  
 
 ### Parameters  
- `cmdSource`  
+ *cmdSource*  
  A handle to the command source object.  
 
 ### Remarks