Merge pull request #2508 from damabe/1235779-2

Content updates for VS Extensibility - Part 2

Author: TrishaMc

docs/extensibility/adding-a-submenu-to-a-menu.md

@@ -17,21 +17,21 @@ manager: douge
 ms.workload: 
   - "vssdk"
 ---
-# Adding a Submenu to a Menu
-This walkthrough builds on the demonstration in [Adding a Menu to the Visual Studio Menu Bar](../extensibility/adding-a-menu-to-the-visual-studio-menu-bar.md) by showing how to add a submenu to the **TestMenu** menu.  
+# Add a Submenu to a Menu
+This walkthrough builds on the demonstration in [Add a Menu to the Visual Studio Menu Bar](../extensibility/adding-a-menu-to-the-visual-studio-menu-bar.md) by showing how to add a submenu to the **TestMenu** menu.  
 
  A submenu is a secondary menu that appears in another menu. A submenu can be identified by the arrow that follows its name. Clicking the name causes the submenu and its commands to be displayed.  
 
  This walkthrough creates a submenu in a menu on the Visual Studio menu bar and puts a new command on the submenu. The walkthrough also implements the new command.  
 
 ## Prerequisites  
- Starting in Visual Studio 2015, you do not install the Visual Studio SDK from the download center. It is included as an optional feature in Visual Studio setup. You can also install the VS SDK later on. For more information, see [Installing the Visual Studio SDK](../extensibility/installing-the-visual-studio-sdk.md).  
+ Starting in Visual Studio 2015, you do not install the Visual Studio SDK from the download center. It is included as an optional feature in Visual Studio setup. You can also install the VS SDK later on. For more information, see [Install the Visual Studio SDK](../extensibility/installing-the-visual-studio-sdk.md).  
 
-## Adding a Submenu to a Menu  
+## Add a Submenu to a Menu  
 
-1.  Follow the steps in [Adding a Menu to the Visual Studio Menu Bar](../extensibility/adding-a-menu-to-the-visual-studio-menu-bar.md) to create the project and menu item. The steps in this walkthrough assume that the name of the VSIX project is `TopLevelMenu`.  
+1.  Follow the steps in [Add a Menu to the Visual Studio Menu Bar](../extensibility/adding-a-menu-to-the-visual-studio-menu-bar.md) to create the project and menu item. The steps in this walkthrough assume that the name of the VSIX project is `TopLevelMenu`.  
 
-2.  Open TestCommandPackage.vsct. In the `<Symbols>` section, add an `<IDSymbol>` element for the submenu, one for the submenu group, and one for the command, all in the `<GuidSymbol>` node named "guidTopLevelMenuCmdSet." This is the same node that contains the `<IDSymbol>` element for the top-level menu.  
+2.  Open *TestCommandPackage.vsct*. In the `<Symbols>` section, add an `<IDSymbol>` element for the submenu, one for the submenu group, and one for the command, all in the `<GuidSymbol>` node named "guidTopLevelMenuCmdSet." This is the same node that contains the `<IDSymbol>` element for the top-level menu.  
 
     ```xml  
     <IDSymbol name="SubMenu" value="0x1100"/>  
@@ -51,7 +51,7 @@ This walkthrough builds on the demonstration in [Adding a Menu to the Visual Stu
     </Menu>  
     ```  
 
-     The GUID/ID pair of the parent specifies the menu group that was generated in [Adding a Menu to the Visual Studio Menu Bar](../extensibility/adding-a-menu-to-the-visual-studio-menu-bar.md), and is a child of the top-level menu.  
+     The GUID/ID pair of the parent specifies the menu group that was generated in [Add a Menu to the Visual Studio Menu Bar](../extensibility/adding-a-menu-to-the-visual-studio-menu-bar.md), and is a child of the top-level menu.  
 
 4.  Add the menu group defined in step 2 to the `<Groups>` section and make it a child of the submenu.  
 
