Breakpoint List Window

Go Up to Debug Windows Index

View > Debug Windows > Breakpoints

Displays, enables, or disables breakpoints currently set in the loaded project. Also changes the condition, passes count, or groups associated with a breakpoint. If no project is loaded, it shows all breakpoints set in the active Code Editor or in the CPU window.

Tip: Several items on the Breakpoint List context menu are also available on the Breakpoint List toolbar.

Fields on the Window

Note: The in-place editors on the Breakpoint List window are now clickable dropdown lists. In addition to typing new values in the in-place editors (such as Line/Length), you can now also select from values that were entered in this field previously or on other Debug windows.

Column	Description
	Indicates whether the breakpoint is enabled or disabled. Check the box to enable the breakpoint. Uncheck it to disable the breakpoint.
Filename/Address	The source file for the source breakpoint or the address for the address breakpoint.
Line/Length	The code line number for the breakpoint or the length (the number of bytes to watch) for the data breakpoint.
Condition	The conditional expression that is evaluated each time the breakpoint is encountered. Click a condition value to edit it.
Thread	Specifies the thread to which the breakpoint is to be applied. When a multithreaded application is running in debug mode, you can select from the current thread numbers (for numbered threads) and thread names (for named threads).
Action	The action associated with breakpoints.
Pass Count	The current pass and the total number of passes specified for the breakpoint. Click a pass count value to edit it.
Group	The group name with which the breakpoint is associated. Click a group value to edit it.

Toolbar and Display Icons

The following icons are used to represent commands on the Breakpoint List toolbar.

Icon	Description
Add Breakpoint	Allows you to create a Source breakpoint, Data breakpoint, or Address breakpoint. Item Description Source Breakpoint... Opens the Add Source Breakpoint dialog box. Data Breakpoint... Opens the Add Data Breakpoint dialog box. This option is enabled only at run time. Address Breakpoint... Opens the Add Address Breakpoint dialog box. This option is enabled only at run time.
Delete	Deletes the selected breakpoint.
Delete All	Deletes all breakpoints.
Enable All	Enables all breakpoints.
Disable All	Disables all breakpoints.
Breakpoint Properties	Opens the Breakpoint Properties dialog box to modify the selected breakpoint.

The following icons are used to represent breakpoints in the Breakpoint List window.

Icon	Description
	The breakpoint is valid and enabled.
	The breakpoint is valid and disabled.
	The breakpoint is set at an invalid location, such as a comment, a blank line, or invalid declaration. It only appears at run time.

Context Menu if No Breakpoint is Selected

Right-click the Breakpoint List window (not on an actual breakpoint) to display the following commands:

Item	Description
Add	Allows you to create a Source breakpoint, Data breakpoint, or Address breakpoint. See Add Breakpoint above.
Delete All...	Removes all breakpoints. This command is not reversible.
Disable All	Disables all enabled breakpoints. When you disable a breakpoint, its settings remain defined, but the breakpoint does not cause your program to stop. Disabling is useful when you temporarily do not need a breakpoint but want to preserve its settings.
Enable All	Enables all disabled breakpoints.
Disable Group	Disables the breakpoint group that you select.
Enable Group	Enables the breakpoint group you select.
Stay On Top	Keeps the window visible when out of focus.
Dockable	Toggles whether the Breakpoint List window is dockable.
Toolbar	Displays or hides the toolbar.

Context Menu if a Breakpoint is Selected

Right-click a breakpoint to display the following commands:

Item	Description
Enabled	Toggles between enabling and disabling a breakpoint.
Delete	Removes a breakpoint.
View Source	For source breakpoints, locates a breakpoint in your source code. For address breakpoints, displays the location in the CPU window.
Edit Source	For source breakpoints, locates a breakpoint in your source code and activates the Code Editor. For address breakpoints, displays the location in the CPU window.
Breakpoint Properties	Opens the Breakpoint Properties dialog box to modify the selected breakpoint.
Breakpoints	Displays a menu of breakpoint commands. Item Description Add Allows you to create a Source breakpoint, Data breakpoint, or Address breakpoint. See Add Breakpoint above. Delete All... Removes all breakpoints. This command is not reversible. Disable All Disables all enabled breakpoints. When you disable a breakpoint, its settings remain defined, but the breakpoint does not cause your program to stop. Disabling is useful when you temporarily do not need a breakpoint but want to preserve its settings. Enable All Enables all disabled breakpoints. Disable Group Disables a selected group. It only appears enabled if there is at least one group created. Enable Group Enables a selected group. It only appears enabled if there is at least one group created.
Stay On Top	Keeps the window visible when out of focus.
Dockable	Enables drag-and-dock for the Breakpoint List window.
Toolbar	Displays or hides the toolbar.

See Also

• Setting and Modifying Breakpoints
• Breakpoint Properties