blob: 764ee6c0b06ca9471f23b46d45a4b8ce1d7b0e89 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html lang="en">
<head>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2017. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<meta http-equiv="Content-Style-Type" content="text/css">
<link rel="stylesheet" href="../../../book.css" charset="ISO-8859-1" type="text/css">
<title>Expressions View</title>
</head>
<body>
<h1> Expressions View </h1>
<p> Data can be inspected in the <strong>Expressions View</strong>. You can inspect data from a
scrapbook page, a stack frame of a suspended thread, and other places. The Expressions
View opens automatically when an item is added to the view. Entries in the Expressions View can be selected to have more detailed information be displayed in the <a href="../../../reference/views/shared/ref-detailpane.htm"><strong>Detail Pane</strong></a>. When debugging a Java program, data that contains variables can be expanded to show the variables and the fields the variables contain.</p>
<p>The Expressions View. The <a href="../../../reference/views/shared/ref-detailpane.htm">Detail Pane</a> is the area at the bottom of the view displaying text..</p>
<p><img src="../../../reference/views/expressions/images/ref-expressions_view.PNG" alt="Expressions View"></p>
<p>There are many commands available in the Expressions View:</p>
<ul>
<li><a href="../../../reference/views/shared/ref-viewdisplaycommands.htm"><strong>View Display Commands</strong></a> affect what data and variables are displayed and how they are presented.</li>
<li>The <a href="../../../reference/views/shared/ref-detailpane.htm"><strong>Detail Pane</strong></a> has many commands available by right clicking on it.</li>
<li><a href="../../../reference/views/shared/ref-viewlayoutcommands.htm"><strong>View Layout Commands</strong></a> affect how the detail pane is oriented.</li>
<li>Other commands are listed below. </li>
</ul>
<table border="1" cellpadding="5" cellspacing="0">
<caption>
Variables View Commands
</caption>
<thead>
<tr>
<td colspan="1" valign="top" align="left"><img src="../../../images/org.eclipse.debug.ui/elcl16/monitorexpression_tsk.png" alt="Add Watch Expression"></td>
<td colspan="1" valign="top" align="left" ><a href="../../../reference/views/expressions/ref-addwatch.htm"><strong>Add Watch Expression</strong></a></td>
<td colspan="1" valign="top" align="left" >Allows you to add a watch expression.</td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left"><img src="../../../images/org.eclipse.jdt.debug.ui/elcl16/all_instances.png" alt="All References"></td>
<td colspan="1" valign="top" align="left" ><a href="../../../reference/views/shared/ref-allinstances.htm"><strong>All Instances</strong></a></td>
<td colspan="1" valign="top" align="left" >Opens a popup dialog displaying a list of all instances of the selected Java type. Your Java virtual machine must support instance retrieval. </td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left"><img src="../../../images/org.eclipse.jdt.debug.ui/elcl16/all_references.png" alt="All References"></td>
<td colspan="1" valign="top" align="left" ><a href="../../../reference/views/shared/ref-allreferences.htm"><strong>All References</strong></a></td>
<td colspan="1" valign="top" align="left" >Opens a popup dialog displaying a list of all Java objects that have references to the selected variable. Your Java virtual machine must support reference retrieval. </td>
<td>Context menu </td>
</tr>
</thead>
<tbody>
<tr>
<td colspan="1" valign="top" align="left"><img src="../../../images/org.eclipse.debug.ui/elcl16/changevariablevalue_co.png" alt="Change Value"></td>
<td colspan="1" valign="top" align="left" ><a href="../../../reference/views/shared/ref-changevarvalue.htm"><strong>Change Value...</strong></a></td>
<td colspan="1" valign="top" align="left" >Allows you to change the value for the underlying selected variable.</td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left"><img src="../../../images/org.eclipse.debug.ui/elcl16/collapseall.png" alt="Collapse All"></td>
<td colspan="1" valign="top" align="left" ><a href="../../../reference/views/shared/ref-collapseall.htm"><strong>Collapse All</strong></a></td>
<td colspan="1" valign="top" align="left" >Collapses all the currently expanded variables.</td>
<td>View action </td>
</tr>
<tr>
<td rowspan="1" colspan="1" valign="top" align="left"><img src="../../../images/org.eclipse.debug.ui/elcl16/copy_edit_co.png" alt="Copy Expressions"></td>
<td rowspan="1" colspan="1" valign="top" align="left" ><p><a href="../../../reference/views/shared/ref-copy.htm"><strong>Copy Expressions </strong></a></p></td>
<td rowspan="1" colspan="1" valign="top" align="left" ><p> Copies the selected expressions and variables to the system clipboard.</p></td>
<td>Context menu</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">&nbsp;</td>
<td colspan="1" valign="top" align="left" ><a href="../../../reference/views/expressions/ref-convert.htm"><strong>Convert to Watch Expression</strong></a></td>
<td colspan="1" valign="top" align="left" >Converts the selected inspect expression to a corresponding watch expression.</td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">&nbsp;</td>
<td colspan="1" valign="top" align="left" ><a href="../../../reference/views/expressions/ref-disable.htm"><strong>Disable</strong></a></td>
<td colspan="1" valign="top" align="left" >Disables a currently enabled expression.</td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">&nbsp;</td>
<td colspan="1" valign="top" align="left" ><a href="../../../reference/views/expressions/ref-edit.htm"><strong>Edit Watch Expression</strong></a></td>
<td colspan="1" valign="top" align="left" >Allows you to edit the currently selected expression.</td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">&nbsp;</td>
<td colspan="1" valign="top" align="left" ><a href="../../../reference/views/expressions/ref-enable.htm"><strong>Enable</strong></a></td>
<td colspan="1" valign="top" align="left" >Enables a currently disabled expression.</td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">&nbsp;</td>
<td colspan="1" valign="top" align="left" ><a href="../../../reference/views/shared/ref-find.htm"><strong>Find...</strong></a></td>
<td colspan="1" valign="top" align="left" >Opens the search dialog to find elements in the variables view.</td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left"><img src="../../../images/org.eclipse.jdt.debug.ui/obj16/insp_sbook.png" alt="Inspect"></td>
<td colspan="1" valign="top" align="left" ><a href="../../../reference/views/shared/ref-inspectvariable.htm"><strong>Inspect</strong></a></td>
<td colspan="1" valign="top" align="left" >Creates a new inspect expression for the selected variable and adds it to the view.</td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">&nbsp;</td>
<td colspan="1" valign="top" align="left">Instance Breakpoints...</td>
<td colspan="1" valign="top" align="left">Allows you to filter existing breakpoints to the selected variable instance.</td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">&nbsp;</td>
<td colspan="1" valign="top" align="left" ><a href="../../../reference/views/shared/ref-preferences.htm"><strong>Java Preferences...</strong></a></td>
<td colspan="1" valign="top" align="left" >Opens several preference pages containing options that affect the view. </td>
<td>View action </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">&nbsp;</td>
<td colspan="1" valign="top" align="left">New Detail Formatter...</td>
<td colspan="1" valign="top" align="left">Allows you to create your own detail formatter for that type of variable.</td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">&nbsp;</td>
<td colspan="1" valign="top" align="left">Open Actual Type </td>
<td colspan="1" valign="top" align="left">Opens the actual type of the selected variable.</td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">&nbsp;</td>
<td colspan="1" valign="top" align="left">Open Actual Type Hierarchy </td>
<td colspan="1" valign="top" align="left">Opens the actual type hierarchy for the actual type of the selected variable. </td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">&nbsp;</td>
<td colspan="1" valign="top" align="left">Open Declared Type </td>
<td colspan="1" valign="top" align="left">Opens the declared type for the selected variable in a new editor. </td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">&nbsp;</td>
<td colspan="1" valign="top" align="left">Open Declared Type Hierarchy </td>
<td colspan="1" valign="top" align="left">Opens the type hierarchy for the declared type of the selected variable. </td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">&nbsp;</td>
<td colspan="1" valign="top" align="left" ><a href="../../../reference/views/expressions/ref-reevaluate.htm"><strong>Reevaluate Expression</strong></a></td>
<td colspan="1" valign="top" align="left" >Reevaluates the currently selected expression.</td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left"><img src="../../../images/org.eclipse.debug.ui/elcl16/rem_co.png" alt="remove Selected Expression(s)"></td>
<td colspan="1" valign="top" align="left" ><a href="../../../reference/views/expressions/ref-remove.htm"><strong>Remove</strong></a></td>
<td colspan="1" valign="top" align="left" >Removes the currently selected expression(s) from the view.</td>
<td>Context menu and view action </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left"><img src="../../../images/org.eclipse.debug.ui/elcl16/rem_all_co.png" alt="Remove All"></td>
<td colspan="1" valign="top" align="left" ><a href="../../../reference/views/expressions/ref-removeall.htm"><strong>Remove All</strong></a></td>
<td colspan="1" valign="top" align="left" >Removes all of the expressions from the view. </td>
<td>Context menu and view action </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">&nbsp;</td>
<td colspan="1" valign="top" align="left" ><a href="../../../reference/views/shared/ref-selectall.htm"><strong>Select All</strong></a></td>
<td colspan="1" valign="top" align="left" >Selects all of the variables in the view.</td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">&nbsp;</td>
<td colspan="1" valign="top" align="left" >Show Logical Structure </td>
<td colspan="1" valign="top" align="left" >Allows you to select a formatter for showing the selected logical structure type variable. </td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">&nbsp;</td>
<td colspan="1" valign="top" align="left" >&emsp;Edit Logical Structure </td>
<td colspan="1" valign="top" align="left" >Opens preference page to edit logical structures. </td>
<td>Sub Context menu</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left">&nbsp;</td>
<td colspan="1" valign="top" align="left" >Show Details As... </td>
<td colspan="1" valign="top" align="left" >Allows you to select a different detail pane for showing detailed information about selected variables. </td>
<td>Context menu </td>
</tr>
<tr>
<td colspan="1" valign="top" align="left"><img src="../../../images/org.eclipse.jdt.debug.ui/obj16/readwrite_obj.png" alt="Toggle Watchpoint"></td>
<td colspan="1" valign="top" align="left" ><a href="../../../reference/views/shared/ref-togglewp.htm"><strong>Toggle Watchpoint </strong></a></td>
<td colspan="1" valign="top" align="left" > Creates a new watchpoint on the currently selected field or removes the watchpoint if one already exists. </td>
<td>Context menu </td>
</tr>
</tbody>
</table>
<p><img border="0" src="../../../images/ngrelc.png" alt="Related concepts" > </p>
<p> <a href="../../../concepts/concept-java-views.htm">Java views</a><br>
<a href="../../../concepts/concept-java-perspective.htm">Java perspectives</a><br>
<a href="../../../concepts/cscrapbook.htm">Scrapbook</a> </p>
<p> <img border="0" src="../../../images/ngrelt.png" alt="Related tasks" > </p>
<p> <a href="../../../tasks/task-evaluating_expressions.htm">Evaluating expressions</a><br>
<a href="../../../tasks/task-suspending_threads.htm">Suspending threads</a> </p>
<p> <img border="0" src="../../../images/ngrelr.png" alt="Related reference" > </p>
<p><a href="../../views/shared/ref-detailpane.htm">Detail Pane<br>
</a><a href="../../../reference/views/shared/ref-viewdisplaycommands.htm">View Display Commands</a><br>
<a href="../../../reference/views/shared/ref-viewlayoutcommands.htm">View Layout Commands</a></p>
<p>&nbsp;</p>
</body>
</html>