Breakpoint List Window

From Appmethod Topics
Jump to: navigation, search

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

CheckBox icon

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

AddBreakpoint.png

Add breakpoint. Allows you to create a Source breakpoint, Data breakpoint, or Address breakpoint.

DeleteSelectedBreakpoint.png

Delete selected breakpoint.

DeleteAllBreakpoints.png

Delete all breakpoints.

EnableAllBreakpoints.png

Enable all breakpoints.

DisableAllBreakpoints.png

Disable all breakpoints.

BreakpointPropertiesSelectedBreakpoint.png

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

Valid breakpoint

The breakpoint is valid and enabled.

Valid, disabled breakpoint

The breakpoint is valid and disabled.

Invalid breakpoint

The breakpoint is set at an invalid location, such as a comment, a blank line, or invalid declaration.

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

Opens dialog boxes where you can create new breakpoints.

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.

Dockable

Toggles whether the Breakpoint List window is dockable.

Stay On Top

Keeps the window visible when out of focus.



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.

Stay On Top

Keeps the window visible when out of focus.

Dockable

Enables drag-and-dock for the Breakpoint List window.

See Also