The following content has been imported from Legacy Help systems and is in the process of being checked for accuracy.
Parent process: EditEmbedded:Breakpoint
Applied parameters: Action=Properties
Summary
This command is used to run the
Breakpoint Properties dialog, from where you can edit the definition of the currently focused breakpoint.
Details
First, ensure that the breakpoint whose properties you wish to edit is the focused breakpoint. In the source code document, simply click anywhere within the breakpoint line. From the
Breakpoints panel, simply click on the entry for the desired breakpoint. In both cases, the properties dialog is accessed from the right-click menu.
After launching the command, the
Breakpoint Properties dialog will appear. Use this dialog to edit the following properties:
Filename - this is the path and name of the file in which the breakpoint resides. If more than one embedded project source code documents are currently open, the drop-down for this field will list those documents.
Line Number - the current line number within the source code document at which the breakpoint has been placed.
Count -
Reset Count -
Condition - allows you to define a conditional breakpoint, whereby execution of the source code will only halt if the condition associated to the breakpoint returns true, otherwise execution will proceed unchecked.
The dialog also allows you to specify whether the breakpoint is enabled or disabled, through the use of the
Enabled option.
After clicking
OK, the breakpoint's location and definition will be modified, in accordance with the property settings you have defined.
Notes
A breakpoint tells the debugger to pause its execution of program code at a particular line. Include a breakpoint in your code when you wish to halt execution at a particular point. A typical use of breakpoints would be in the different branches of a conditional statement, where a breakpoint is inserted into each branch to check which one is executed.
Enabled breakpoints are indicated in the code by a red highlight over the breakpoint line and a red circle with a cross in the margin.
Enabled breakpoints can also be added directly to the script by clicking in the right-hand margin, next to the line that you wish to apply a breakpoint to. Clicking again will remove the breakpoint.
Disabled breakpoints are indicated in the code by a green highlight over the breakpoint line and a green circle with a cross in the margin. A disabled breakpoint remains defined but will not cause running code to halt when encountered.
To continue execution of a program that has been halted at a breakpoint, click the
Run button on the
Debug toolbar, or use the
F9 shortcut key.
You can view a list of all breakpoints that have currently been defined in all open embedded project source code files, in the
Breakpoints panel.