@@ -78,9 +78,9 @@ This walkthrough builds on the demonstration in [Adding a Menu to the Visual Stu
 
 7.  Click **TestMenu** to see a new submenu named **Sub Menu**. Click **Sub Menu** to open the submenu and see a new command, **Test Sub Command**. Notice that clicking **Test Sub Command** does nothing.  
 
-## Adding a Command  
+## Add a Command  
 
-1.  Open TestCommand.cs and add the following command ID after the existing command ID.  
+1.  Open *TestCommand.cs* and add the following command ID after the existing command ID.  
 
     ```csharp  
     public const int cmdidTestSubCmd = 0x105;  
@@ -121,7 +121,7 @@ This walkthrough builds on the demonstration in [Adding a Menu to the Visual Stu
                 }  
     ```  
 
-3.  Add SubItemCallback(). This is the method that is called when the new command in the submenu is clicked.  
+3.  Add `SubItemCallback()`. This is the method that is called when the new command in the submenu is clicked.  
 
     ```csharp  
     private void SubItemCallback(object sender, EventArgs e)  
@@ -151,6 +151,6 @@ This walkthrough builds on the demonstration in [Adding a Menu to the Visual Stu
 
 5.  On the **TestMenu** menu, click **Sub Menu** and then click **Test Sub Command**. A message box should appear and display the text, "Test Command Inside TestCommand.SubItemCallback()".  
 
-## See Also  
- [Adding a Menu to the Visual Studio Menu Bar](../extensibility/adding-a-menu-to-the-visual-studio-menu-bar.md)   
- [Commands, Menus, and Toolbars](../extensibility/internals/commands-menus-and-toolbars.md)
+## See also  
+ [Add a menu to the Visual Studio menu bar](../extensibility/adding-a-menu-to-the-visual-studio-menu-bar.md)   
+ [Commands, menus, and toolbars](../extensibility/internals/commands-menus-and-toolbars.md)

docs/extensibility/adding-a-tool-window.md

@@ -15,7 +15,7 @@ manager: douge
 ms.workload: 
   - "vssdk"
 ---
-# Adding a Tool Window
+# Add a tool window
 In this walkthrough you learn how to create a tool window and integrate it into Visual Studio in the following ways:  
 
 -   Add a control to the tool window.  
@@ -29,25 +29,25 @@ In this walkthrough you learn how to create a tool window and integrate it into
 -   Set the default position for the tool window.  
 
 ## Prerequisites  
- Starting in Visual Studio 2015, you do not install the Visual Studio SDK from the download center. It is included as an optional feature in Visual Studio setup. You can also install the VS SDK later on. For more information, see [Installing the Visual Studio SDK](../extensibility/installing-the-visual-studio-sdk.md).  
+ Starting in Visual Studio 2015, you do not install the Visual Studio SDK from the download center. It is included as an optional feature in Visual Studio setup. You can also install the VS SDK later on. For more information, see [Install the Visual Studio SDK](../extensibility/installing-the-visual-studio-sdk.md).  
 
-## Creating a Tool Window  
+## Create a tool window  
 
 1.  Create a project named **FirstToolWin** using the VSIX template, and add a custom tool window item template named **FirstToolWindow**.  
 
     > [!NOTE]
-    >  For more information about creating an extension with a tool window, see [Creating an Extension with a Tool Window](../extensibility/creating-an-extension-with-a-tool-window.md).  
+    >  For more information about creating an extension with a tool window, see [Create an extension with a tool window](../extensibility/creating-an-extension-with-a-tool-window.md).  
   
-## Add a Control to the Tool Window  
+## Add a control to the tool window  
 
-1.  Remove the default control. Open FirstToolWindowControl.xaml and delete the **Click Me!** button.  
+1.  Remove the default control. Open *FirstToolWindowControl.xaml* and delete the **Click Me!** button.  
 
 2.  In the **Toolbox**, expand the **All WPF Controls** section and drag the **Media Element** control to the **FirstToolWindowControl** form. Select the control, and in the **Properties** window, name this element **mediaElement1**.  
 
-## Add a Toolbar to the Tool Window  
+## Add a toolbar to the tool window  
  By adding a toolbar in the following manner, you guarantee that its gradients and colors are consistent with the rest of the IDE.  
 
-1.  In **Solution Explorer**, open FirstToolWindowPackage.vsct. The .vsct file defines the graphical user interface (GUI) elements in your tool window by using XML.  
+1.  In **Solution Explorer**, open *FirstToolWindowPackage.vsct*. The *.vsct* file defines the graphical user interface (GUI) elements in your tool window by using XML.  
 
 2.  In the `<Symbols>` section, find the `<GuidSymbol>` node whose `name` attribute is `guidFirstToolWindowPackageCmdSet`. Add the following two `<IDSymbol>` elements to the list of `<IDSymbol>` elements in this node to define a toolbar and a toolbar group.  
 
@@ -86,7 +86,7 @@ In this walkthrough you learn how to create a tool window and integrate it into
 
      By setting the parent GUID and ID to the GUID and ID of the toolbar, you add the group to the toolbar.  
 
-## Add a Command to the Toolbar  
+## Add a command to the toolbar  
  Add a command to the toolbar, which is displayed as a button.  
 
 1.  In the `<Symbols>` section, declare the following IDSymbol elements just after the toolbar and toolbar group declarations.  
@@ -96,7 +96,7 @@ In this walkthrough you learn how to create a tool window and integrate it into
     <IDSymbol name="cmdidWindowsMediaOpen" value="0x132" />  
     ```  
 
-2.  Add a Button element inside the `<Buttons>` section. This element will appear on the toolbar in the tool window, with a Search (magnifying glass) icon.  
+2.  Add a Button element inside the `<Buttons>` section. This element will appear on the toolbar in the tool window, with a **Search** (magnifying glass) icon.  
 
     ```xml  
     <Button guid="guidFirstToolWindowPackageCmdSet" id="cmdidWindowsMediaOpen" priority="0x0101" type="Button">  
@@ -109,7 +109,7 @@ In this walkthrough you learn how to create a tool window and integrate it into
     </Button>  
     ```  
 
-3.  Open FirstToolWindowCommand.cs and add the following lines in the class just after the existing fields.  
+3.  Open *FirstToolWindowCommand.cs* and add the following lines in the class just after the existing fields.  
 
     ```csharp  
     public const string guidFirstToolWindowPackageCmdSet = "00000000-0000-0000-0000-0000";  // get the GUID from the .vsct file  
@@ -120,10 +120,10 @@ In this walkthrough you learn how to create a tool window and integrate it into
 
      Doing this makes your commands available in code.  
 
-## Add a MediaPlayer Property to FirstToolWindowControl  
+## Add a MediaPlayer property to FirstToolWindowControl  
  From the event handlers for the toolbar controls, your code must be able to access the Media Player control, which is a child of the FirstToolWindowControl class.  
 
- In **Solution Explorer**, right-click FirstToolWindowControl.xaml, click **View Code**, and add the following code to the FirstToolWindowControl Class.  
+ In **Solution Explorer**, right-click *FirstToolWindowControl.xaml*, click **View Code**, and add the following code to the FirstToolWindowControl class.  
 
 ```csharp  
 public System.Windows.Controls.MediaElement MediaPlayer  
@@ -132,10 +132,10 @@ public System.Windows.Controls.MediaElement MediaPlayer
 }  
 ```  
 
-## Instantiate the Tool Window and Toolbar  
+## Instantiate the tool window and toolbar  
  Add a toolbar and a menu command that invokes the **Open File** dialog and plays the selected media file.  
 
-1.  Open FirstToolWindow.cs and add the following `using` statements.  
+1.  Open *FirstToolWindow.cs* and add the following `using` statements.  
 
     ```csharp  
     using System.ComponentModel.Design;  
