Merge pull request #3360 from v-thepet/debug3

Refresh view-data-values-in-data-tips-in-the-code-editor and how-to-use-the-threads-window

Author: itechedit

docs/debugger/how-to-use-the-threads-window.md

@@ -1,7 +1,7 @@
 ---
 title: "View data values in DataTips in the code editor | Microsoft Docs"
 ms.custom: ""
-ms.date: "07/14/2017"
+ms.date: "11/21/2018"
 ms.technology: "vs-ide-debug"
 ms.topic: "conceptual"
 dev_langs: 
@@ -21,120 +21,108 @@ ms.workload:
   - "multiple"
 ---
 # View data values in DataTips in the code editor
-DataTips provide a convenient way to view information about variables in your program during debugging. DataTips work only in break mode and only with variables that are in the current scope of execution. If this is the first time that you've tried to debug code, you may want to read [Write better C# code using Visual Studio](../debugger/write-better-code-with-visual-studio.md) and [Debugging for absolute beginners](../debugger/debugging-absolute-beginners.md) before going through this article.
-  
-### To display a DataTip  
-  
-1. Set a breakpoint and start debugging (press **F5**).
 
-2. Where paused in the debugger, place the mouse pointer over any variable in the current scope.
-  
-     A DataTip appears.
+DataTips are a convenient way to view information about variables in your app during debugging. 
+
+If this is your first time debugging, you may want to read [Write better C# code using Visual Studio](../debugger/write-better-code-with-visual-studio.md) and [Debugging for absolute beginners](../debugger/debugging-absolute-beginners.md) before you read this article.
 
-3.  The DataTip disappears when you remove the mouse pointer. To pin the DataTip so that it remains open, click the **Pin to source** icon, or right-click on a variable, then click **Pin to source**.
+## Work with DataTips
 
-    ![Pinning a Data Tip](../debugger/media/dbg-tips-data-tips-pinned.png "PinningDataTip")
+DataTips appear only in break mode, and only on variables that are in the current scope of execution.
 
-    > [!NOTE]
-    > Data tips are always evaluated in the context where execution is suspended, and not where the cursor is hovering. If you hover over a variable in another function with the same name as a variable that is in the current context, the value of the variable in the other function is displayed as the value of the variable in the current context.
+### Display a DataTip  
 
-### To unpin a DataTip and make it float  
+1. Set a breakpoint in your code, and start debugging by pressing **F5** or selecting **Debug** > **Start Debugging**.
 
--   In a pinned DataTip, click the **Unpin from source** icon.  
-  
-     The pin icon changes to the unpinned position. The DataTip now floats above any open windows. The floating DataTip closes when the debugging session ends.  
+1. When paused at the breakpoint, hover over any variable in the current scope. A DataTip appears, showing the name and current value of the variable.
+
+### Make a DataTip transparent  
+
+To make a DataTip transparent to see code that is underneath it, while in the DataTip, press **Ctrl**. The DataTip stays transparent as long as you hold down the **Ctrl** key. This doesn't work for pinned or floating DataTips.  
+### Pin a DataTip
+
+To pin a DataTip so that it stays open, select the pushpin **Pin to source** icon. 
+
+![Pin a DataTip](../debugger/media/dbg-tips-data-tips-pinned.png "Pin a DataTip")
+
+You can move a pinned DataTip by dragging it around the code window. A pushpin icon appears in the gutter next to the line the DataTip is pinned to. 
+
+>[!NOTE]
+>DataTips are always evaluated in the context where execution is suspended, not the current cursor or DataTip location. If you hover over a variable in another function that has the same name as a variable in the current context, the value of the variable in the current context is displayed.
   
-### To repin a floating DataTip  
+### Unpin a DataTip from source
+
+To float a pinned DataTip, hover over the DataTip and select the pushpin icon from the context menu. 
+
+The pushpin icon changes to the unpinned position, and the DataTip now floats or can be dragged above all open windows. Floating DataTips close when the debugging session ends.  
 
--   In a DataTip, click the pin icon.  
+### Repin a DataTip  
 
-     The pin icon changes to the pinned position. If the DataTip is outside a source window, the pin icon is disabled and the DataTip cannot be pinned.  
+To repin a floating DataTip to source, hover over it in the code editor and select the pushpin icon. The pushpin icon changes to the pinned position, and the DataTip is again pinned only to the code window. 
+
+If a DataTip is floating over a non-source code window, the pushpin icon is unavailable, and the DataTip cannot be repinned. To access the pushpin icon, return the DataTip to the code editor window by dragging it or giving the code window focus. 
 
-### To close a DataTip  
+### Close a DataTip  
 
--   Place the mouse pointer over a DataTip, and then click the **Close** icon.  
+To close a DataTip, hover over the DataTip and select the close (**x**) icon from the context menu.  
 
-### To close all DataTips  
+### Close all DataTips  
 
--   On the **Debug** menu, click **Clear All DataTips**.  
+To close all DataTips, on the **Debug** menu, select **Clear All DataTips**.  
 
-### To close all DataTips for a specific file  
+### Close all DataTips for a specific file  
 
--   On the **Debug** menu, click **Clear All DataTips Pinned to** *File*.  
+To close all DataTips for a specific file, on the **Debug** menu, select **Clear All DataTips Pinned to \<Filename>**.  
 
 ## Expand and edit information  
- You can use DataTips to expand an array, a structure, or an object to view its members. You can also edit the value of a variable from a DataTip.  
-  
-#### To expand a variable to see its elements  
-  
--   In a DataTip, put the mouse pointer over the **+** sign that comes before the variable name.  
+You can use DataTips to expand an array, a structure, or an object to view its members. You can also edit the value of a variable from a DataTip.  
 
-    The variable expands to show its elements in tree form.
+### Expand a variable
+
+To expand an object in a DataTip to see its elements, hover over the expand arrows before the item names to display the elements in tree form. For a pinned DataTip, select the **+** before the variable name and then expand the tree. 
+
+![Expand a DataTip](../debugger/media/dbg-tour-data-tips.png "Expand a DataTip")
+
+You can use the mouse or the arrow keys on the keyboard to move up and down in the expanded view. 
+
+You can also pin expanded items to the pinned DataTip by hovering over them and selecting their pushpin icons. The elements then appear in the pinned DataTip after the tree is collapsed. 
+
+### Edit the value of a variable
+
+To edit the value of a variable or element in a DataTip, select the value, type a new value, and press **Enter**. Selection is disabled for read-only values.  
 
-    ![View a Data Tip](../debugger/media/dbg-tour-data-tips.gif "View a data tip")
-  
-    When the variable is expanded, you can use the arrow keys on your keyboard to move up and down. Alternatively, you can use the mouse.  
-  
-#### To edit the value of a variable using a DataTip  
-  
-1.  In a DataTip, click the value. This is disabled for read-only values.  
-  
-2.  Type a new value and press ENTER.  
-  
-## Making a DataTip Transparent  
- If you want to see the code that is behind a DataTip, you can make the DataTip temporarily transparent. This does not apply to DataTips that are pinned or floating.  
-  
-#### To make a DataTip transparent  
-  
--   In a DataTip, press CTRL.  
-  
-     The DataTip will remain transparent as long as you hold down the CTRL key.  
-  
 ## Visualize complex data types  
- If a magnifying glass icon appears next to a variable name in a DataTip, one or more [visualizers](../debugger/create-custom-visualizers-of-data.md), such as the [string visualizers](../debugger/string-visualizer-dialog-box.md), are available for variables of that data type. You can use a visualizer to display the information in a more meaningful, usually graphical, manner.
-  
-#### To view the contents of a variable using a visualizer  
-  
--   Click the magnifying glass icon ![VisualizerIcon](../debugger/media/dbg-tips-visualizer-icon.png "Visualizer icon") to select the default visualizer for the data type.  
-  
-     -or-  
-  
-     Click the pop-up arrow next to the visualizer to select from a list of appropriate visualizers for the data type.  
-  
-     A visualizer displays the information.  
-  
-## Add information to a Watch window  
- If you want to continue to watch a variable in a list view, you can add the variable to the **Watch** window from a DataTip.  
-  
-#### To add a variable to the Watch window  
-  
--   Right-click a DataTip, and then click **Add Watch**.  
+
+A magnifying glass icon next to a variable or element in a DataTip means that one or more [visualizers](../debugger/create-custom-visualizers-of-data.md), such as the [Text Visualizer](../debugger/string-visualizer-dialog-box.md), are available for the variable. Visualizers display information in a more meaningful, sometimes graphical, manner.
 
-     The variable is added to the **Watch** window. If you are using an edition that supports multiple **Watch** windows, the variable is added to **Watch 1.**  
+To view the element using the default visualizer for the data type, select the magnifying glass icon ![Visualizer icon](../debugger/media/dbg-tips-visualizer-icon.png "Visualizer icon"). Select the arrow next to the magnifying glass icon to select from a list of visualizers for the data type.  
+
+## Add a variable to a Watch window  
+
+If you want to continue to watch a variable, you can add it to a **Watch** window from a DataTip. Right-click the variable in the DataTip, and select **Add Watch**. 
+
+The variable appears in the **Watch** window. If your Visual Studio edition supports more than one **Watch** window, the variable appears in **Watch 1**. 
 
 ## Import and export DataTips  
- You can export DataTips to an XML file, which can be shared with a colleague or edited using a text editor.  
-  
-#### To Export DataTips  
-  
-1.  On the Debug menu, click **Export DataTips**.  
-  
-     The **Export DataTips** dialog box appears.  
-  
-2.  Use standard file techniques to navigate to the location where you want to save the XML file, type a name for the file in the **File name** box, and then click **OK**.  
-  
-#### To Import DataTips  
+
+You can export DataTips to an XML file, which you can share or edit using a text editor. You can also import a DataTip XML file you have received or edited. 
 
-1.  On the Debug menu, click **Import DataTips**.  
+**To export DataTips:** 
 
-     The **Import DataTips** dialog box appears.  
+1. Select **Debug** > **Export DataTips**.  
+   
+1. In the **Export DataTips** dialog box, navigate to the location to save the XML file, type a name for the file, and then select **Save**.  
 
-2.  Use the dialog box to find the XML file that you want to open and click **OK**.  
+**To import DataTips:** 
 
-## See Also  
+1. Select **Debug** > **Import DataTips**.  
+   
+1. In the **Import DataTips** dialog box, select the DataTips XML file you want to open, and then select **Open**.  
+
+## See also  
  [What is debugging?](../debugger/what-is-debugging.md)  
  [Write better C# code using Visual Studio](../debugger/write-better-code-with-visual-studio.md)  
- [First look at debugging](../debugger/debugger-feature-tour.md) 
- [Viewing Data in the Debugger](../debugger/viewing-data-in-the-debugger.md)   
- [Watch and QuickWatch Windows](../debugger/watch-and-quickwatch-windows.md)   
- [Create Custom Visualizers](../debugger/create-custom-visualizers-of-data.md)   
+ [First look at debugging](../debugger/debugger-feature-tour.md)   
+ [View data in the debugger](../debugger/viewing-data-in-the-debugger.md)   
+ [Watch and QuickWatch windows](../debugger/watch-and-quickwatch-windows.md)   
+ [Create custom visualizers](../debugger/create-custom-visualizers-of-data.md)