6.11 Breakpoints
6.11.4 Breakpoint commands on the shortcut menu
In some situations you can right-click to produce the shortcut menu, which contains several breakpoint manipulation commands. These are:
- When you are browsing the project breakpoints in the project window's Breakpoints page.
- When you have selected a method in the project window's Definitions or Sources page.
- When you are browsing a generic function and have selected a method in the browser's Methods page.
- When your mouse pointer is over a breakpoint icon in the leftmost column of either the editor window, the debugger source pane, or the browser Source page.
- When your mouse pointer is over an underscore in the leftmost column of either the editor window, the debugger source pane, or the browser Source page.
- Underscores show lines where you could add a breakpoint.
The commands available on the shortcut menu depend on the context. The complete list of commands follows.
- "Trace"
- Sets a trace point for the selected function. When you set a trace point for a function and then run and pause the application, the nesting levels of recursive calls and their subsequent output are printed to the debugger's interaction pane. This allows you to see the values of the function's arguments and the associated result values.
- "Untrace"
- Removes the trace point for the selected function.
- "Untrace All"
- Removes all trace points for the current project.
- "Run to Cursor"
- Only available in the debugger. Sets a temporary pausing breakpoint at the line the mouse pointer is on, then starts the application or resumes the application if it was paused. The application runs until that line is reached, at which point the application enters the debugger and the breakpoint is cleared.
- Temporary breakpoints are denoted by a solid green circle.
- "Set Breakpoint"
- Sets an enabled pausing breakpoint at the line the mouse pointer is on.
- "Clear Breakpoint"
- Removes any breakpoint at the line the mouse pointer is on.
- Edit Breakpoint Options...
- Pops up a dialog for editing breakpoint options. See "Breakpoint options" on page 124.
- The dialog appears even if a breakpoint did not exist on the function or line.
- Breakpoint Enabled?
- A toggle for enabling and disabling the breakpoint at the line where the mouse pointer is.