Merge pull request #987 from msebolt/format-mfc-reference-pr6

format mfc reference pr6

Author: TrishaMc

docs/mfc/reference/cgopherfile-class.md

@@ -33,7 +33,7 @@ class CGopherFile : public CInternetFile
 |[CGopherFile::CGopherFile](#cgopherfile)|Constructs a `CGopherFile` object.|  
 
 ## Remarks  
- The gopher service does not allow users to write data to a gopher file because this service functions mainly as a menu-driven interface for finding information. The `CGopherFile` member functions **Write**, `WriteString`, and `Flush` are not implemented for `CGopherFile`. Calling these functions on a `CGopherFile` object, returns a [CNotSupportedException](../../mfc/reference/cnotsupportedexception-class.md).  
+ The gopher service does not allow users to write data to a gopher file because this service functions mainly as a menu-driven interface for finding information. The `CGopherFile` member functions `Write`, `WriteString`, and `Flush` are not implemented for `CGopherFile`. Calling these functions on a `CGopherFile` object, returns a [CNotSupportedException](../../mfc/reference/cnotsupportedexception-class.md).  
 
  To learn more about how `CGopherFile` works with the other MFC Internet classes, see the article [Internet Programming with WinInet](../../mfc/win32-internet-extensions-wininet.md).  
 
@@ -70,25 +70,25 @@ CGopherFile(
 ```  
 
 ### Parameters  
- `hFile`  
+ *hFile*  
  A handle to an `HINTERNET` file.  
 
- `refLocator`  
+ *refLocator*  
  A reference to a [CGopherLocator](../../mfc/reference/cgopherlocator-class.md) object.  
 
- `pConnection`  
+ *pConnection*  
  A pointer to a [CGopherConnection](../../mfc/reference/cgopherconnection-class.md) object.  
 
- `hSession`  
+ *hSession*  
  A handle to the current Internet session.  
 
- `pstrLocator`  
+ *pstrLocator*  
  A pointer to a string used to locate the gopher server. See [Gopher Sessions](cgopherlocator-class.md) for more information about gopher locators.  
 
  *dwLocLen*  
- A DWORD containing the number of bytes in `pstrLocator`.  
+ A DWORD containing the number of bytes in *pstrLocator*.  
 
- `dwContext`  
+ *dwContext*  
  A pointer to the context identifier of the file being opened.  
 
 ### Remarks  

docs/mfc/reference/cgopherfilefind-class.md

@@ -88,14 +88,14 @@ explicit CGopherFileFind(
 ```  
 
 ### Parameters  
- `pConnection`  
+ *pConnection*  
  A pointer to a [CGopherConnection](../../mfc/reference/cgopherconnection-class.md) object.  
 
- `dwContext`  
- The context identifier for the operation. See **Remarks** for more information about `dwContext`.  
+ *dwContext*  
+ The context identifier for the operation. See **Remarks** for more information about *dwContext*.  
 
 ### Remarks  
- The default value for `dwContext` is sent by MFC to the `CGopherFileFind` object from the [CInternetSession](../../mfc/reference/cinternetsession-class.md) object that created the `CGopherFileFind` object. When you construct a `CGopherFileFind` object, you can override the default to set the context identifier to a value of your choosing. The context identifier is returned to [CInternetSession::OnStatusCallback](../../mfc/reference/cinternetsession-class.md#onstatuscallback) to provide status on the object with which it is identified. See the article [Internet First Steps: WinInet](../../mfc/wininet-basics.md) for more information about the context identifier.  
+ The default value for *dwContext* is sent by MFC to the `CGopherFileFind` object from the [CInternetSession](../../mfc/reference/cinternetsession-class.md) object that created the `CGopherFileFind` object. When you construct a `CGopherFileFind` object, you can override the default to set the context identifier to a value of your choosing. The context identifier is returned to [CInternetSession::OnStatusCallback](../../mfc/reference/cinternetsession-class.md#onstatuscallback) to provide status on the object with which it is identified. See the article [Internet First Steps: WinInet](../../mfc/wininet-basics.md) for more information about the context identifier.  
 
 ##  <a name="findfile"></a>  CGopherFileFind::FindFile  
  Call this member function to find a gopher file.  
@@ -113,13 +113,13 @@ virtual BOOL FindFile(
 ```  
 
 ### Parameters  
- `refLocator`  
+ *refLocator*  
  A reference to a [CGopherLocator](../../mfc/reference/cgopherlocator-class.md) object.  
 
  *pstrString*  
  A pointer to a string containing the file name.  
 
- `dwFlags`  
+ *dwFlags*  
  The flags describing how to handle this session. The valid flags are:  
 
 -   INTERNET_FLAG_RELOAD   Get the data from the remote server even if it is locally cached.  
@@ -155,10 +155,10 @@ virtual BOOL GetCreationTime(CTime& refTime) const;
 ```  
 
 ### Parameters  
- `pTimeStamp`  
+ *pTimeStamp*  
  A pointer to a [FILETIME](http://msdn.microsoft.com/library/windows/desktop/ms724284) structure containing the time the file was created.  
 
- `refTime`  
+ *refTime*  
  A reference to a [CTime](../../atl-mfc-shared/reference/ctime-class.md) object.  
 
 ### Return Value  
@@ -179,10 +179,10 @@ virtual BOOL GetLastAccessTime(FILETIME* pTimeStamp) const;
 ```  
 
 ### Parameters  
- `refTime`  
+ *refTime*  
  A reference to a [CTime](../../atl-mfc-shared/reference/ctime-class.md) object.  
 
- `pTimeStamp`  
+ *pTimeStamp*  
  A pointer to a [FILETIME](http://msdn.microsoft.com/library/windows/desktop/ms724284) structure containing the time the file was last accessed.  
 
 ### Return Value  
@@ -203,10 +203,10 @@ virtual BOOL GetLastWriteTime(CTime& refTime) const;
 ```  
 
 ### Parameters  
- `pTimeStamp`  
+ *pTimeStamp*  
  A pointer to a [FILETIME](http://msdn.microsoft.com/library/windows/desktop/ms724284) structure containing the time the file was last written to.  
 
- `refTime`  
+ *refTime*  
  A reference to a [CTime](../../atl-mfc-shared/reference/ctime-class.md) object.  
 
 ### Return Value  

docs/mfc/reference/cgopherlocator-class.md

@@ -69,7 +69,7 @@ CGopherLocator(const CGopherLocator& ref);
 ```  
 
 ### Parameters  
- `ref`  
+ *ref*  
  A reference to a constant `CGopherLocator` object.  
 
 ### Remarks  

docs/mfc/reference/cheaderctrl-class.md

@@ -127,7 +127,7 @@ BOOL ClearFilter(int nColumn);
 ```  
 
 ### Parameters  
- `nColumn`  
+ *nColumn*  
  Column value indicating which filter to clear.  
 
 ### Return Value  
@@ -151,23 +151,23 @@ virtual BOOL Create(
 ```  
 
 ### Parameters  
- `dwStyle`  
+ *dwStyle*  
  Specifies the header control's style. For a description of header control styles, see [Header Control Styles](http://msdn.microsoft.com/library/windows/desktop/bb775241) in the Windows SDK.  
 
- `rect`  
+ *rect*  
  Specifies the header control's size and position. It can be either a [CRect](../../atl-mfc-shared/reference/crect-class.md) object or a [RECT](http://msdn.microsoft.com/library/windows/desktop/dd162897) structure.  
 
- `pParentWnd`  
+ *pParentWnd*  
  Specifies the header control's parent window, usually a `CDialog`. It must not be **NULL**.  
 
- `nID`  
+ *nID*  
  Specifies the header control's ID.  
 
 ### Return Value  
  Nonzero if initialization was successful; otherwise zero.  
 
 ### Remarks  
- You construct a `CHeaderCtrl` object in two steps. First, call the constructor and then call **Create**, which creates the header control and attaches it to the `CHeaderCtrl` object.  
+ You construct a `CHeaderCtrl` object in two steps. First, call the constructor and then call `Create`, which creates the header control and attaches it to the `CHeaderCtrl` object.  
 
  In addition to the header control styles, you can use the following common control styles to determine how the header control positions and resizes itself (see [Common Control Styles](http://msdn.microsoft.com/library/windows/desktop/bb775498) for more information):  
 
@@ -195,7 +195,7 @@ virtual BOOL Create(
 
 - **WS_TABSTOP** Specifies one of any number of controls through which the user can move by using the TAB key. The TAB key moves the user to the next control specified by the **WS_TABSTOP** style.  
 
- If you want to use extended windows styles with your control, call [CreateEx](#createex) instead of **Create**.  
+ If you want to use extended windows styles with your control, call [CreateEx](#createex) instead of `Create`.  
 
 ### Example  
  [!code-cpp[NVC_MFC_CHeaderCtrl#4](../../mfc/reference/codesnippet/cpp/cheaderctrl-class_4.cpp)]  
@@ -213,26 +213,26 @@ virtual BOOL CreateEx(
 ```  
 
 ### Parameters  
- `dwExStyle`  
- Specifies the extended style of the control being created. For a list of extended Windows styles, see the `dwExStyle` parameter for [CreateWindowEx](http://msdn.microsoft.com/library/windows/desktop/ms632680) in the Windows SDK.  
+ *dwExStyle*  
+ Specifies the extended style of the control being created. For a list of extended Windows styles, see the *dwExStyle* parameter for [CreateWindowEx](http://msdn.microsoft.com/library/windows/desktop/ms632680) in the Windows SDK.  
 
- `dwStyle`  
+ *dwStyle*  
  The header control's style. For a description of header control styles, see [Header Control Styles](http://msdn.microsoft.com/library/windows/desktop/bb775241) in the Windows SDK. See [Create](#create) for a list of additional styles.  
 
- `rect`  
- A reference to a [RECT](http://msdn.microsoft.com/library/windows/desktop/dd162897) structure describing the size and position of the window to be created, in client coordinates of `pParentWnd`.  
+ *rect*  
+ A reference to a [RECT](http://msdn.microsoft.com/library/windows/desktop/dd162897) structure describing the size and position of the window to be created, in client coordinates of *pParentWnd*.  
 
- `pParentWnd`  
+ *pParentWnd*  
  A pointer to the window that is the control's parent.  
 
- `nID`  
+ *nID*  
  The control's child-window ID.  
 
 ### Return Value  
  Nonzero if successful; otherwise 0.  
 
 ### Remarks  
- Use `CreateEx` instead of **Create** to apply extended Windows styles, specified by the Windows extended style preface **WS_EX_**.  
+ Use `CreateEx` instead of `Create` to apply extended Windows styles, specified by the Windows extended style preface **WS_EX_**.  
 
 ##  <a name="createdragimage"></a>  CHeaderCtrl::CreateDragImage  
  Creates a transparent version of an item's image within a header control.  
@@ -242,7 +242,7 @@ CImageList* CreateDragImage(int nIndex);
 ```  
 
 ### Parameters  
- `nIndex`  
+ *nIndex*  
  The zero-based index of the item within the header control. The image assigned to this item is the basis for the transparent image.  
 
 ### Return Value  
@@ -261,7 +261,7 @@ BOOL DeleteItem(int nPos);
 ```  
 
 ### Parameters  
- `nPos`  
+ *nPos*  
  Specifies the zero-based index of the item to delete.  
 
 ### Return Value  
@@ -278,15 +278,15 @@ virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);
 ```  
 
 ### Parameters  
- `lpDrawItemStruct`  
+ *lpDrawItemStruct*  
  A pointer to a [DRAWITEMSTRUCT](http://msdn.microsoft.com/library/windows/desktop/bb775802) structure describing the item to be painted.  
 
 ### Remarks  
  The **itemAction** member of the `DRAWITEMSTRUCT` structure defines the drawing action that is to be performed.  
 
  By default, this member function does nothing. Override this member function to implement drawing for an owner-draw `CHeaderCtrl` object.  
 
- The application should restore all graphics device interface (GDI) objects selected for the display context supplied in `lpDrawItemStruct` before this member function terminates.  
+ The application should restore all graphics device interface (GDI) objects selected for the display context supplied in *lpDrawItemStruct* before this member function terminates.  
 
 ### Example  
  [!code-cpp[NVC_MFC_CHeaderCtrl#6](../../mfc/reference/codesnippet/cpp/cheaderctrl-class_6.cpp)]  
@@ -301,10 +301,10 @@ BOOL EditFilter(
 ```  
 
 ### Parameters  
- `nColumn`  
+ *nColumn*  
  The column to edit.  
 
- `bDiscardChanges`  
+ *bDiscardChanges*  
  A value that specifies how to handle the user's editing changes if the user is in the process of editing the filter when the [HDM_EDITFILTER](http://msdn.microsoft.com/library/windows/desktop/bb775312) message is sent.  
 
  Specify `true` to discard the changes made by the user, or `false` to accept the changes made by the user.  
@@ -383,10 +383,10 @@ BOOL GetItem(
 ```  
 
 ### Parameters  
- `nPos`  
+ *nPos*  
  Specifies the zero-based index of the item to retrieve.  
 
- `pHeaderItem`  
+ *pHeaderItem*  
  Pointer to an [HDITEM](http://msdn.microsoft.com/library/windows/desktop/bb775247) structure that receives the new item. This structure is used with the `InsertItem` and `SetItem` member functions. Any flags set in the **mask** element ensure that values in the corresponding elements are properly filled in upon return. If the **mask** element is set to zero, values in the other structure elements are meaningless.  
 
 ### Return Value  
@@ -421,8 +421,8 @@ BOOL GetItemDropDownRect(
 
 |Parameter|Description|  
 |---------------|-----------------|  
-|[in] `iItem`|Zero-based index of a header item whose style is `HDF_SPLITBUTTON`. For more information, see the `fmt` member of the [HDITEM](http://msdn.microsoft.com/library/windows/desktop/bb775247) structure.|  
-|[out] `lpRect`|Pointer to a [RECT](http://msdn.microsoft.com/library/windows/desktop/dd162897) structure to receive the bounding rectangle information.|  
+|[in] *iItem*|Zero-based index of a header item whose style is `HDF_SPLITBUTTON`. For more information, see the `fmt` member of the [HDITEM](http://msdn.microsoft.com/library/windows/desktop/bb775247) structure.|  
+|[out] *lpRect*|Pointer to a [RECT](http://msdn.microsoft.com/library/windows/desktop/dd162897) structure to receive the bounding rectangle information.|  
 
 ### Return Value  
  `true` if this function is successful; otherwise, `false`.  
@@ -450,10 +450,10 @@ BOOL GetItemRect(
 ```  
 
 ### Parameters  
- `nIndex`  
+ *nIndex*  
  The zero-based index of the header control item.  
 
- `lpRect`  
+ *lpRect*  
  A pointer to the address of a [RECT](http://msdn.microsoft.com/library/windows/desktop/dd162897) structure that receives the bounding rectangle information.  
 
 ### Return Value  
@@ -472,10 +472,10 @@ BOOL GetOrderArray(
 ```  
 
 ### Parameters  
- `piArray`  
+ *piArray*  
  A pointer to the address of a buffer that receives the index values of the items in the header control, in the order in which they appear from left to right.  
 
- `iCount`  
+ *iCount*  
  The number of header control items. Must be non-negative.  
 
 ### Return Value  
@@ -498,7 +498,7 @@ BOOL GetOverflowRect(LPRECT lpRect) const;
 
 |Parameter|Description|  
 |---------------|-----------------|  
-|[out] `lpRect`|Pointer to a [RECT](http://msdn.microsoft.com/library/windows/desktop/dd162897) structure that receives the bounding rectangle information.|  
+|[out] *lpRect*|Pointer to a [RECT](http://msdn.microsoft.com/library/windows/desktop/dd162897) structure that receives the bounding rectangle information.|  
 
 ### Return Value  
  `true` if this function is successful; otherwise, `false`.  
@@ -529,7 +529,7 @@ int HitTest(LPHDHITTESTINFO* phdhti);
 
 |Parameter|Description|  
 |---------------|-----------------|  
-|[in, out] `phdhti`|Pointer to a [HDHITTESTINFO](http://msdn.microsoft.com/library/windows/desktop/bb775245) structure that specifies the point to test and receives the results of the test.|  
+|[in, out] *phdhti*|Pointer to a [HDHITTESTINFO](http://msdn.microsoft.com/library/windows/desktop/bb775245) structure that specifies the point to test and receives the results of the test.|  
 
 ### Return Value  
  The zero-based index of the header item, if any, at the specified position; otherwise, -1.  
@@ -557,7 +557,7 @@ int InsertItem(
 ```  
 
 ### Parameters  
- `nPos`  
+ *nPos*  
  The zero-based index of the item to be inserted. If the value is zero, the item is inserted at the beginning of the header control. If the value is greater than the maximum value, the item is inserted at the end of the header control.  
 
  *phdi*  
@@ -614,7 +614,7 @@ int SetBitmapMargin(int nWidth);
 ```  
 
 ### Parameters  
- `nWidth`  
+ *nWidth*  
  Width, specified in pixels, of the margin that surrounds a bitmap within an existing header control.  
 
 ### Return Value  
@@ -657,7 +657,7 @@ BOOL SetFocusedItem(int iItem);
 
 |Parameter|Description|  
 |---------------|-----------------|  
-|[in] `iItem`|Zero-based index of a header item.|  
+|[in] *iItem*|Zero-based index of a header item.|  
 
 ### Return Value  
  `true` if this method is successful; otherwise, `false`.  
@@ -684,10 +684,10 @@ int SetHotDivider(int nIndex);
 ```  
 
 ### Parameters  
- `pt`  
+ *pt*  
  The position of the pointer. The header control highlights the appropriate divider based on the pointer's position.  
 
- `nIndex`  
+ *nIndex*  
  The index of the highlighted divider.  
 
 ### Return Value  
@@ -707,7 +707,7 @@ CImageList* SetImageList(CImageList* pImageList);
 ```  
 
 ### Parameters  
- `pImageList`  
+ *pImageList*  
  A pointer to a `CImageList` object containing the image list to be assigned to the header control.  
 
 ### Return Value  
@@ -729,10 +729,10 @@ BOOL SetItem(
 ```  
 
 ### Parameters  
- `nPos`  
+ *nPos*  
  The zero-based index of the item to be manipulated.  
 
- `pHeaderItem`  
+ *pHeaderItem*  
  Pointer to an [HDITEM](http://msdn.microsoft.com/library/windows/desktop/bb775247) structure that contains information about the new item.  
 
 ### Return Value  
@@ -751,10 +751,10 @@ BOOL SetOrderArray(
 ```  
 
 ### Parameters  
- `iCount`  
+ *iCount*  
  The number of header control items.  
 
- `piArray`  
+ *piArray*  
  A pointer to the address of a buffer that receives the index values of the items in the header control, in the order in which they appear from left to right.  
 
 ### Return Value