To open the Breakpoints window, from the Debug menu, choose Windows, and then choose Breakpoints.
The Breakpoints window contains a toolbar and a list of breakpoints currently set in your program. The toolbar contains the following tools:
- New (Breakpoint)
- Opens the New Breakpoint dialog box dialog box, which gives you complete options for creating a new breakpoint.
- Removes whatever breakpoint is currently selected. You cannot undo this operation.
- Clear All Breakpoints
- Removes all breakpoints that are currently set. You cannot undo this operation.
- Disable All Breakpoints
- Disables all breakpoints that are currently set. You can enable the breakpoints (undo the operation) by clicking the button again.
- Go to Source Code
- Opens a source window, if necessary, and shows you the location where the breakpoint is set.
- Go to Disassembly
- Shows the Disassembly window and the location where the breakpoint is set. For more information, see Disassembly Window.
- Selects the informational columns that appear in the breakpoint list.
- Opens the Breakpoint Properties dialog box, which allows you to edit any breakpoint property.
The breakpoint list contains three columns of information by default:
- A descriptive name for the breakpoint, created by the debugger based on the breakpoint's location or other properties. The Name allows you to distinguish between breakpoints and select the one you are interested in.
A check box appears before the name. You can use this check box to enable or disable the breakpoint.
- An optional property that determines whether your program breaks when the breakpoint is reached. The condition can be any valid expression recognized by the debugger. The debugger evaluates the condition and breaks execution only if the condition is satisfied. For more information, see Condition or Expressions in the Debugger.
- Hit Count
- Another optional property that determines whether your program breaks when the breakpoint is reached. If this property is not set, the debugger stops each time the breakpoint is hit, assuming that the expression shown in Condition column is satisfied. The hit count can notify the debugger to break on the nth time the breakpoint is reached, or on every multiple of N hits, or on the Nth hit and every time thereafter. For more information, see Hit Count.
The following columns are not shown by default, but you can add them using the Columns button:
- The language in which the breakpoint has been set.
- The name of the function where the breakpoint is set and the location within the function.
- The name of the file where the breakpoint is set and the line number within the file.
- The memory address where the breakpoint is set.
- For a data breakpoint, the name of the variable the breakpoint is set on and the context in which the breakpoint is set. For more information, see Breakpoints.
- The name of the program in which the breakpoint is set.