@@ -198,7 +198,7 @@ public System.Windows.Controls.MediaElement MediaPlayer
     mcs.AddCommand(menuItem);  
     ```  
 
-#### To implement a menu command in the tool window  
+### To implement a menu command in the tool window  
 
 1.  In the FirstToolWindowCommand class, add a ButtonHandler method that invokes the **Open File** dialog. When a file has been selected, it plays the media file.  
 
@@ -245,10 +245,10 @@ public System.Windows.Controls.MediaElement MediaPlayer
     }  
     ```  
 
-## Set the Default Position for the Tool Window  
- Next, specify a default location in the IDE for the tool window. Configuration information for the tool window is in the FirstToolWindowPackage.cs file.  
+## Set the default position for the tool window  
+ Next, specify a default location in the IDE for the tool window. Configuration information for the tool window is in the *FirstToolWindowPackage.cs* file.  
 
-1.  In FirstToolWindowPackage.cs, find the <xref:Microsoft.VisualStudio.Shell.ProvideToolWindowAttribute> attribute on the `FirstToolWindowPackage` class, which passes the FirstToolWindow type to the constructor. To specify a default position, you must add more parameters to the constructor following example.  
+1.  In *FirstToolWindowPackage.cs*, find the <xref:Microsoft.VisualStudio.Shell.ProvideToolWindowAttribute> attribute on the `FirstToolWindowPackage` class, which passes the FirstToolWindow type to the constructor. To specify a default position, you must add more parameters to the constructor following example.  
 
     ```csharp  
     [ProvideToolWindow(typeof(FirstToolWindow),  
@@ -261,17 +261,17 @@ public System.Windows.Controls.MediaElement MediaPlayer
     > [!NOTE]
     >  For more information about the types of windows in the IDE, see <xref:EnvDTE.vsWindowType>.  
 
-## Testing the Tool Window  
+## Test the tool window  
 
-1.  Press F5 to open a new instance of the Visual Studio experimental build.  
+1.  Press **F5** to open a new instance of the Visual Studio experimental build.  
 
 2.  On the **View** menu, point to **Other Windows** and then click **First Tool Window**.  
 
      The media player tool window should open in the same position as **Solution Explorer**. If it still appears in the same position as before, reset the window layout (**Window / Reset Window Layout**).  
 
-3.  Click the button (it has the Search icon) in the tool window. Select a supported sound or video file, for example, C:\windows\media\chimes.wav, then press **Open**.  
+3.  Click the button (it has the **Search** icon) in the tool window. Select a supported sound or video file, for example, *C:\windows\media\chimes.wav*, then press **Open**.  
 
      You should hear the chime sound.  
 
-## See Also  
- [Commands, Menus, and Toolbars](../extensibility/internals/commands-menus-and-toolbars.md)
+## See also  
+ [Commands, menus, and toolbars](../extensibility/internals/commands-menus-and-toolbars.md)

docs/extensibility/adding-a-toolbar-to-a-tool-window.md

@@ -15,23 +15,23 @@ manager: douge
 ms.workload: 
   - "vssdk"
 ---
-# Adding a Toolbar to a Tool Window
+# Add a toolbar to a tool window
 This walkthrough shows how to add a toolbar to a tool window.  
 
  A toolbar is a horizontal or vertical strip that contains buttons bound to commands. The length of a toolbar in a tool window is always the same as the width or height of the tool window, depending on where the toolbar is docked.  
 
  Unlike toolbars in the IDE, a toolbar in a tool window must be docked and cannot be moved or customized. If the VSPackage is written in umanaged code, the toolbar can be docked on any edge.  
 
- For more information about how to add a toolbar, see [Adding a Toolbar](../extensibility/adding-a-toolbar.md).  
+ For more information about how to add a toolbar, see [Adding a toolbar](../extensibility/adding-a-toolbar.md).  
 
 ## Prerequisites  
  Starting in Visual Studio 2015, you do not install the Visual Studio SDK from the download center. It is included as an optional feature in Visual Studio setup. You can also install the VS SDK later on. For more information, see [Installing the Visual Studio SDK](../extensibility/installing-the-visual-studio-sdk.md).  
 
-## Creating a Toolbar for a Tool Window  
+## Create a toolbar for a tool window  
 
-1.  Create a VSIX project named `TWToolbar` that has both a menu command named **TWTestCommand** and a tool window named **TestToolWindow**. For more information, see [Creating an Extension with a Menu Command](../extensibility/creating-an-extension-with-a-menu-command.md) and [Creating an Extension with a Tool Window](../extensibility/creating-an-extension-with-a-tool-window.md). You need to add the command item template before adding the tool window template.  
+1.  Create a VSIX project named `TWToolbar` that has both a menu command named **TWTestCommand** and a tool window named **TestToolWindow**. For more information, see [Create an extension with a menu command](../extensibility/creating-an-extension-with-a-menu-command.md) and [Create an extension with a tool window](../extensibility/creating-an-extension-with-a-tool-window.md). You need to add the command item template before adding the tool window template.  
 
-2.  In TWTestCommandPackage.vsct, look for the Symbols section. In the GuidSymbol node named guidTWTestCommandPackageCmdSet declare a toolbar and a toolbar group, as follows.  
+2.  In *TWTestCommandPackage.vsct*, look for the Symbols section. In the GuidSymbol node named guidTWTestCommandPackageCmdSet declare a toolbar and a toolbar group, as follows.  
 
     ```xml  
     <IDSymbol name="TWToolbar" value="0x1000" />  
