Difference between revisions of "IDE Window: Watch list/de"

From Lazarus wiki
Jump to navigationJump to search
Line 2: Line 2:
 
== Wichtig ==  
 
== Wichtig ==  
  
You must [[Debugger_Setup |setup the debugger]] and start the project to debug it. Only then this window will be useful.
+
Sie müssen den [[Debugger_Setup|Debugger einrichten]] und das zu untersuchende Projekt starten. Nur dann wird dieses Fenster hilfreich sein.
  
 
== Liste der überwachten Ausdrücke ==
 
== Liste der überwachten Ausdrücke ==
Line 12: Line 12:
 
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]]
 
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 ===
+
=== Angezeigte Daten ===
  
The display has 2 columns:
+
Die Anzeige besteht aus zwei Spalten:
*Expression: The variable or expression to be watched
+
*Ausdruck: der zu überwachende Ausdruck oder Variable
*Value: The current value of the expression
+
*Wert: der aktuelle Wert des Ausdrucks
  
Entries can be double-clicked to edit them.
+
Mit einem Doppelklick auf einen Eintrag kann dieser bearbeitet werden.
  
 
==== Scope (Stackframe, Thread, History) ====
 
==== Scope (Stackframe, Thread, History) ====
Line 27: Line 27:
 
It is also possible to select previously displayed values, using the [[IDE_Window:_Debug_History|History]] dialog.
 
It is also possible to select previously displayed values, using the [[IDE_Window:_Debug_History|History]] dialog.
  
==== Special Values ====
+
==== Spezielle Werte ====
  
;<invalid>: Value currently not available. Can be caused, if the debugger is not active or the debugged app not currently paused.
+
;<invalid>: Der Wert ist aktuell nicht verfügbar. 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
 
;<evaluating>: Value is currently retrieved. A result will be show soon
 
;<disabled>: The expression is excluded from evaluation. See Disable/Enable buttons (light bulbs)
 
;<disabled>: The expression is excluded from evaluation. See Disable/Enable buttons (light bulbs)
Line 38: Line 38:
 
<u>Toolbar</u>
 
<u>Toolbar</u>
 
;[[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: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:laz add.png]] Hinzufügen: 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:debugger enable.png]] Aktivieren/[[File:debugger_disable.png]] Deaktivieren: 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:laz delete.png]] Löschen: Deletes the selected Watch(es)
;[[File:debugger_enable_all.png]] Enable all/[[File:debugger_disable_all.png]] Disable all: Enables/Disables all watches from evaluation.
+
;[[File:debugger_enable_all.png]] Alle aktivieren/[[File:debugger_disable_all.png]] Alle deaktivieren: Enables/Disables all watches from evaluation.
;[[File:menu_clean.png]] Delete all: Cleans the list
+
;[[File:menu_clean.png]] Alle löschen: 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)
+
;[[File:menu_environment_options.png]] Eigenschaften: Change the expression or properties of the current/selected watch. (Also possible by double clicking the watch)
  
<u>Context menu</u>
+
<u>Kontextmenü</u>
 
[[File:Watch_List_popup.png|right]]
 
[[File:Watch_List_popup.png|right]]
  
Additional to the above functionality the context menu allows to:
+
Zusätzlich zu den obigen Funktionen erlaubt das Kontextmenü:
;Inspect: Opens the current watch in the Debug-Inspector
+
;Überprüfung: Opens the current watch in the Debug-Inspector
;Evaluate/Modify: Opens the current watch in the Evaluate/Modify window
+
;Auswerten/Ändern: Opens the current watch in the Evaluate/Modify window
;Create Data/Watch Breakpoint: Opens the dialog to create a new watchpoint based on the current watch (stop if wachted value is changed or accessed)
+
;Datenhaltepunkt erzeugen: Opens the dialog to create a new watchpoint based on the current watch (stop if wachted value is changed or accessed)
;Copy Name: Copies the expression to the clipboard
+
;Namen kopieren: kopiert den Ausdruck in die Zwischenablage
;Copy Value: Copies the value to the clipboard
+
;Wert kopieren: kopiert den Wert in die Zwischenablage
 
<br style="clear:both" />
 
<br style="clear:both" />
  

Revision as of 14:17, 24 December 2012

Deutsch (de) English (en) русский (ru)

Wichtig

Sie müssen den Debugger einrichten und das zu untersuchende Projekt starten. Nur dann wird dieses Fenster hilfreich sein.

Liste der überwachten Ausdrücke

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, (certain) properties, or pascal expressions (limited support, e.g. "a+1"). See here for more information

Angezeigte Daten

Die Anzeige besteht aus zwei Spalten:

  • Ausdruck: der zu überwachende Ausdruck oder Variable
  • Wert: der aktuelle Wert des Ausdrucks

Mit einem Doppelklick auf einen Eintrag kann dieser bearbeitet werden.

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.

Spezielle Werte

<invalid>
Der Wert ist aktuell nicht verfügbar. 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

Toolbar

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.
laz add.png Hinzufügen
Add a new expression. This will open the Watch property dialog. (It is also possible to double click an empty line in the list)
debugger enable.png Aktivieren/debugger disable.png Deaktivieren
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.
laz delete.png Löschen
Deletes the selected Watch(es)
debugger enable all.png Alle aktivieren/debugger disable all.png Alle deaktivieren
Enables/Disables all watches from evaluation.
menu clean.png Alle löschen
Cleans the list
menu environment options.png Eigenschaften
Change the expression or properties of the current/selected watch. (Also possible by double clicking the watch)

Kontextmenü

Watch List popup.png

Zusätzlich zu den obigen Funktionen erlaubt das Kontextmenü:

Überprüfung
Opens the current watch in the Debug-Inspector
Auswerten/Ändern
Opens the current watch in the Evaluate/Modify window
Datenhaltepunkt erzeugen
Opens the dialog to create a new watchpoint based on the current watch (stop if wachted value is changed or accessed)
Namen kopieren
kopiert den Ausdruck in die Zwischenablage
Wert kopieren
kopiert den Wert in die Zwischenablage


Watch Properties

Watch Properties.png

Expression
An Expression for which the evaluated value should be shown. Expressions can be local or global variables, (certain) properties, or pascal expressions (limited support, e.g. "a+1").
Repeat Count
Unimplemented
Digits
Unimplemented
Enabled
See Enable/Disable above
Allow function calls
Not yet supported
Use Instance class type
Objects are normally shown according to the declaration of the watched expression. Watching "Sender: TObject" will only show you data that is declared on TObject. However object variables can contain objects of inherited classes. Sender may be a TForm. Using this the debugger will find the actual class of the object and display all data.
Style
How to display the data. If a style can not be applied, default will be used.


"Repeat Count"

is implemented in Lazarus 1.1 (SVN, trunk). It can be used to get array slices. The watch specifies the first element of the array "A[7]" (must have an index). With a "Repeat count" of 20, this shows A[7] to A[26].
It can also be used with a dynamic array (no index given). Then it specifies haw many elements to show, beginning with DynA[0]

Siehe auch