blob: f2be93812fce9e68a4c1336ec4a28ac3b9b6fd00 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2007. 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>Variables View</title>
</head>
<body>
<h1> Variables View </h1>
<p> The <strong>Variables View </strong>displays information about the variables associated with the stack frame selected in the <a href="../../../reference/views/debug/ref-debug_view.htm"><strong>Debug View</strong></a>. When debugging a Java program, variables 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>. In addition, Java objects can be expanded to show the fields that variable contains. </p>
<p>The Variables View, shown with columns. The <a href="../../../reference/views/shared/ref-detailpane.htm"></a> detail pane the area at the bottom of the view displaying text. </p>
<p><img src="../../../reference/views/variables/images/ref-variables_view.PNG" alt="Variables View with columns"></p>
<p>There are many commands available in the Variables View:</p>
<ul>
<li><a href="../../../reference/views/shared/ref-viewdisplaycommands.htm"><strong>View Display Commands</strong></a> affect what 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 and whether columns are displayed.</li>
<li>Other commands are listed below. </li>
</ul>
<table border="1" cellspacing="0" cellpadding="5">
<caption>
Variables View Commands
</caption>
<thead>
<tr>
<th rowspan="1" colspan="1"> <p> Command </p></th>
<th rowspan="1" colspan="1"> <p> Name </p></th>
<th rowspan="1" colspan="1"> <p> Description </p></th>
<th rowspan="1" colspan="1"> <p> Availability </p></th>
</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 displayinga 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 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 Variables</strong></a></p></td>
<td rowspan="1" colspan="1" valign="top" align="left" ><p> Copies the selected variables to the system clipboard.</p></td>
<td>Context menu</td>
</tr>
<tr>
<td colspan="1" valign="top" align="left"><img src="../../../images/org.eclipse.debug.ui/obj16/expression_obj.png" alt="Add Watch Expression"></td>
<td colspan="1" valign="top" align="left" ><a href="../../../reference/views/variables/ref-createwatch.htm"><strong>Create Watch Expression </strong></a></td>
<td colspan="1" valign="top" align="left" >Allows you to create a watch expression for 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" >Edit Logical Structure </td>
<td colspan="1" valign="top" align="left" >Allow you to edit the logical structure 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/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 statement for the selected variable and adds it to the expressions 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/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 Structure As... </td>
<td colspan="1" valign="top" align="left" >Allows you to select a different 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" >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/cjavaviews.htm">Java views</a><br>
<a href="../../../concepts/concepts-5.htm">Java perspectives</a> </p>
<p> <img border="0" src="../../../images/ngrelt.png" alt="Related tasks" > </p>
<p> <a href="../../../tasks/task-suspending_threads.htm">Suspending threads</a><br>
<a href="../../../tasks/task-evaluating_expressions.htm">Evaluating expressions</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><br>
<a href="../../../reference/views/expressions/ref-expressions_view.htm">Expressions View</a><br>
</p>
</body>
</html>