Use breakpoints

A breakpoint causes the execution of all threads to suspend at the location where the breakpoint is set. A list of all breakpoints (for all debug sessions) appears in the Breakpoints view, unless you use the filter by debug target action or link the Breakpoints view to the Debug view. To filter out breakpoints that are not related to the current debug session, click the Breakpoints view Show Breakpoints Supported by Selected Target push button. To link the Breakpoints view with the Debug view, click the Link with Debug view toggle - when this is selected, only those breakpoints that are associated with the selected debug target in the Debug view will appear in the Breakpoints view.

Note: Filtering by debug target does not filter out breakpoints for debug targets that are similar to that of the current debug session.

The breakpoint entries in the list indicate which file the breakpoint has been set in and provide you, in brackets, with a summary of the breakpoints' properties. Pop-up menu options let you remove breakpoints, enable or disable breakpoints, and go to the location of the breakpoint in the editor source file. Push buttons in the Breakpoints view also allow you to remove breakpoints.

Breakpoints can be enabled and disabled via pop-up menus in the Breakpoints view or the editor and via check box in the Breakpoints view. When a breakpoint is enabled, it will cause all threads to suspend whenever it is hit. When a breakpoint is disabled, it will not cause threads to suspend. For further information about enabling and disabling breakpoints, see the related topic below.

In the Breakpoints view, there are two indicators to the left of a set breakpoint. To the far left is a check box which indicates if the breakpoint is enabled (when enabled, the check box contains a check mark). To the near left, a filled indicator indicates the set breakpoint (when the breakpoint is disabled, this indicator is not filled).

While in the Breakpoints view, the source editor will open to the location of a breakpoint if you do one of the following:

• Double-click the breakpoint.

• Select the breakpoint and click the Go to File For Breakpoint push button.

• Right-click on the breakpoint and select Go to File from the pop-up menu.

 

Related concepts

Breakpoints

 

Related tasks

Setting a line breakpoint
Enabling and disabling breakpoints
Removing breakpoints