Breakpoints Window

Menu

View > Breakpoints

Toolbar

Breakpoints

The Breakpoints window displays a list of all breakpoints or syncpoints that are currently set. You can use the window to set, delete, modify, enable, or disable breakpoints. The window displays the breakpoint with an icon that indicates the breakpoint's type and state and provides information on breakpoint IDs, hit counts, conditions, locations, and threads.

The window displays your breakpoint requests and their actual realizations by the debugger. Your breakpoint request holds all information you specified for the breakpoint. You can set, modify, and delete those requests in the Breakpoints window as you like. Modifying a breakpoint request affects the realized breakpoints. For example, when you disable a breakpoint request, the debugger does not realize any breakpoints for this request.

For the majority of your use cases, only one breakpoint would be realized for a breakpoint request. For those breakpoints, the breakpoint information is displayed in-line with the breakpoint request. This behavior is called folding. In this case, only the ID number of the request is displayed while all other information in this line refers to the actually realized breakpoint. When you modify or delete a folded breakpoint, the changes are applied to the breakpoint request as well.

If the specifications of the breakpoint request are ambiguous, the debugger can create multiple breakpoints. They are shown as child elements of the breakpoint request. The breakpoints are dynamical realizations of a breakpoint request and only set by the debugger. You can modify and delete them, but the debugger can remove breakpoints or realize new ones depending on the breakpoint request settings and the program scope. This means, to change the breakpoints permanently, you would have to modify your breakpoint request. Modifying one of multiple breakpoints does not affect the request or the other related breakpoints. For example, disabling a breakpoint does not disable the other breakpoints or the breakpoint request.

Enable or disable a breakpoint by checking or unchecking its checkbox.

Pop-up Menu

Create Breakpoint	Creates a new breakpoint or syncpoint. You can only request a breakpoint. The debugger interprets the requested settings. If the breakpoint is realizable, it creates one or more breakpoints matching the request. Unrealized breakpoints are displayed with a yellow triangle icon in the Breakpoints window or as <PENDING> in the Console window.
Modify	Opens the Modify Breakpoint dialog box. Use this dialog box to change the settings of the selected breakpoint. Note Modifying one of multiple breakpoints at a location does not modify the other related realized breakpoints or the breakpoint request. If you modify a realized breakpoint, be aware that the debugger can dynamically remove breakpoints or realize new ones and the changes will probably be lost in these cases. This means, to change the breakpoints permanently, you would have to modify your breakpoint request.
Enable Selected	Enables the selected breakpoints.
Disable Selected	Disables the selected breakpoints. Disabled breakpoints still exist, but execution does not stop at them. Disabling one of multiple breakpoints at a location does not disable other related breakpoints or the breakpoint request. Disabling a breakpoint request disables all breakpoints the debugger realized from it and no new breakpoints are realized.
Delete Selected	Deletes the selected breakpoint. Deleting a breakpoint request deletes all breakpoints the debugger realized from it. Note When you delete one of multiple breakpoints at a location, the debugger can dynamically realize new breakpoints at this location when the settings of the breakpoint request are met again.
Jump To Source	Sets the view in the Source window to the position of the selected breakpoint. Note that this item is only available for code breakpoints or thread syncpoints.
Jump To Assembler	Sets the view in the Assembler window to the position of the selected breakpoint. Only available for code breakpoints or thread syncpoints.
Show Memory	Opens a Memory window displaying the memory of the selected breakpoint. Only available for data breakpoints.
Enable All	Enables all breakpoints.
Disable All	Disables all existing breakpoints. The breakpoints still exist, but execution does not stop at them.
Delete All	Deletes all breakpoints.