--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Documentation/Source/eric6.Debugger.DebugViewer.html Sat Jul 05 12:29:15 2014 +0200 @@ -0,0 +1,425 @@ +<!DOCTYPE html> +<html><head> +<title>eric6.Debugger.DebugViewer</title> +<meta charset="UTF-8"> +<style> +body { + background: #EDECE6; + margin: 0em 1em 10em 1em; + color: black; +} + +h1 { color: white; background: #85774A; } +h2 { color: white; background: #85774A; } +h3 { color: white; background: #9D936E; } +h4 { color: white; background: #9D936E; } + +a { color: #BA6D36; } + +</style> +</head> +<body><a NAME="top" ID="top"></a> +<h1>eric6.Debugger.DebugViewer</h1> +<p> +Module implementing a widget containing various debug related views. +</p><p> +The views avaliable are: +<ul> + <li>variables viewer for global variables</li> + <li>variables viewer for local variables</li> + <li>call trace viewer</li> + <li>viewer for breakpoints</li> + <li>viewer for watch expressions</li> + <li>viewer for exceptions</li> + <li>viewer for threads</li> + <li>a file browser (optional)</li> + <li>an interpreter shell (optional)</li> +</ul> +</p> +<h3>Global Attributes</h3> +<table> +<tr><td>None</td></tr> +</table> +<h3>Classes</h3> +<table> +<tr> +<td><a href="#DebugViewer">DebugViewer</a></td> +<td>Class implementing a widget conatining various debug related views.</td> +</tr> +</table> +<h3>Functions</h3> +<table> +<tr><td>None</td></tr> +</table> +<hr /><hr /> +<a NAME="DebugViewer" ID="DebugViewer"></a> +<h2>DebugViewer</h2> +<p> + Class implementing a widget conatining various debug related views. +</p><p> + The individual tabs contain the interpreter shell (optional), + the filesystem browser (optional), the two variables viewers + (global and local), a breakpoint viewer, a watch expression viewer and + the exception logger. Additionally a list of all threads is shown. +</p><h3>Signals</h3> +<dl> +<dt>sourceFile(string, int)</dt> +<dd> +emitted to open a source file at a line +</dd> +</dl> +<h3>Derived from</h3> +QWidget +<h3>Class Attributes</h3> +<table> +<tr><td>None</td></tr> +</table> +<h3>Class Methods</h3> +<table> +<tr><td>None</td></tr> +</table> +<h3>Methods</h3> +<table> +<tr> +<td><a href="#DebugViewer.__init__">DebugViewer</a></td> +<td>Constructor</td> +</tr><tr> +<td><a href="#DebugViewer.__callStackFrameSelected">__callStackFrameSelected</a></td> +<td>Private slot to handle the selection of a call stack entry of the call stack viewer.</td> +</tr><tr> +<td><a href="#DebugViewer.__frameSelected">__frameSelected</a></td> +<td>Private slot to handle the selection of a new stack frame number.</td> +</tr><tr> +<td><a href="#DebugViewer.__setGlobalsFilter">__setGlobalsFilter</a></td> +<td>Private slot to set the global variable filter.</td> +</tr><tr> +<td><a href="#DebugViewer.__setLocalsFilter">__setLocalsFilter</a></td> +<td>Private slot to set the local variable filter.</td> +</tr><tr> +<td><a href="#DebugViewer.__showSource">__showSource</a></td> +<td>Private slot to handle the source button press to show the selected file.</td> +</tr><tr> +<td><a href="#DebugViewer.__threadSelected">__threadSelected</a></td> +<td>Private slot to handle the selection of a thread in the thread list.</td> +</tr><tr> +<td><a href="#DebugViewer.clearCallTrace">clearCallTrace</a></td> +<td>Public method to clear the recorded call trace.</td> +</tr><tr> +<td><a href="#DebugViewer.currentWidget">currentWidget</a></td> +<td>Public method to get a reference to the current widget.</td> +</tr><tr> +<td><a href="#DebugViewer.handleClientStack">handleClientStack</a></td> +<td>Public slot to show the call stack of the program being debugged.</td> +</tr><tr> +<td><a href="#DebugViewer.handleDebuggingStarted">handleDebuggingStarted</a></td> +<td>Public slot to handle the start of a debugging session.</td> +</tr><tr> +<td><a href="#DebugViewer.handleRawInput">handleRawInput</a></td> +<td>Public slot to handle the switch to the shell in raw input mode.</td> +</tr><tr> +<td><a href="#DebugViewer.handleResetUI">handleResetUI</a></td> +<td>Public method to reset the SBVviewer.</td> +</tr><tr> +<td><a href="#DebugViewer.initCallStackViewer">initCallStackViewer</a></td> +<td>Public method to initialize the call stack viewer.</td> +</tr><tr> +<td><a href="#DebugViewer.isCallTraceEnabled">isCallTraceEnabled</a></td> +<td>Public method to get the state of the call trace function.</td> +</tr><tr> +<td><a href="#DebugViewer.preferencesChanged">preferencesChanged</a></td> +<td>Public slot to handle the preferencesChanged signal.</td> +</tr><tr> +<td><a href="#DebugViewer.restoreCurrentPage">restoreCurrentPage</a></td> +<td>Public slot to restore the previously saved page.</td> +</tr><tr> +<td><a href="#DebugViewer.saveCurrentPage">saveCurrentPage</a></td> +<td>Public slot to save the current page.</td> +</tr><tr> +<td><a href="#DebugViewer.setCallTraceToProjectMode">setCallTraceToProjectMode</a></td> +<td>Public slot to set the call trace viewer to project mode.</td> +</tr><tr> +<td><a href="#DebugViewer.setCurrentWidget">setCurrentWidget</a></td> +<td>Public slot to set the current page based on the given widget.</td> +</tr><tr> +<td><a href="#DebugViewer.setDebugger">setDebugger</a></td> +<td>Public method to set a reference to the Debug UI.</td> +</tr><tr> +<td><a href="#DebugViewer.setVariablesFilter">setVariablesFilter</a></td> +<td>Public slot to set the local variables filter.</td> +</tr><tr> +<td><a href="#DebugViewer.showThreadList">showThreadList</a></td> +<td>Public method to show the thread list.</td> +</tr><tr> +<td><a href="#DebugViewer.showVariable">showVariable</a></td> +<td>Public method to show the variables in the respective window.</td> +</tr><tr> +<td><a href="#DebugViewer.showVariables">showVariables</a></td> +<td>Public method to show the variables in the respective window.</td> +</tr><tr> +<td><a href="#DebugViewer.showVariablesTab">showVariablesTab</a></td> +<td>Public method to make a variables tab visible.</td> +</tr> +</table> +<h3>Static Methods</h3> +<table> +<tr><td>None</td></tr> +</table> +<a NAME="DebugViewer.__init__" ID="DebugViewer.__init__"></a> +<h4>DebugViewer (Constructor)</h4> +<b>DebugViewer</b>(<i>debugServer, docked, vm, parent=None, embeddedShell=True, embeddedBrowser=True</i>) +<p> + Constructor +</p><dl> +<dt><i>debugServer</i></dt> +<dd> +reference to the debug server object +</dd><dt><i>docked</i></dt> +<dd> +flag indicating a dock window +</dd><dt><i>vm</i></dt> +<dd> +reference to the viewmanager object +</dd><dt><i>parent</i></dt> +<dd> +parent widget (QWidget) +</dd><dt><i>embeddedShell</i></dt> +<dd> +flag indicating whether the shell should be + included. This flag is set to False by those layouts, that have + the interpreter shell in a separate window. +</dd><dt><i>embeddedBrowser</i></dt> +<dd> +flag indicating whether the file browser should + be included. This flag is set to False by those layouts, that + have the file browser in a separate window or embedded + in the project browser instead. +</dd> +</dl><a NAME="DebugViewer.__callStackFrameSelected" ID="DebugViewer.__callStackFrameSelected"></a> +<h4>DebugViewer.__callStackFrameSelected</h4> +<b>__callStackFrameSelected</b>(<i>frameNo</i>) +<p> + Private slot to handle the selection of a call stack entry of the + call stack viewer. +</p><dl> +<dt><i>frameNo</i></dt> +<dd> +frame number (index) of the selected entry (integer) +</dd> +</dl><a NAME="DebugViewer.__frameSelected" ID="DebugViewer.__frameSelected"></a> +<h4>DebugViewer.__frameSelected</h4> +<b>__frameSelected</b>(<i>frmnr</i>) +<p> + Private slot to handle the selection of a new stack frame number. +</p><dl> +<dt><i>frmnr</i></dt> +<dd> +frame number (0 is the current frame) (int) +</dd> +</dl><a NAME="DebugViewer.__setGlobalsFilter" ID="DebugViewer.__setGlobalsFilter"></a> +<h4>DebugViewer.__setGlobalsFilter</h4> +<b>__setGlobalsFilter</b>(<i></i>) +<p> + Private slot to set the global variable filter. +</p><a NAME="DebugViewer.__setLocalsFilter" ID="DebugViewer.__setLocalsFilter"></a> +<h4>DebugViewer.__setLocalsFilter</h4> +<b>__setLocalsFilter</b>(<i></i>) +<p> + Private slot to set the local variable filter. +</p><a NAME="DebugViewer.__showSource" ID="DebugViewer.__showSource"></a> +<h4>DebugViewer.__showSource</h4> +<b>__showSource</b>(<i></i>) +<p> + Private slot to handle the source button press to show the selected + file. +</p><a NAME="DebugViewer.__threadSelected" ID="DebugViewer.__threadSelected"></a> +<h4>DebugViewer.__threadSelected</h4> +<b>__threadSelected</b>(<i>current, previous</i>) +<p> + Private slot to handle the selection of a thread in the thread list. +</p><dl> +<dt><i>current</i></dt> +<dd> +reference to the new current item (QTreeWidgetItem) +</dd><dt><i>previous</i></dt> +<dd> +reference to the previous current item + (QTreeWidgetItem) +</dd> +</dl><a NAME="DebugViewer.clearCallTrace" ID="DebugViewer.clearCallTrace"></a> +<h4>DebugViewer.clearCallTrace</h4> +<b>clearCallTrace</b>(<i></i>) +<p> + Public method to clear the recorded call trace. +</p><a NAME="DebugViewer.currentWidget" ID="DebugViewer.currentWidget"></a> +<h4>DebugViewer.currentWidget</h4> +<b>currentWidget</b>(<i></i>) +<p> + Public method to get a reference to the current widget. +</p><dl> +<dt>Returns:</dt> +<dd> +reference to the current widget (QWidget) +</dd> +</dl><a NAME="DebugViewer.handleClientStack" ID="DebugViewer.handleClientStack"></a> +<h4>DebugViewer.handleClientStack</h4> +<b>handleClientStack</b>(<i>stack</i>) +<p> + Public slot to show the call stack of the program being debugged. +</p><dl> +<dt><i>stack</i></dt> +<dd> +list of tuples with call stack data (file name, + line number, function name, formatted argument/values list) +</dd> +</dl><a NAME="DebugViewer.handleDebuggingStarted" ID="DebugViewer.handleDebuggingStarted"></a> +<h4>DebugViewer.handleDebuggingStarted</h4> +<b>handleDebuggingStarted</b>(<i></i>) +<p> + Public slot to handle the start of a debugging session. +</p><p> + This slot sets the variables filter expressions. +</p><a NAME="DebugViewer.handleRawInput" ID="DebugViewer.handleRawInput"></a> +<h4>DebugViewer.handleRawInput</h4> +<b>handleRawInput</b>(<i></i>) +<p> + Public slot to handle the switch to the shell in raw input mode. +</p><a NAME="DebugViewer.handleResetUI" ID="DebugViewer.handleResetUI"></a> +<h4>DebugViewer.handleResetUI</h4> +<b>handleResetUI</b>(<i></i>) +<p> + Public method to reset the SBVviewer. +</p><a NAME="DebugViewer.initCallStackViewer" ID="DebugViewer.initCallStackViewer"></a> +<h4>DebugViewer.initCallStackViewer</h4> +<b>initCallStackViewer</b>(<i>projectMode</i>) +<p> + Public method to initialize the call stack viewer. +</p><dl> +<dt><i>projectMode</i></dt> +<dd> +flag indicating to enable the project mode (boolean) +</dd> +</dl><a NAME="DebugViewer.isCallTraceEnabled" ID="DebugViewer.isCallTraceEnabled"></a> +<h4>DebugViewer.isCallTraceEnabled</h4> +<b>isCallTraceEnabled</b>(<i></i>) +<p> + Public method to get the state of the call trace function. +</p><dl> +<dt>Returns:</dt> +<dd> +flag indicating the state of the call trace function (boolean) +</dd> +</dl><a NAME="DebugViewer.preferencesChanged" ID="DebugViewer.preferencesChanged"></a> +<h4>DebugViewer.preferencesChanged</h4> +<b>preferencesChanged</b>(<i></i>) +<p> + Public slot to handle the preferencesChanged signal. +</p><a NAME="DebugViewer.restoreCurrentPage" ID="DebugViewer.restoreCurrentPage"></a> +<h4>DebugViewer.restoreCurrentPage</h4> +<b>restoreCurrentPage</b>(<i></i>) +<p> + Public slot to restore the previously saved page. +</p><a NAME="DebugViewer.saveCurrentPage" ID="DebugViewer.saveCurrentPage"></a> +<h4>DebugViewer.saveCurrentPage</h4> +<b>saveCurrentPage</b>(<i></i>) +<p> + Public slot to save the current page. +</p><a NAME="DebugViewer.setCallTraceToProjectMode" ID="DebugViewer.setCallTraceToProjectMode"></a> +<h4>DebugViewer.setCallTraceToProjectMode</h4> +<b>setCallTraceToProjectMode</b>(<i>enabled</i>) +<p> + Public slot to set the call trace viewer to project mode. +</p><p> + In project mode the call trace info is shown with project relative + path names. +</p><dl> +<dt><i>enabled</i></dt> +<dd> +flag indicating to enable the project mode (boolean) +</dd> +</dl><a NAME="DebugViewer.setCurrentWidget" ID="DebugViewer.setCurrentWidget"></a> +<h4>DebugViewer.setCurrentWidget</h4> +<b>setCurrentWidget</b>(<i>widget</i>) +<p> + Public slot to set the current page based on the given widget. +</p><dl> +<dt><i>widget</i></dt> +<dd> +reference to the widget (QWidget) +</dd> +</dl><a NAME="DebugViewer.setDebugger" ID="DebugViewer.setDebugger"></a> +<h4>DebugViewer.setDebugger</h4> +<b>setDebugger</b>(<i>debugUI</i>) +<p> + Public method to set a reference to the Debug UI. +</p><dl> +<dt><i>debugUI</i></dt> +<dd> +reference to the DebugUI object (DebugUI) +</dd> +</dl><a NAME="DebugViewer.setVariablesFilter" ID="DebugViewer.setVariablesFilter"></a> +<h4>DebugViewer.setVariablesFilter</h4> +<b>setVariablesFilter</b>(<i>globalsFilter, localsFilter</i>) +<p> + Public slot to set the local variables filter. +</p><dl> +<dt><i>globalsFilter</i></dt> +<dd> +filter list for global variable types + (list of int) +</dd><dt><i>localsFilter</i></dt> +<dd> +filter list for local variable types (list of int) +</dd> +</dl><a NAME="DebugViewer.showThreadList" ID="DebugViewer.showThreadList"></a> +<h4>DebugViewer.showThreadList</h4> +<b>showThreadList</b>(<i>currentID, threadList</i>) +<p> + Public method to show the thread list. +</p><dl> +<dt><i>currentID</i></dt> +<dd> +id of the current thread (integer) +</dd><dt><i>threadList</i></dt> +<dd> +list of dictionaries containing the thread data +</dd> +</dl><a NAME="DebugViewer.showVariable" ID="DebugViewer.showVariable"></a> +<h4>DebugViewer.showVariable</h4> +<b>showVariable</b>(<i>vlist, globals</i>) +<p> + Public method to show the variables in the respective window. +</p><dl> +<dt><i>vlist</i></dt> +<dd> +list of variables to display +</dd><dt><i>globals</i></dt> +<dd> +flag indicating global/local state +</dd> +</dl><a NAME="DebugViewer.showVariables" ID="DebugViewer.showVariables"></a> +<h4>DebugViewer.showVariables</h4> +<b>showVariables</b>(<i>vlist, globals</i>) +<p> + Public method to show the variables in the respective window. +</p><dl> +<dt><i>vlist</i></dt> +<dd> +list of variables to display +</dd><dt><i>globals</i></dt> +<dd> +flag indicating global/local state +</dd> +</dl><a NAME="DebugViewer.showVariablesTab" ID="DebugViewer.showVariablesTab"></a> +<h4>DebugViewer.showVariablesTab</h4> +<b>showVariablesTab</b>(<i>globals</i>) +<p> + Public method to make a variables tab visible. +</p><dl> +<dt><i>globals</i></dt> +<dd> +flag indicating global/local state +</dd> +</dl> +<div align="right"><a href="#top">Up</a></div> +<hr /> +</body></html> \ No newline at end of file