@@ -52,7 +52,7 @@ This walkthrough shows how to add a toolbar to a tool window.
     </Menus>  
     ```  
 
-     Toolbars cannot be nested like submenus. Therefore, you do not have to assign a parent. Also, you do not have to set a priority, because the user can move toolbars. Typically, initial placement of a toolbar is defined programmatically, but subsequent changes by the user are persisted.  
+     Toolbars can't be nested like submenus. Therefore, you don't have to assign a parent. Also, you don't have to set a priority, because the user can move toolbars. Typically, initial placement of a toolbar is defined programmatically, but subsequent changes by the user are persisted.  
 
 4.  In the Groups section, define a group to contain the commands for the toolbar.  
 
@@ -79,16 +79,16 @@ This walkthrough shows how to add a toolbar to a tool window.
 
      Because the new toolbar is not automatically added to the tool window, the toolbar must be added explicitly. This is discussed in the next section.  
 
-## Adding the Toolbar to the Tool Window  
+## Add the toolbar to the tool window  
 
-1.  In TWTestCommandPackageGuids.cs add the following lines.  
+1.  In *TWTestCommandPackageGuids.cs* add the following lines.  
 
     ```csharp  
     public const string guidTWTestCommandPackageCmdSet = "00000000-0000-0000-0000-0000";  // get the GUID from the .vsct file  
     public const int TWToolbar = 0x1000;  
     ```  
 
-2.  In TestToolWindow.cs add the following using statement.  
+2.  In *TestToolWindow.cs* add the following using statement.  
 
     ```csharp  
     using System.ComponentModel.Design;  
@@ -100,7 +100,7 @@ This walkthrough shows how to add a toolbar to a tool window.
     this.ToolBar = new CommandID(new Guid(TWTestCommandPackageGuids.guidTWTestCommandPackageCmdSet), TWTestCommandPackageGuids.TWToolbar);  
     ```  
 
-## Testing the Toolbar in the Tool Window  
+## Test the toolbar in the tool window  
 
 1.  Build the project and start debugging. The Visual Studio experimental instance should appear.  
 
@@ -110,5 +110,5 @@ This walkthrough shows how to add a toolbar to a tool window.
 
 3.  On the toolbar, click the icon to display the message **TWTestCommandPackage Inside TWToolbar.TWTestCommand.MenuItemCallback()**.  
 
-## See Also  
- [Adding a Toolbar](../extensibility/adding-a-toolbar.md)
+## See also  
+ [Add a toolbar](../extensibility/adding-a-toolbar.md)