Breakpoint Properties
Go Up to Debug Windows Index
Breakpoint List | Select a breakpoint and click
Breakpoint List | Right-click a breakpoint and select Breakpoint Properties
Breakpoint Properties is not a single dialog box. Depending on the type of the selected breakpoint, you can open one of the following dialog boxes:
- Address Breakpoint Properties if you select an address breakpoint.
- Data Breakpoint Properties if you select a data breakpoint.
- Source Breakpoint Properties if you select a source breakpoint.
The commands to open the Address Breakpoint Properties and Data Breakpoint Properties dialog boxes are enabled only when you are running your application in debug mode.
The Breakpoint Properties dialog box lets you modify an existing breakpoint or create a new breakpoint from the data of an existing breakpoint using the following fields:
Item | Description | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Filename |
Specifies the source file for the source breakpoint. Enter the name of the source file for the breakpoint. | ||||||||||||||||||||
Line number |
Sets or changes the line number for the breakpoint. Enter or change the line number for the breakpoint. | ||||||||||||||||||||
Pass count |
Stops program execution at a certain line number after a specified number of passes. Enter the number of passes. The debugger increments the pass count each time the line containing the breakpoint is encountered. When the pass count equals the specified number, the debugger pauses program execution. For example, if the pass count is set to 3, you will see 0 of 3, 1 of 3, 2 of 3, then 3 of 3 in the pass count. Program execution stops at 3 of 3. Because the debugger increments the count with each pass, you can use them to determine which iteration of a loop fails. Set the pass count to the maximum loop count and run your program. When the program fails, you can calculate the number of loop iterations by examining the number of passes that occurred. When you use pass counts with conditions, program execution pauses the nth time that the conditional expression is true. The debugger decrements the pass count only when the conditional expression is true. | ||||||||||||||||||||
Address |
Specifies the address for the address breakpoint. When the address is executed, the program execution halts if the condition (optional) evaluates to true and the pass count (optional) has been completed. If the address can be correlated to a source line number, the address breakpoint is created as a source breakpoint. | ||||||||||||||||||||
Length |
Specifies the length of the data breakpoint, beginning at "Address". The length is automatically calculated for standard data types. | ||||||||||||||||||||
Condition |
Specifies a conditional expression that is evaluated each time the breakpoint is encountered. Program execution stops when the expression evaluates to true. Enter a conditional expression to stop program execution. Enter any valid language expression. All symbols in the expression must be accessible from the breakpoint's location. Functions are valid if they return a Boolean type. For data breakpoints, if no condition is set, the breakpoint is hit when any change is made to the data in the range specified in the Length field. | ||||||||||||||||||||
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) or thread names (for named threads). | ||||||||||||||||||||
Pass count |
Stops program execution at a certain line number after a specified number of passes. Enter the number of passes. The debugger increments the pass count each time the line containing the breakpoint is encountered. When the pass count equals the specified number, the debugger pauses program execution. For example, if the pass count is set to 3, you will see 0 of 3, 1 of 3, 2 of 3, then 3 of 3 in the pass count. Program execution stops at 3 of 3. Because the debugger increments the count with each pass, you can use the count to determine the iteration of a loop that fails. Set the pass count to the maximum loop count and run your program. When the program fails, you can calculate the number of loop iterations by examining the number of passes that occurred. When you use pass counts with conditions, program execution pauses the nth time that the conditional expression is true. The debugger decrements the pass count only when the conditional expression is true. | ||||||||||||||||||||
Group |
Creates a breakpoint group, and makes this breakpoint a member of the group. Using breakpoint groups is useful for performing a similar set of actions on all breakpoints within a group. To create a group, enter a name in this field. To use an existing group, select a group from the drop-down list. | ||||||||||||||||||||
Keep existing Breakpoint |
If you check this option, your changes to your breakpoints do not affect the existing breakpoint. Instead, a new breakpoint is created with the properties of the existing breakpoint and any property you modify in the Breakpoint Properties dialog box only affects your new breakpoint. | ||||||||||||||||||||
Advanced |
Expands the dialog box to include fields for associating actions with breakpoints.
|