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

From Free Pascal wiki
Jump to navigationJump to search
 
(4 intermediate revisions by the same user not shown)
Line 9: Line 9:
 
[[File:Watch_List.png]]
 
[[File:Watch_List.png]]
  
«Список наблюдения» показывает значения переменных и выражений ("watches"), когда отлаживаемое приложение приостановливается (например, достигнута точка останова).
+
«Список наблюдения» показывает значения переменных и выражений ("watches", отслеживаемые элементы), когда отлаживаемое приложение приостановливается (например, достигнута точка останова).
 
   
 
   
 
Выражениями могут быть локальные или глобальные переменные, ([[GDB_Debugger_Tips/ru#.D0.A1.D0.B2.D0.BE.D0.B9.D1.81.D1.82.D0.B2.D0.B0|определенные]]) свойства или выражения паскаля (ограниченная поддержка, например, «a + 1»). [[GDB_Debugger_Tips/ru#.D0.9F.D1.80.D0.BE.D0.B2.D0.B5.D1.80.D0.BA.D0.B0_.D1.82.D0.B8.D0.BF.D0.BE.D0.B2_.D0.B4.D0.B0.D0.BD.D0.BD.D1.8B.D1.85_.28Watch.2FHint.29| Подробнее см. здесь]]
 
Выражениями могут быть локальные или глобальные переменные, ([[GDB_Debugger_Tips/ru#.D0.A1.D0.B2.D0.BE.D0.B9.D1.81.D1.82.D0.B2.D0.B0|определенные]]) свойства или выражения паскаля (ограниченная поддержка, например, «a + 1»). [[GDB_Debugger_Tips/ru#.D0.9F.D1.80.D0.BE.D0.B2.D0.B5.D1.80.D0.BA.D0.B0_.D1.82.D0.B8.D0.BF.D0.BE.D0.B2_.D0.B4.D0.B0.D0.BD.D0.BD.D1.8B.D1.85_.28Watch.2FHint.29| Подробнее см. здесь]]
  
== Data displayed ==
+
== Отображаемые данные ==
  
The display has 2 columns:
+
Данные отображаются в виде 2 столбцов:  
*Expression: The variable or expression to be watched
+
*Expression(Выражение): отслеживаемые переменная или выражение
*Value: The current value of the expression
+
*Value(Значение): текущее значение выражения
  
Entries can be double-clicked to edit them.
+
Записи можно дважды щелкнуть, чтобы отредактировать их.
  
=== Scope (Stackframe, Thread, History) ===
+
=== Область видимости (Stackframe, Thread, History) ===
  
The values are evaluated according to the scope set in the [[IDE_Window:_Threads|Thread]] and [[IDE_Window:_Call_Stack|Stack]] dialog. Default is the current Thread and top stack frame.
+
Значения оцениваются в соответствии с областью видимости, установленной в диалоговых окнах [[IDE_Window:_Threads|Thread]] и [[IDE_Window:_Call_Stack|Stack]]. По умолчанию используется текущий поток и стек вызовов верхнего уровня. Оба диалога (Stack and Frame) предлагают изменить «текущий» Frame/Thread. Окно просмотра будет следовать за этим выбором.  
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 [[IDE_Window:_Debug_History|History]] dialog.
+
Также можно выбрать ранее отображаемые значения, используя диалоговое окно [[IDE_Window: _Debug_History | History]].
  
=== Special Values ===
+
=== Специальные значения ===
  
;<invalid>: Value currently not available. Can be caused, if the debugger is not active or the debugged app not currently paused.
+
;<invalid> (недействительный): Значение в настоящее время недоступно. Так бывает, если отладчик не активен или отлаживаемое приложение в данный момент не приостановлено.
;<evaluating>: Value is currently retrieved. A result will be show soon
+
;<evaluating> (оценочный): Значение в настоящее время получено. Результат ожидается
;<disabled>: The expression is excluded from evaluation. See Disable/Enable buttons (light bulbs)
+
;<disabled> (отключенный): Выражение исключается из оценки. См. Раздел «Отключение/включение кнопок (лампочек)».
;Error...: The value could not be evaluated. (Error in Expression or Variable not available in selected scope.
+
;Error... (ошибочный): Значение не может быть оценено. (Ошибка в выражении или переменная недоступна в выбранной области)
+
 
== Interface ==
+
== Интерфейс ==
  
<u>Toolbar</u>
+
<u>Панель инструметов</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: Включает/отключает все обновления. Это не влияет на состояние включено/отключено отдельных отслеживаемых элементов. Это заморозит текущее отображение.
;[[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]] Add: Добавляет новое выражение. Откроется диалоговое окно свойств Watch (Также можно дважды щелкнуть пустую строку в списке).
;[[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]] Enable/[[File:debugger_disable.png]] Disable: Включает/отключает отдельные отслеживаемые элементы из оценки. Можно использовать, чтобы не тратить время на оценку, если отслеживаемые элементы недоступны в текущей области видимости.
;[[File:laz delete.png]] Remove: Deletes the selected Watch(es)
+
;[[File:laz delete.png]] Remove: Удаляет выбранные отслеживаемые элементы.
;[[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]] Enable all/[[File:debugger_disable_all.png]] Disable all: Включает/отключает все отслеживаемые элементы из оценки.
;[[File:menu_clean.png]] Delete all: Cleans the list
+
;[[File:menu_clean.png]] Delete all: Очищает список.
;[[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]] Properties: Изменяет выражение или свойства текущих/выбранных отслеживаемых элементов (Это также возможно сделать, дважды щелчкнув по отслеживаемому элементу).
  
<u>Context menu</u>
+
<u>Контекстное меню</u>
 
[[File:Watch_List_popup.png|right]]
 
[[File:Watch_List_popup.png|right]]
  
Additional to the above functionality the context menu allows to:
+
В дополнение к вышеуказанным функциям контекстное меню позволяет:
;Inspect: Opens the current watch in the Debug-Inspector
+
;Inspect (Посмотреть): открывает текущие отслеживаемоые элементы в Debug-Inspector
;Evaluate/Modify: Opens the current watch in the Evaluate/Modify window
+
;Evaluate/Modify (Вычислить/Изменить): открывает текущие отслеживаемые элементы в окне Evaluate/Modify
;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)
+
;Create Data/Watch Breakpoint (Создать точку останова с наблюдением...): открывает диалоговое окно для создания новой точки наблюдения на основе текущего отслеживаемого элемента (останавливается, если текущее значение изменяется или становится доступным)
;Copy Name: Copies the expression to the clipboard
+
;Copy Name (Копировать имя): копирует выражение в буфер обмена
;Copy Value: Copies the value to the clipboard
+
;Copy Value (Копировать значение): копирует значение в буфер обмена
 
<br style="clear:both" />
 
<br style="clear:both" />
  
= Watch Properties =
+
= Свойства наблюдения =
  
 
[[File:Watch_Properties.png]]
 
[[File:Watch_Properties.png]]
  
;Expression: An expression for which the evaluated value should be shown. Expressions can be local or global variables, ([[GDB_Debugger_Tips#Properties|certain]]) properties, or pascal expressions (limited support, e.g. "a+1").  
+
;Expression (Выражение): выражение, для которого должно отображаться вычисленное значение. Выражения могут быть локальными или глобальными переменными, ([[GDB_Debugger_Tips/ru#.D0.A1.D0.B2.D0.BE.D0.B9.D1.81.D1.82.D0.B2.D0.B0|определенными]]) свойствами или выражениями паскаля (ограниченная поддержка, например, «a + ).  
;Repeat Count: 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 Item[0].
+
 
;Digits: Not implemented.
+
;Repeat Count (Число повторов): может использоваться для получения срезов массива. Наблюдение определяет первый элемент массива "A[7]" (должен иметь индекс). При "количестве повторов" равным 20 оно показывает элементы массива от A[7] до A[26]. Его также можно использовать с динамическим массивом (без индекса). Тогда оно указывает, сколько элементов нужно показать, начиная с Item[0].  
;Enabled: See Enable/Disable above.
+
 
;Allow function calls: Not yet supported.
+
;Digits (Разряды): не реализовано.
;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.
+
;Enabled (Включить): См. Enable/Disable выше.
;Style: How to display the data. If a style can not be applied, default will be used.
+
;Allow function calls (Разрешить вызовы функций): пока не поддерживается.
 +
;Use Instance class type (Использовать тип экземпляра класса): объекты обычно отображаются в соответствии с объявлением наблюдаемого выражения. Наблюдение "Sender: TObject" покажет вам только данные, объявленные в TObject. Однако объектные переменные могут содержать объекты унаследованных классов. Sender'ом может быть TForm. Используя это, отладчик найдет фактический класс объекта и отобразит все данные.  
 +
;Style (Стиль): каким образом отображать данные. Если стиль не может быть применен, будет использоваться значение по умолчанию.
  
= See Also =
+
= См.также =
  
 
* Watch-Points (Data-[[IDE_Window:Breakpoints|Breakpoints]])
 
* Watch-Points (Data-[[IDE_Window:Breakpoints|Breakpoints]])

Latest revision as of 16:04, 2 September 2020

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

Важно

Вы должны настроить отладчик и запустить проект для его отладки. Только тогда это окно будет полезно. Чтобы открыть список наблюдения, нажмите Ctrl + Alt + W.

Список наблюдения

Watch List.png

«Список наблюдения» показывает значения переменных и выражений ("watches", отслеживаемые элементы), когда отлаживаемое приложение приостановливается (например, достигнута точка останова).

Выражениями могут быть локальные или глобальные переменные, (определенные) свойства или выражения паскаля (ограниченная поддержка, например, «a + 1»). Подробнее см. здесь

Отображаемые данные

Данные отображаются в виде 2 столбцов:

  • Expression(Выражение): отслеживаемые переменная или выражение
  • Value(Значение): текущее значение выражения

Записи можно дважды щелкнуть, чтобы отредактировать их.

Область видимости (Stackframe, Thread, History)

Значения оцениваются в соответствии с областью видимости, установленной в диалоговых окнах Thread и Stack. По умолчанию используется текущий поток и стек вызовов верхнего уровня. Оба диалога (Stack and Frame) предлагают изменить «текущий» Frame/Thread. Окно просмотра будет следовать за этим выбором.

Также можно выбрать ранее отображаемые значения, используя диалоговое окно History.

Специальные значения

<invalid> (недействительный)
Значение в настоящее время недоступно. Так бывает, если отладчик не активен или отлаживаемое приложение в данный момент не приостановлено.
<evaluating> (оценочный)
Значение в настоящее время получено. Результат ожидается
<disabled> (отключенный)
Выражение исключается из оценки. См. Раздел «Отключение/включение кнопок (лампочек)».
Error... (ошибочный)
Значение не может быть оценено. (Ошибка в выражении или переменная недоступна в выбранной области)

Интерфейс

Панель инструметов

debugger power.png Power
Включает/отключает все обновления. Это не влияет на состояние включено/отключено отдельных отслеживаемых элементов. Это заморозит текущее отображение.
laz add.png Add
Добавляет новое выражение. Откроется диалоговое окно свойств Watch (Также можно дважды щелкнуть пустую строку в списке).
debugger enable.png Enable/debugger disable.png Disable
Включает/отключает отдельные отслеживаемые элементы из оценки. Можно использовать, чтобы не тратить время на оценку, если отслеживаемые элементы недоступны в текущей области видимости.
laz delete.png Remove
Удаляет выбранные отслеживаемые элементы.
debugger enable all.png Enable all/debugger disable all.png Disable all
Включает/отключает все отслеживаемые элементы из оценки.
menu clean.png Delete all
Очищает список.
menu environment options.png Properties
Изменяет выражение или свойства текущих/выбранных отслеживаемых элементов (Это также возможно сделать, дважды щелчкнув по отслеживаемому элементу).

Контекстное меню

Watch List popup.png

В дополнение к вышеуказанным функциям контекстное меню позволяет:

Inspect (Посмотреть)
открывает текущие отслеживаемоые элементы в Debug-Inspector'е
Evaluate/Modify (Вычислить/Изменить)
открывает текущие отслеживаемые элементы в окне Evaluate/Modify
Create Data/Watch Breakpoint (Создать точку останова с наблюдением...)
открывает диалоговое окно для создания новой точки наблюдения на основе текущего отслеживаемого элемента (останавливается, если текущее значение изменяется или становится доступным)
Copy Name (Копировать имя)
копирует выражение в буфер обмена
Copy Value (Копировать значение)
копирует значение в буфер обмена


Свойства наблюдения

Watch Properties.png

Expression (Выражение)
выражение, для которого должно отображаться вычисленное значение. Выражения могут быть локальными или глобальными переменными, (определенными) свойствами или выражениями паскаля (ограниченная поддержка, например, «a + 1»).
Repeat Count (Число повторов)
может использоваться для получения срезов массива. Наблюдение определяет первый элемент массива "A[7]" (должен иметь индекс). При "количестве повторов" равным 20 оно показывает элементы массива от A[7] до A[26]. Его также можно использовать с динамическим массивом (без индекса). Тогда оно указывает, сколько элементов нужно показать, начиная с Item[0].
Digits (Разряды)
не реализовано.
Enabled (Включить)
См. Enable/Disable выше.
Allow function calls (Разрешить вызовы функций)
пока не поддерживается.
Use Instance class type (Использовать тип экземпляра класса)
объекты обычно отображаются в соответствии с объявлением наблюдаемого выражения. Наблюдение "Sender: TObject" покажет вам только данные, объявленные в TObject. Однако объектные переменные могут содержать объекты унаследованных классов. Sender'ом может быть TForm. Используя это, отладчик найдет фактический класс объекта и отобразит все данные.
Style (Стиль)
каким образом отображать данные. Если стиль не может быть применен, будет использоваться значение по умолчанию.

См.также