Difference between revisions of "IDE Window: Watch list"
Line 5: | Line 5: | ||
= Important = | = Important = | ||
− | + | You must [[Debugger_Setup |setup the debugger]] and start the project to debug it. Only then this window will be useful. | |
− | + | = Watch List = | |
− | + | [[File:Watch_List.png]] | |
− | + | The "Watch List" shows the values of variables and expressions ("watches") when the debugged application is paused. (e.g. reached a breakpoint). | |
+ | |||
+ | Expressions can be local or global variables, ([[GDB_Debugger_Tips#Properties|certain]]) properties, or pascal expressions (limited support, e.g. "a+1"). [[GDB_Debugger_Tips#Inspecting_Data-types_.28Watch.2FHint.29|See here for more information]] | ||
− | = | + | == Data displayed == |
+ | The display has 2 columns: | ||
+ | *Expression: The variable or expression to be watched | ||
+ | *Value: The current value of the expression | ||
+ | Entries can be double-clicked to edit them. | ||
− | = Value = | + | === Scope (Stackframe, Thread, History) === |
+ | |||
+ | The values are evaluated according to the scope set in the Thread and Stack dialog. Default is the current Thread and top stack frame. | ||
+ | Both (Stack and Frame) dialog offer to change the "current" Frame/Thread. The watch window will follow this selection. | ||
+ | |||
+ | It is also possible to select previously displayed values, using the History dialog. | ||
+ | |||
+ | === Special Values === | ||
+ | |||
+ | ;<invalid>: Value currently not available. Can be caused, if the debugger is not active or the debugged app not currently paused. | ||
+ | ;<evaluating>: Value is currently retrieved. A result will be show soon | ||
+ | ;<disabled>: The expression is excluded from evaluation. See Disable/Enable buttons (light bulbs) | ||
+ | ;Error...: The value could not be evaluated. (Error in Expression or Variable not available in selected scope. | ||
+ | |||
+ | == Interface == | ||
+ | |||
+ | ;[[File:debugger power.png]] Power: Enables/Disables all updates. This does not affect the enabled/disabled state of individual watches. This will freeze the current display. | ||
+ | ;[[File:laz add.png]] Add: Add a new expression. This will open the Watch property dialog. (It is also possible to double click an empty line in the list) | ||
+ | ;[[File:debugger enable.png]] Enable/[[File:debugger_disable.png]] Disable: Enables/Disables individual watches from evaluation. This can be used to prevent spending time on evaluation, if a watch is not available in the current scope. | ||
+ | ;[[File:laz delete.png]] Remove: Deletes the selected Watch(es) | ||
+ | ;[[File:debugger_enable_all.png]] Enable all/[[File:debugger_disable_all.png]] Disable all: Enables/Disables all individual watches from evaluation. | ||
+ | ;[[File:menu_clean.png]] Delete all: Cleans the list | ||
+ | ;[[File:menu_environment_options.png]] Properties: Change the expression or properties of the current/selected watch. (Also possible by double clicking the watch) | ||
+ | |||
+ | = Watch Properties = | ||
+ | |||
+ | [[File:Watch_Properties.png]] | ||
+ | |||
+ | |||
+ | |||
+ | = See Also = | ||
+ | |||
+ | TODO: | ||
+ | * Watch-Points (Data-Breakpoints) | ||
+ | * Evaluate Window | ||
+ | * Debug Inspector | ||
+ | * Debug History |
Revision as of 10:59, 28 May 2012
│
Deutsch (de) │
English (en) │
русский (ru) │
Important
You must setup the debugger and start the project to debug it. Only then this window will be useful.
Watch List
The "Watch List" shows the values of variables and expressions ("watches") when the debugged application is paused. (e.g. reached a breakpoint).
Expressions can be local or global variables, (certain) properties, or pascal expressions (limited support, e.g. "a+1"). See here for more information
Data displayed
The display has 2 columns:
- Expression: The variable or expression to be watched
- Value: The current value of the expression
Entries can be double-clicked to edit them.
Scope (Stackframe, Thread, History)
The values are evaluated according to the scope set in the Thread and Stack dialog. Default is the current Thread and top stack frame. Both (Stack and Frame) dialog offer to change the "current" Frame/Thread. The watch window will follow this selection.
It is also possible to select previously displayed values, using the History dialog.
Special Values
- <invalid>
- Value currently not available. Can be caused, if the debugger is not active or the debugged app not currently paused.
- <evaluating>
- Value is currently retrieved. A result will be show soon
- <disabled>
- The expression is excluded from evaluation. See Disable/Enable buttons (light bulbs)
- Error...
- The value could not be evaluated. (Error in Expression or Variable not available in selected scope.
Interface
- Power
- Enables/Disables all updates. This does not affect the enabled/disabled state of individual watches. This will freeze the current display.
- Add
- Add a new expression. This will open the Watch property dialog. (It is also possible to double click an empty line in the list)
- Enable/ Disable
- Enables/Disables individual watches from evaluation. This can be used to prevent spending time on evaluation, if a watch is not available in the current scope.
- Remove
- Deletes the selected Watch(es)
- Enable all/ Disable all
- Enables/Disables all individual watches from evaluation.
- Delete all
- Cleans the list
- Properties
- Change the expression or properties of the current/selected watch. (Also possible by double clicking the watch)
Watch Properties
See Also
TODO:
- Watch-Points (Data-Breakpoints)
- Evaluate Window
- Debug Inspector
- Debug History